支援的版本: 目前版本 (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.3. 使用 Make 建構文件 #

當您完成所有設定後,切換到目錄 doc/src/sgml 並執行以下子章節中描述的其中一個命令來建構文件。(請記得使用 GNU make。)

J.3.1. HTML #

要建構HTML版本的文件

doc/src/sgml$ make html

這也是預設的目標。輸出會出現在子目錄 html 中。

要產生使用 postgresql.org 上的樣式表而不是預設簡單樣式的 HTML 文件,請使用

doc/src/sgml$ make STYLE=website html

如果使用了 STYLE=website 選項,則產生的 HTML 檔案會包含對託管在 postgresql.org 上的樣式表的參考,並且需要網路連線才能檢視。

J.3.2. Manpages #

我們使用 DocBook XSL 樣式表將 DocBook refentry 頁面轉換為適用於 man page 的 *roff 輸出。 要建立 man page,請使用命令

doc/src/sgml$ make man

J.3.3. PDF #

若要使用 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。

J.3.4. 語法檢查 #

建構文件可能需要很長時間。 但是,有一種方法可以僅檢查文件檔案的正確語法,這只需要幾秒鐘

doc/src/sgml$ make check

提交更正

如果您在文件中發現任何不正確、與特定功能的使用經驗不符或需要進一步說明的內容,請使用此表格回報文件問題。