2025年9月25日: PostgreSQL 18 釋出!
支援的版本: 當前 (18) / 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 版本;您不能使用更高或更低的版本。您需要 DocBook DTD 的XML變體,而不是SGML變體。

DocBook XSL Stylesheets #

這些檔案包含用於將 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 節

提交更正

如果您在文件中發現任何不正確、與您對特定功能的體驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。