支援的版本:目前 (17) / 16 / 15 / 14 / 13
開發版本:devel
不支援的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4

J.2. 工具組 #

以下工具用於處理文件。有些可能是可選的,如所述。

DocBook DTD #

這是 DocBook 本身的定義。我們目前使用 4.5 版本;您不能使用更高或更早的版本。您需要XML版本的 DocBook DTD,而不是SGML版本。

DocBook XSL 樣式表 #

這些包含將 DocBook 來源轉換為其他格式(例如HTML.

)的處理指令。目前最低要求的版本是 1.77.0,但建議使用最新的可用版本以獲得最佳效果。

Libxml2 適用於 xmllint #

此函式庫及其包含的 xmllint 工具用於處理 XML。許多開發人員可能已經安裝了 Libxml2,因為它也用於建置 PostgreSQL 程式碼。但是請注意,可能需要從單獨的子套件安裝 xmllint

Libxslt 適用於 xsltproc #

xsltproc 是一個 XSLT 處理器,也就是使用 XSLT 樣式表將 XML 轉換為其他格式的程式。

FOP #

這是一個將 XML 轉換為 PDF 的程式(以及其他功能)。只有在您想要以 PDF 格式建置文件時才需要它。

我們已經記錄了用於安裝處理文件所需的各種工具的幾種方法。這些將在下面描述。這些工具可能還有其他一些封裝好的發行版本。請將套件狀態報告給文件郵件列表,我們將在此處包含該資訊。

J.2.1. 在 Fedora、RHEL 和衍生版本上的安裝 #

要安裝所需的套件,請使用

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

J.2.2. 在 FreeBSD 上的安裝 #

要使用 pkg 安裝所需的套件,請使用

pkg install docbook-xml docbook-xsl libxslt fop

doc 目錄建置文件時,您需要使用 gmake,因為提供的 makefile 不適用於 FreeBSD 的 make

J.2.3. Debian 套件 #

有一整套文件工具套件可用於 Debian GNU/Linux。要安裝,只需使用

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

J.2.4. macOS #

如果您使用 MacPorts,以下命令將為您進行設定

sudo port install docbook-xml docbook-xsl-nons libxslt fop

如果您使用 Homebrew,請使用以下命令

brew install docbook docbook-xsl libxslt fop

Homebrew 提供的程式需要設定以下環境變數。對於基於 Intel 的機器,請使用此指令

export XML_CATALOG_FILES=/usr/local/etc/xml/catalog

在基於 Apple Silicon 的機器上,請使用此指令

export XML_CATALOG_FILES=/opt/homebrew/etc/xml/catalog

如果沒有設定,xsltproc 將拋出類似這樣的錯誤

I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
postgres.sgml:21: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
...

雖然可以使用 Apple 提供的 xmllintxsltproc 版本,而不是 MacPorts 或 Homebrew 提供的版本,但您仍然需要安裝 DocBook DTD 和樣式表,並設定指向它們的目錄檔案。

J.2.5. 由 configure 偵測 #

在您可以建置文件之前,您需要執行 configure 指令碼,就像您在建置 PostgreSQL 程式本身時一樣。檢查執行結束附近的輸出;它應該看起來像這樣

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

如果找不到 xmllintxsltproc,您將無法建置任何文件。fop 僅在以 PDF 格式建置文件時才需要。dbtoepub 僅在以 EPUB 格式建置文件時才需要。

如有必要,您可以告訴 configure 在哪裡可以找到這些程式,例如

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

如果您更喜歡使用 Meson 建置 PostgreSQL,則改為執行 第 17.4 節中描述的 meson setup,然後參閱 第 J.4 節

提交更正

如果您在文件中發現任何不正確、與您使用特定功能的經驗不符,或需要進一步澄清之處,請使用此表格回報文件問題。