DG2.2. 工具集

下面的工具用于处理此文档.有些可能是可选的,在文中标注了.

DocBook DTD

这是 DocBook 本身的定义.我们目前使用版本 3.1; 你不能使用更新或者早些的版本.请注意还有一个 XML 版本的 DocBook -- 可别用它.

ISO 8879 字符记录

这是 DocBook 需要的,但是独立发布,因为它们是由 ISO 维护的.

Jade

这是处理 SGML 的基本包. 它包含一个 SGML 分析器,一个 DSSSL 处理器(也就是一个 用 DSSSL 风格表把 SGML 转换成其他格式的程序),还有一系列相关工具. 现在 Jade 由 OpenJade 组维护,而不再是 James Clark 了.

Norm Walsh 的模块 DocBook 风格表 (Modular DocBook Stylesheets)

这些东西包含把 DocBook 源代码转换成其它格式,比如 HTML,的处理指令.

DocBook2X 工具

这个可选的包是用于创建手册页的.它自己有一系列包要求先安装. 请查看网站.

JadeTeX

如果你需要,你还可以安装 JadeTeX,把 TeX 用做 Jade 的一种格式化后端. 这样将生成比 RTF 后端稍差一点的 打印输出.主要是表的格式.而且,你还没有机会手工润色输出结果. 不过,它运行得很好,尤其是那些不用表格的简单些的文档, 并且 JadeTeX 和它的风格表 仍然在不断地改进中,所以随着时间的推移,它肯定会变得更好.

我们已经在文档中记录了几种安装处理此文档所需的各种工具的方法. 它们在下面描述.也可能有其它包发布这些工具.请向 doc 邮件列表 报告那些包的状态,我们就会在这里包括那些信息.

DG2.2.1. Linux RPM 安装

许多供应商在它们的版本里提供了一整套处理 DocBook 的 RPM 包, 通常是基于 Red Hat Software 的 docbook-tools 的.安装的时候请检查一下 “SGML” 选项,或者下列包之一: sgml-commondocbook, stylesheetsopenjade (或 jade).可能还需要 sgml-tools.will be needed as well. If your 如果你的版本没有提供这些东西,那么你应该可以使用来自一些大的, 合理兼容的发行商的包.

DG2.2.2. FreeBSD 安装

FreeBSD 文档计划本身就非常频繁地使用 DocBook, 所以在 FreeBSD 里有一整套可以用的文档工具的“ports” 就一点也不奇怪了.要在 FreeBSD 里制作文档,你必须安装下面的 port:

很多东西来自 /usr/ports/printtexjadetex) 你也可能会安装.

这些 port 很可能不会更新位于 /usr/local/share/sgml/catalog 的主目录文件.确保你有下面这行:

CATALOG "/usr/local/share/sgml/docbook/3.1/catalog"
如果你不想编辑文件,你还可以把环境变量 SGML_CATALOG_FILES 设置为一个冒号分隔 的目录文件列表(比如上面那样的).

你可以在 FreeBSD 文档计划指导里找到更多指导.

DG2.2.3. Debian 包

Debian GNU/Linux 里面也有一整套 可以用的文档工具的包. 安装时,只需要用下面的命令:

apt-get install jade
apt-get install docbook
apt-get install docbook-stylesheets

DG2.2.4. 从源程序里手工安装

DocBook 工具的手工安装过程有些复杂,因此如果你有预制作好的包, 最好还是用它们.我们在这里只描述一个标准的安装,而且安装到 标准的路径里,并且没有“神奇”的特性. 相关的更多的细节,你应该学习相关包的文档,并且阅读 SGML 介绍性材料.

DG2.2.4.1. 安装 Jade

OpenJade 提供了一个 GNU 风格的 ./configure; make; make install 制作过程.你可以在 OpenJade 源程序包里找到详细内容. 在 shell 里:

./configure --enable-default-catalog=/usr/local/share/sgml/catalog
make
make install
确保你记住了你放 “default catalog” 的位置; 后面你还会需要它.你也可以不用注明这句话,但是 稍后你使用 jade 的时候,你就会不得不 把环境变量 SGML_CATALOG_FILES 设置为指向该 文件的位置.

另外,你应该从 dsssl目录里把文件 dsssl.dtdfot.dtdstyle-sheet.dtd,和 catalog 安装上,可能是安装到 /usr/local/share/sgml/dsssl吧.(或者 就是拷备整个目录.)

DG2.2.4.2. 安装 DocBook DTD 工具箱

  1. 获取 DocBook V3.1 发布.

  2. 把压缩归档解压缩.

    $ unzip -a docbk31.zip

  3. 把文件放到目录 /usr/local/share/sgml/docbook31 中. (具体的位置没有什么关系,不过这个位置非常标准.)

  4. 创建一个 /usr/local/share/sgml/catalog文件(或者任何 安装的时候你告诉 jade 的东西)并且把类似下面的行放到该文件里面:

    CATALOG "docbook31/docbook.cat"

    然后,你可以编辑文件 docbook.cat 然后注释掉或者删除含有 DTDDECL 的行.如果你不这么干,你会收到来自 jade的警告,不过没什么害处.

  5. 下载 ISO 8879 字符记录 归档,解开它,然后把文件放到你放 DocBook 文件的同一个目录里.

DG2.2.4.3. 安装 Norman Walsh 的DSSSL 风格表

要安装风格表,只需要在一个合适的位置解开发布的工具包, 比如 /usr/local/share/sgml/stylesheets. (归档会自动生成一个 docbook 子目录.)

DG2.2.4.4. 安装 JadeTeX

要安装和使用 JadeTeX,你会需要 一套能用的 TeXLaTeX2e,包括支持的 工具图形包. BabelAMS 字体AMS-LaTeXPSNFSS 扩展和伴侣工具箱 “the 35 fonts”, 用于生成 PostScriptdvips 程序,宏包 fancyhdrhyperrefminitocurlot2enc,以及还有 JadeTeX 本身.所有这些你都可以在你最近 的 CTAN 镜象站点找到.

在我们写这些的时候, JadeTeX 还没有附带安装向导, 不过有一个 makefile 表明了所需要的东西. 它还包括一个目录 cooked,你会在那里 找到一些它需要的宏包,但不是全部,而且不完全 -- 至少我们上次看 是如此.

在制作 jadetex.fmt 格式文件之前, 你可能想编辑 jadetex.ltx 文件, 把 Babel 的配置改变为适合你的路径. 要修改的行看起来象

\RequirePackage[german,french,english]{babel}[1997/01/23]
而且很显然你应该只列出你需要的唯一的语言, 并且把 Babel 配置为用于该语言.

当你用 JadeTeX 处理 PostgreSQL 的文档源文件时, TeX 很可能会在第二次运行时停止. 并且告诉你超出它的能力了.据我们所知,这个现象的原因是 JadeTeX 生成交叉引用信息的方法. 当然,TeX 能够以更大的数据结构尺寸 编译.其细节则会根据你的安装有所不同.