共享我的DocBook 构建工具

已经上传到Google Code，成为一尝试性的项目，项目名为dbktools。
地址http://code.google.com/p/hantsy-labs/ 。
注意，目前没有发布一个稳定的版本。
要使用的话，请从subvesion repository中checkout项目。

dbktools当前致力提供以下特性。
1.自动配置中文字体路径，包括Apache FOP和RenderX XEP配置。
2.HTML，PDF格式输出，PDF格式默认使用FOP，同时提供XEP支持。
3.提供简单的Book和Article项目模板，快速创建DocBook项目。

以后可能添加的特性。
1.增加配置的交互性。
2.减小项目的体积，提供选项支持秕已经的资源，如系统的 docbook xml/xsl 位置。
3.添加XmlMind的转换工具的个人版本支持，支持输出微软的 Open XML Office 和标准的 Open Document(ODF)。
4.支持 DocBook 5，目前我还不熟悉 DocBook 5 新的定义格式。

关于DocBook使用的讨论请加入DocBook圈子。
附件是用户手册，其docbook源文件作为项目的样例包含在项目的subversion库中。

 

 

恩,,很不错,你有没有考虑过整成Maven的一个plugin呢?  我以前用jdocbook的时候也在想弄个能生成中文pdf的，但由于时间问题,一直没弄。
有没有考虑过整合进 jdocbook呢? http://www.jboss.org/maven-jdocbook-plugin/

目前jdocbook只能生成英文的pdf,生成中文的pdf有问题..

Thanks
Jeff

docbook的构建工具应该不少，但大多数都配置性不强，几乎都没有考虑到亚洲语系的字体相关的配置。
JBoss 的jdocbook maven2 plugin我也用过。感觉jdocbook应该暴露更多的低层依赖的配置，或许我们需要的是一个强大的fop plugin来专门针对PDF。
maven中标准的docbook plugin太简单。http://mojo.codehaus.org/docbook-maven-plugin/project-info.html
另外还一个maven plugin功能上和JBoss的jdocbook差不多。http://www.agilejava.com/docbkx/docbkx-samples/html/manual.html

基于ant 的工具也存在。
如 http://www.cs.put.poznan.pl/dweiss/xml/projects/ant-docbook-styler/index.xml#id52430，其实我的工具大量的利用这个项目的成果(自定义样式文件)。
Apache Veloity项目提供了一个DocBook Framework，http://velocity.apache.org/docbook/。

目前感觉还是基于ant 的方式的比较方便。

open office...

你觉得jdocbook需要暴露什么样的底层配置才能符合你的要求?现在有很多项目都在用jdocbook (至少jboss的项目),我想如果我们扩大增加jdocbook的中文支持,更好些.
当然了,不知道你会不会感兴趣. ;-)

因为我看了下,这个生成的效果还很不错,现在有好多些项目是用maven来做build,所以，我希望有个maven的支持中文生成pdf的docbook..这样,我们就不用重复研发了...;-),  至少据我说知, www.kava.org.cn 也想有这个小工具.

;-)

Thanks
Jeff

平时都是自己拿 ant去构建docbook的……
fop现在通过自己捣鼓了下也能生成了中文pdf
关键单位没人爱用这个写文档……唉 都被word惯坏了

重新看了一下jdocbook，它所依赖的样式文件中缺少中文配置（由jbossorg-docbook-xlst提供，当然可以不用）中，如果使用自定义样式xls，添加中文字体配置，并定义字体路径等属性，而fop最新版本支持truetype字体自动扫描（不需要0.20.5那样要生成metrics文件），如果这个在jdocbook是支持的，应该问题不大。有空我再试一下。
但FOP的中文输出效果不XEP，这也是我一直首选使用xep生成pdf的原因。

最新的fop 0.95 还不支持字体簇。。。而snapshot版本是支持的，效果不理想。
参见http://blog.chinaunix.net/u/1096/showart_1808039.html

jdocbook只要添加几行代码就可以解决中文pdf输出问题。。。
参见我的博客：Hack JBoss JDocBook Plugin

附上生成了JBoss Cache Core User Guide（项目参见http://www.kava.org.cn） 的pdf文件和我的fop.xconf配置文件（使用时根据自己的环境，需要自行修改字体路径）。