DocBook的HTML编译环境
DocBook 文档向 HTML 文档转换流程
DocBook文档转换为HTML文档流程如下图所示:
XML 语法检验工具
开源的XML校验工具似乎不是很多,主要就是xmllint。一般linux发行版都带这个工具。
xmllint 的用法示例:
$ xmllint --noout --dtdvalid \
http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd docbook_file.xml
http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd docbook_file.xml
XML 转换器
xsltproc是libxslt库的命令行处理程序,用于处理xml文档。我们利用xsltproc来处理docbook文档,输出各种格式的文档。官方网站:http://xmlsoft.org/
xsltproc 用法示例 1:利用样式表生成单页的html文档,生成文档名为docbook_file.html,生成的文档位于当前目录。
$ xsltproc --stringparam html.stylesheet docbook.css \
/usr/share/sgml/docbook/xsl-stylesheets/html/docbook.xsl \
docbook_file.xml > docbook_file.html
/usr/share/sgml/docbook/xsl-stylesheets/html/docbook.xsl \
docbook_file.xml > docbook_file.html
xsltproc 用法示例 2:利用样式表生成多页的html文档,每章和每小节都会生成独立的一个html文档,生成文档位于当前目录。
$ xsltproc --stringparam html.stylesheet docbook.css \
/usr/share/sgml/docbook/xsl-stylesheets/html/chunk.xsl docbook_file.xml
用-o选项可指定生成文档的路径