使用DocBook

 

参考：

http://addcn.blogbus.com/logs/94311060.html
http://www.haogongju.net/art/992927
http://www.haogongju.net/art/1000907
http://dev.sei.pku.edu.cn/trac/pkuas/wiki/%E5%A6%82%E4%BD%95%E7%94%A8docbook%E7%94%9F%E6%88%90%E4%B8%AD%E6%96%87%E7%9A%84pdf
http://hi.baidu.com/longhtml/blog/item/ea2461459a77da2ecefca3ac.html

http://www.worldhello.net/doc/docbook_howto/index.html

http://code.google.com/p/i18n-zh/wiki/DocBook

 

DocBook 的编辑

1、使用notepad(windows)或vim(linux等)文本编辑工具进行创作。

这种方法需要敲入大量的标记，并且不能以WYSIWYG的方式进行编辑。

2、采用XML或DocBook 编辑工具，DocBook 的编辑工具有如下几种：

1）XMLmind XML Editor（或XXE），该软件以两种版本进行发布，即企业版和个人版，个人版免费但文档格式转换功能受限。

2）Kate，Quanta Plus和OpenOffice，这些软件基于Linux平台。

3）CDBE，是为了方便中文用户在Windows环境下进行DOCBOOK XML文档创作而制作的，貌似使用的人寥寥。

4）Oxygen XML Editor，epcEdit，Altova XMLSpy 等。

针对XXE不能转换为其他格式的限制，可以补充使用下面的工具。

针对HTML和PDF的集成转换工具有DocBook XSL Stylesheets-1.71.1、xsltproc（在linux平台下使用）。

或者自己开发格式化为HTML或FO的样式表，利用XSLT processor进行转换，可供选择的processor有XT（an implementation in Java of XSL Transformations）、MSXML2、Xalan等。如果需要转换为PDF格式，进一步使用FOP等FO Processor。

DocBook 规范有多个不同的版本，每一个版本有其相应的schema。一般来说，对V4.5支持的工具更为成熟和广泛，尽管最新的版本为V5.0。V5.0更能体现XML的模块化开发思想，明显的体现是V4.5的ulink元素被XLink规范所取代。

工具下载：

XXE个人版

http://www.xmlmind.net/xmleditor/_download/xxe-perso-5_1_0-setup.exe

 

简单使用XMLmind XML Editor

 

XXE GUI 菜单的中文语言包

将该语言包解包后，放到 XXE 安装目录的 addon 子目录下，然后启动 XXE，其图形化界面就自动切换为中文语言环境了.

配置

打开 XXE 选项菜单中的“选项”，即可打开 XXE 配置对话框。

XXE 默认配置中没有设置中文自动换行，另外对于 XXE 编辑器内文档的字体、字号也需要真对自己的喜好进行一些设定，它们可以在 XXE 配置对话框的 “查看” 项中进行设定。

 

中文自动换行设置:

Options->View下选中“Wrap words wider than avalible space”.

 

 

使用FOP转换Docbook到PDF时遇到的错误及解决
http://easwy.com/blog/archives/fop-errors-and-solution/       
Couldn't find hyphenation pattern zh_cn

輸出html文檔:
d:/docbook/xsltproc/bin/xsltproc --xinclude -o docbook5-sample.html docbook.xsl docbook5-sample.xml       
輸出pdf文檔:
d:/docbook/xsltproc/bin/xsltproc --xinclude -o docbook5-sample.fo docbook_fo.xsl docbook5-sample.xml
d:/docbook/fop-1.0/fop -c d:\docbook\fop-1.0\conf\fop.xconf docbook5-sample.fo -pdf docbook5-sample.pdf   
輸出chm文檔:   
copy "c:\Program Files\HTML Help Workshop\hhc.exe" d:\docbook\example
d:/docbook/xsltproc/bin/xsltproc --xinclude docbook_chm.xsl docbook5-sample.xml
hhc.exe htmlhelp.hhp

錯誤信息:
Element include in namespace 'http://www.w3.org/2001/XInclude' encountered in article, but no template matches.
解決處理:
the xincludes must be resolved before the XSL is applied. See http://www.sagehill.net/docbookxsl/Xinclude.html