DocBook vs Apache Forrest

翻译 2007年10月05日 15:49:00

最近工作需要在研究开源的文档产品,举个例子吧,Spring和Hibernate的官方帮助手册就是借助这类产品生成的。

在这个方面,DocBook和Apache Forrest这两种基于XML的文档框架工具无疑是占有统治地位的。基本来说,这两种框架都可以让你自由的定义文档的布局、格式、章节,从而完成你的“著作”。它们需要你完全使用基于一种特定schema/dtd的XML书写文档,然后根据应用的样式表去生成诸如XHTML、PDF、RTF之类的最终文档产品。

对于一个基于Java 1.5平台的企业应用项目来说,我更倾向于使用DocBook,因为它看起来要更加成熟而且有更多的辅助工具,但是,相比较而言,Forrest似乎拥有更短的学习曲线。

我认为Forrest的XML方言能覆盖80%的应用场景,同时相对的容易上手。但是,如果是一个大型软件项目的话,很难想象不需要产生可打印格式的文档,这一点是DocBook的优势。

正如我上面所提及的,在使用DocBook撰写文档时,会有很多工具供你选择,尽管我没有发现多少特别杰出的(工具:-):

  • Conglomerate - 这个工具看上去挺有发展前途的,但是,它只能运行在unix系统上。
  • DocBook Template for OpenOffice - 使用这个工具生成“章节”时似乎有点毛病,不支持所有的DocBook特性。
  • Vex - Vex是一个Eclipse的插件,看上去有发展前途,但是我认为它有些难用。
  • Big list of docbook tools - 这是个什么东东,我不知道。

也许手写XML文档也不失为一个好的方法,但是如果能有一个称心应手的可视化工具辅助那就更爽啦,不是么?

最后,我要说的DocBook的另一个优势就是它有一些已经完成的书籍著作:

相关文章推荐

apache-forrest-0.8.zip

  • 2012年10月09日 15:32
  • 23.01MB
  • 下载

Forrest Liu

====================================================== 注:本文源代码点此下载 =============================...

DocBook在Linux上的使用

DocBook在Linux上的使用 lli_njupt 目录 1. 什么是DocBook2. DocBook的安装和使用 2.1. 安装DocBook2.2...

Forrest 2015年第三季度内存数据库分析报告

Forrester于2015年Q3发布了最新的内存数据库平台分析报告,SAP网站有PDF版本可以下载。概述内存数据库的需求源于对实时(real time)的需求,无论是实时分析还是实时交易处理。传统的...

Forrest 2015年第三季度内存网格分析报告

Forrester于2015年Q3发布了最新的内存数据网格分析报告,PDF版本可以下载。关于内存数据库(IMDB)的评测可参见 Forrest 2015年第三季度内存数据库分析报告现代化应用的需求陷入...

Brady Forrest:从原型设计到客户门前

  • 2014年05月29日 14:08
  • 12.35MB
  • 下载

apache2.4 windows编译工程 vs2005

  • 2017年10月10日 00:01
  • 57.7MB
  • 下载

DocBook 助你完成传世之作

DocBook 助你完成传世之作文档的技术革命蒋鑫摘要 DocBook 是当前风行于开放源码世界的一种文档撰写格式,已经成为计算机文档撰写的事实上的规范。 DocBook 是基于SGML/XML...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:DocBook vs Apache Forrest
举报原因:
原因补充:

(最多只允许输入30个字)