在設定好一切後,切換到目錄 doc/src/sgml
並執行以下子章節中描述的命令來構建文件。(請記住使用 GNU make。)
構建HTML文件版本
doc/src/sgml$
make html
這也是預設的目標。輸出出現在子目錄 html
中。
要生成使用 postgresql.org 上使用的樣式表生成的 HTML 文件,而不是預設的簡單樣式,請使用
doc/src/sgml$
make STYLE=website html
如果使用了 STYLE=website
選項,生成的 HTML 檔案將包含指向託管在 postgresql.org 上的樣式表的引用,並且需要網路連線才能檢視。
我們使用 DocBook XSL 樣式表將 DocBook 的 refentry
頁面轉換為適合 man pages 的 *roff 輸出。要建立 man pages,請使用命令
doc/src/sgml$
make man
要使用 FOP 生成文件的 PDF 版本,您可以根據首選的紙張格式使用以下命令之一:
對於 A4 格式
doc/src/sgml$
make postgres-A4.pdf
對於美國信函格式
doc/src/sgml$
make postgres-US.pdf
由於 PostgreSQL 文件相當大,FOP 會需要大量的記憶體。因此,在某些系統上,構建可能會因與記憶體相關的錯誤訊息而失敗。這通常可以透過在配置檔案 ~/.foprc
中配置 Java 堆設定來解決,例如:
# FOP binary distribution FOP_OPTS='-Xmx1500m' # Debian JAVA_ARGS='-Xmx1500m' # Red Hat ADDITIONAL_FLAGS='-Xmx1500m'
需要一定的最小記憶體量,並且在某種程度上,更多的記憶體似乎會讓事情變得稍微快一些。在記憶體非常少(小於 1 GB)的系統上,構建可能會由於交換而變得非常緩慢,或者根本無法工作。
在其預設配置中,FOP 將為每個頁面發出一個 INFO
訊息。可以透過 ~/.foprc
更改日誌級別:
LOGCHOICE=-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog LOGLEVEL=-Dorg.apache.commons.logging.simplelog.defaultlog=WARN
其他 XSL-FO 處理器也可以手動使用,但自動構建過程僅支援 FOP。
如果您在文件中發現任何不正確、與您對特定功能的體驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。