# J.2.工具集

J.2.1.在Fedora、RHEL和衍生产品上安装J.2.2.在FreeBSD上安装J.2.3.Debian软件包J.2.4.马科斯J.2.5.通过检测配置

以下工具用于处理文档。如前所述,有些可能是可选的。

DocBook DTD (opens new window)

这就是DocBook本身的定义。我们目前使用的是4.5版;不能使用更高或更早的版本。您需要DocBook DTD的XML变体,而不是SGML变体。

DocBook XSL样式表 (opens new window)

其中包含将DocBook源转换为其他格式(如HTML)的处理说明。

目前要求的最低版本为1.77.0,但建议使用最新的可用版本以获得最佳效果。

Libxml2 (opens new window)对于xmllint

这个图书馆和xmllint它包含的工具用于处理XML。许多开发人员已经安装了Libxml2,因为在构建PostgreSQL代码时也会使用它。然而,请注意xmllint可能需要从单独的子包安装。

Libxslt (opens new window)对于xsltproc

xsltproc是一个XSLT处理器,即使用XSLT样式表将XML转换为其他格式的程序。

FOP (opens new window)

这是一个将XML转换为PDF的程序。

对于处理文档所需的各种工具,我们有记录在案的几种安装方法的经验。这些将在下文中描述。这些工具可能还有其他一些打包发行版。请向文件邮寄列表报告包裹状态,我们将在此处提供该信息。

您可以不在本地安装DocBook XML和DocBook XSLT样式表,因为所需的文件将从Internet下载并在本地缓存。如果您的操作系统包只提供这些文件的旧版本,或者根本没有可用的包,那么这实际上可能是首选的解决方案。如果要防止在生成文档时试图访问Internet,需要通过--诺内特选择xmllintxsltproc; 下面是一个例子。

# J.2.1.在Fedora、RHEL和衍生产品上安装

要安装所需的软件包,请使用:

yum install docbook-dtds docbook-style-xsl fop libxslt

# J.2.2.在FreeBSD上安装

要安装所需的软件包,请使用背包,使用:

pkg install docbook-xml docbook-xsl fop libxslt

当从医生你需要使用的目录gmake,因为提供的makefile不适用于FreeBSD制作.

# J.2.3.Debian软件包

Debian GNU/Linux提供了一整套文档工具。要安装,只需使用:

apt-get install docbook-xml docbook-xsl fop libxml2-utils xsltproc

# J.2.4.马科斯

在macOS上,您可以构建HTML和man文档,而无需安装任何额外的东西。如果您想构建PDF或安装DocBook的本地副本,可以从首选的软件包管理器获得这些文件。

如果您使用MacPorts,以下内容将帮助您进行设置:

sudo port install docbook-xml-4.5 docbook-xsl fop

如果使用自制软件,请使用:

brew install docbook docbook-xsl fop

# J.2.5.通过检测配置

在生成文档之前,需要运行配置脚本,就像构建PostgreSQL程序时一样。在接近运行结束时检查输出;应该是这样的:

checking for xmllint... xmllint
checking for xsltproc... xsltproc
checking for fop... fop
checking for dbtoepub... dbtoepub

如果xmllintxsltproc如果找不到,您将无法生成任何文档。fop只需要以PDF格式构建文档。dbtoepub只需要以EPUB格式构建文档。

如果有必要,你可以告诉我配置例如,在哪里可以找到这些程序

./configure ... XMLLINT=/opt/local/bin/xmllint ...

另外,如果你想确保xmllintxsltproc不会执行任何网络访问,可以执行以下操作

./configure ... XMLLINT="xmllint --nonet" XSLTPROC="xsltproc --nonet" ...