DocBook vs Apache Forrest

最近工作需要在研究開源的文檔産品，舉個例子吧，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的另一個優勢就是它有一些已經完成的書籍著作：

     本文轉自胡奇 51CTO部落格，原文連結：http://blog.51cto.com/huqicto/280686，如需轉載請自行聯系原作者