2025年9月25日: PostgreSQL 18 釋出!
支援的版本: 當前 (18) / 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 樣式表將 DocBookrefentry 頁面轉換為適合 man pages 的 *roff 輸出。要建立 man pages,請使用命令

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

提交更正

如果您在文件中發現任何不正確、與您對特定功能的體驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。