J.2.工具集

# 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，需要通过--诺内特选择xmllint和xsltproc; 下面是一个例子。

# 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

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

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

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

另外，如果你想确保xmllint和xsltproc不会执行任何网络访问，可以执行以下操作