下一页 上一页 目录

6. 获取/使用 LinuxDoc 软件

即使不安装任何 LinuxDoc 软件,您也可以编写 LinuxDoc 文档。然而,文档很可能在标签(或标签的使用)上包含一些错误,因此会被退回给您进行更正。即使没有错误,结果看起来也可能不太正确。因此,您最好在您的计算机上安装软件来转换您的源代码。

Debian Linux 发行版包含 linuxdoc-tools 软件包。对于非 Debian 发行版,也有 rpm 软件包。它以前被称为 sgml-tools。请不要使用 sgmltools-2 软件包,它主要用于 DocBook-sgml。

要使用 linuxdoc-tools,您需要在 *.sgml 文件上运行转换程序。例如,对于 0.9.21-0.8 之后的版本,要获得文本输出,请输入:"sgml2txt -f --blanks=1 my-HOWTO.sgml"。对于早期版本,由于一个错误,您必须用 --pass="-P-cbou" 替换 -f。(如果您感兴趣,请参阅 文本输出中转义序列的旧问题 以获取有关此错误的更多信息。)要获得 html 输出,请输入:"sgml2html my-HOWTO.sgml"。如果显示错误,它将显示错误在源文件中的行号和列号。输入 "man -k sgml" 应该会显示一些其他程序以及每个程序的一行描述,但并非所有程序都适用于 linuxdoc-sgml。


下一页 上一页 目录