DocBook vs Apache Forrest

标签: apache文档工具hibernatexmlxhtml
2112人阅读 评论(0) 收藏 举报
分类:

最近工作需要在研究开源的文档产品,举个例子吧,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的另一个优势就是它有一些已经完成的书籍著作:

0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:448248次
    • 积分:5005
    • 等级:
    • 排名:第5639名
    • 原创:84篇
    • 转载:12篇
    • 译文:3篇
    • 评论:305条
    最新评论