技术开发 频道

Linux 文档编写全攻略

    2、使用 SGMLtools-Lite 产生输出文件 

    安装SGMLtools-Lite后,使用起来就相当简单。SGMLtools-Lite 主要用来从 DocBook 文件中产生 HTML、PostScript、RTF 或纯文本文件。 

    (1)产生 HTML 文件 

    要从格式为 helloworld.sgml 的 DocBook 文件中产生 HTML 输出,输入以下命令:

sgmltools -b html helloworld.sgml
    "-b" 参数告诉 SGMLtools-Lite 产生 HTML 输出。这将创建一个名为 " helloworld.sgml " 的目录,并且 HTML 文件在其中。如果您的 DocBook 文档调用其它文件,SGMLtools-Lite 也将处理它们,并自动创建索引和“页面”之间的导航。下面我们可以使用浏览器察看这个简单文档。见图3。


图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建立文档的基础,和两个产生输出的工具。

1
相关文章