以下工具用於處理文件。其中一些可能是可選的,如註明所示。
這是 DocBook 本身。我們目前使用 4.5 版本;您不能使用更高或更低的版本。您需要 DocBook DTD 的XML變體,而不是SGML變體。
這些檔案包含用於將 DocBook 原始檔轉換為其他格式(如HTML.
當前所需的最低版本是 1.77.0,但建議使用最新可用版本以獲得最佳效果。
xmllint
#這個庫及其包含的 xmllint
工具用於處理 XML。許多開發人員已經安裝了 Libxml2,因為它在構建 PostgreSQL 程式碼時也使用。但請注意,xmllint
可能需要從單獨的子包安裝。
xsltproc
#xsltproc
是一個 XSLT 處理器,即使用 XSLT 樣式表將 XML 轉換為其他格式的程式。
這是一個用於將 XML 轉換為 PDF 等格式的程式。僅當您想以 PDF 格式構建文件時才需要它。
我們記錄了處理文件所需的各種工具的幾種安裝方法的經驗。這些方法將在下面描述。這些工具可能還有其他打包發行版。請將軟體包狀態報告給文件郵件列表,我們將在此處包含該資訊。
要安裝所需的軟體包,請使用
yum install docbook-dtds docbook-style-xsl libxslt fop
要使用 pkg
安裝所需的軟體包,請使用
pkg install docbook-xml docbook-xsl libxslt fop
從 doc
目錄構建文件時,您需要使用 gmake
,因為提供的 makefile 不適用於 FreeBSD 的 make
。
對於 Debian GNU/Linux,有完整的文件工具軟體包。要安裝,只需使用
apt-get install docbook-xml docbook-xsl libxml2-utils xsltproc fop
如果您使用 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 提供的 xmllint
和 xsltproc
版本,而不是 MacPorts 或 Homebrew 提供的版本,但您仍然需要安裝 DocBook DTD 和樣式表,並設定一個指向它們的目錄檔案。
configure
的檢測 #在構建文件之前,您需要執行 configure
指令碼,就像構建 PostgreSQL 程式本身一樣。檢查執行結束時的輸出;它應該看起來像這樣
checking for xmllint... xmllint checking for xsltproc... xsltproc checking for fop... fop checking for dbtoepub... dbtoepub
如果找不到 xmllint
或 xsltproc
,您將無法構建任何文件。 fop
僅在構建 PDF 格式的文件時需要。 dbtoepub
僅在構建 EPUB 格式的文件時需要。
如有必要,您可以告知 configure
這些程式的位置,例如
./configure ... XMLLINT=/opt/local/bin/xmllint ...
如果您更喜歡使用 Meson 構建 PostgreSQL,請按照 第 17.4 節 中的描述執行 meson setup
,然後參閱 第 J.4 節。
如果您在文件中發現任何不正確、與您對特定功能的體驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。