以下工具用於處理文件。有些可能是可選的,如所述。
這是 DocBook 本身的定義。我們目前使用 4.5 版本;您不能使用更高或更早的版本。您需要XML版本的 DocBook DTD,而不是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 節。
如果您在文件中發現任何不正確、與您使用特定功能的經驗不符,或需要進一步澄清之處,請使用此表格回報文件問題。