2. 下载软件包

在本节中,我们将定位并从互联网下载软件。

2.1. OpenJade

OpenJade 是一个积极维护的开源软件项目,基于 James Clark 的 Jade 软件包。请从以下地址下载最新的稳定版本:

http://openjade.sourceforge.net/

OpenJade 还包括 OpenSP 软件包和 TeX 宏,jadetexpdfjadetex,用于将文件转换为dvipdf。 此软件包提供了以下程序

要使用 jadetexpdfjadetex 制作dvi, ps,和pdf,您必须安装可用的 TeX (tex)。如果您没有 TeX,请检查您的 Linux 发行版是否有可下载和安装的二进制软件包。否则,您可以从以下地址下载 teTeX 发行版的 TeX:

http://www.tug.org/tetex/

2.2. DocBook SGML DTD

用于 SGML 和 XML 的 DocBook DTD 由 Oasis-Open.ORG 的技术委员会维护。请从以下地址下载当前版本(以及您可能需要的任何旧版本)的 DocBook SGML:

http://www.oasis-open.org/docbook/sgml/index.shtml

2.3. ISO8879 ENTITY SGML

实体定义了特殊或不可输入符号或字符的表示形式,包括数学符号,以及您可能从 HTML 中熟悉的实体。需要安装这些实体文件才能进行正确的配置。

ISOEnts.zip可以简单地 unzip 到 DocBook DTD unzip 的目录中,而无需其他任何操作,只需isoENT-tar.gz中的文件也是必需的。同样,isoENT-tar.gz中的文件也要 unzip 到 DocBook DTD 目录中(有关详细信息,请参阅下一节关于安装的内容),但文件名以 ".ent" 后缀结尾。这些文件需要重命名为 ".gml" 结尾。您可以手动执行此操作,也可以下载并使用此作者制作的以下文件,其中包含以下两个文件:ISOEnts.zipisoENT-tar.gz:

http://reaster.com/iso8879-entities.tar.gz

2.4. DocBook DSSSL

Norman Walsh 的 DocBook DTD (SGML/XML) 的文档样式语义和规范语言 (DSSSL) 文件维护在 DocBook Open Repository,位于 SourceForge。这些文件也称为 Modular DocBook Stylesheets,它告诉openjade在将您的 DocBook SGML 文件转换为其他格式时该怎么做。 dsl 文件指定了诸如从一个 DTD 的标签到另一个 DTD 的标签的映射以及其他以 DSSSL 语言编程的程序化转换等内容。 DSSSL 语言被分解为一组不同的语言,但贯穿始终的是基于 Scheme核心表达式语言

DocBook DSSSL 软件包和文档可以从 DocBook DSSSL Stylesheets Project 下载

Linux Documentation Project 有一个样式表自定义文件,可以启用一些不错的样式功能。它可以从以下地址下载:

http://www.linuxdoc.org/authors/tools/ldp.dsl

2.5. SGMLtools-Lite

SGMLtools-Lite 是 openjade 的前端,jadetex, pdfjadex, dvips和其他程序。它提供了一个命令,用于生成使用这些工具可以生成的所有格式。最新的版本可以从以下地址下载:

http://sourceforge.net/projects/sgmltools-lite/

此软件包是可选的,但有时确实使事情变得更容易。

2.6. HTMLdoc

HTMLdoc 是一个免费程序,用于将网站转换为可移植文档格式 (pdf) 或 PostScript (ps)。 对于pdf,它创建了一个书签树,使导航变得容易。 htmldocpdfjadetex 都输出pdf文件,但格式略有不同。 尝试两者,看看哪一个最适合特定的 docbook 文件。 有关下载站点,请参阅下面的快速链接。

您可以从 Easy Software Productsftp 站点 下载最新版本的 HTMLdoc

2.7. DocBook2X

DocBook2X 需要 perl5 和 SGMLS.pm perl 模块,可从 Comprehensive Perl Archive Network (CPAN) 获取。 SGMLS.pm 提供了库和一个名为sgmlspl的程序,该程序通过使用规范文件将 DocBook 文件转换为其他格式。 规范文件是 perl 文件,提供了转换为特定格式的逻辑。

http://www.cpan.org/

http://docbook2x.sourceforge.net/