Linux 文档编写全攻略
2、使用 SGMLtools-Lite 产生输出文件
安装SGMLtools-Lite后,使用起来就相当简单。SGMLtools-Lite 主要用来从 DocBook 文件中产生 HTML、PostScript、RTF 或纯文本文件。
(1)产生 HTML 文件
要从格式为 helloworld.sgml 的 DocBook 文件中产生 HTML 输出,输入以下命令:
"-b" 参数告诉 SGMLtools-Lite 产生 HTML 输出。这将创建一个名为 " helloworld.sgml " 的目录,并且 HTML 文件在其中。如果您的 DocBook 文档调用其它文件,SGMLtools-Lite 也将处理它们,并自动创建索引和“页面”之间的导航。下面我们可以使用浏览器察看这个简单文档。见图3。sgmltools -b html helloworld.sgml

图3: 经过sgmltools处理后手册页面
(2)产生 RTF 文件
如果需要与使用MS Word 的人共享文档,则需要输出多文本格式 (Rich Text Format),或 RTF 格式的文件。如果使用 SGMLtools-Lite,这一过程同样简单:
sgmltools -b rtf helloworld.sgml
3、使用docbook-utils输出HTML文档
docbook-utils是用来管理DocBook文档的shell脚本,我们可以其中一个子脚本,把你要处理的DocBook文件名helloworld.sgml作为参数传递给它:
db2html helloworld.sgml
output is helloworld
Using catalogs: /etc/sgml/sgml-docbook-4.2-1.0-17.cat
Using stylesheet: /usr/share/sgml/docbook/utils-0.6.12/docbook-utils.dsl#html
Working on: /tmp/helloworld.sgml
Done.
处理的过程表明了使用哪一种DocBook目录和样式表。转换接受后会产生一个目录helloworld,其中包含一个名为t1.html的文件。同样可以在浏览器中打开。
4.其他格式输出
Linux还内置了一些其他输出命令:
•docbook2man — 把DocBook文件转换为手册页。
•docbook2pdf —把DocBook文件转换为PDF格式。
•docbook2ps —把DocBook文件转换为PostScript格式。
•docbook2txt —把DocBook文件转换为txt格式。
•docbook2dvi —把DocBook文件转换为dvi格式。
•docbook2html —把DocBook文件转换为HTML格式。
命令使用格式请查看帮助系统。方法是:docbook2pdf -help
由于DocBook相当复杂,上面只是介绍了一小部分DocBook建立文档的基础,和两个产生输出的工具。