當您完成所有設定後,切換到目錄 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 page 的 *roff 輸出。 要建立 man page,請使用命令
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。
如果您在文件中發現任何不正確、與特定功能的使用經驗不符或需要進一步說明的內容,請使用此表格回報文件問題。