| PostgreSQL 8.0.0 中文文件（轉譯自 PostgreSQL 中國 製作的簡體中文版本） | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Appendix G. 文件 | Fast Forward | Next |
下面的工具用於處理此文件。有些可能是可選的，在文中標注了。
這是 DocBook 本身的定義。我們目前使用版本 4.2； 您不能使用更新或者早些的版本。請注意還有一個 XML 版本的 DocBook — 可別用它。
這是 DocBook 需要的，但是獨立發佈，因為它們是由 ISO 維護的。
這是處理 SGML 的基本包。 它包含一個 SGML 分析器，一個 DSSSL 處理器（也就是一個 用 DSSSL 風格資料表把 SGML 轉換成其他格式的程序），還有一系列相關工具。 現在 Jade 由 OpenJade 組維護，而不再是 James Clark 了。
這些東西包含把 DocBook 原始碼轉換成其它格式，比如 HTML，的處理指令。
這個可選的包是用於建立手冊頁的。它自己有一系列包要求先安裝。 請查看網站。
如果您需要，您還可以安裝 JadeTeX，把 TeX 用做 Jade 的一種格式化後端。 JadeTeX 可以生成 Postscript 或者 PDF 文件(後者帶書籤)。
不過，JadeTeX 的輸出比 RTF 後端稍差一點的 打印輸出。主要是資料表的格式和各種豎直和水平的空白效果。 而且，您還沒有機會手工潤色輸出結果。 不過，它執行得很好，尤其是那些不用資料表格的簡單些的文件，
我們已經在文件中記錄了幾種安裝處理此文件所需的各種工具的方法。 它們在下面描述。也可能有其它包發佈這些工具。請向 doc 郵件列資料表 報告那些包的狀態，我們就會在這裡包括那些訊息。
許多供應商在它們的版本裡提供了一整套處理 DocBook 的 RPM 包， 通常是基於 Red Hat Software 的 docbook-tools 的。安裝的時候請檢查一下 "SGML" 選項，或者下列包之一： sgml-common，docbook, stylesheets，openjade （或 jade）。可能還需要 sgml-tools。 如果您的版本沒有提供這些東西，那麼您應該可以使用來自一些其它 合理兼容的發行商的包。
FreeBSD 文件計劃本身就非常頻繁地使用 DocBook， 所以在 FreeBSD 裡有一整套可以用的文件工具的"ports" 就一點也不奇怪了。要在 FreeBSD 裡製作文件，您必須安裝下面的 port：
textproc/sp
textproc/openjade
textproc/iso8879
textproc/dsssl-docbook-modular
很明顯，現在還沒有 DocBook V4.2 SGML DTD 的 port。您需要手工安裝它。
很多東西來自 /usr/ports/print （tex，jadetex） 您也可能會安裝。
這些 port 很可能不會更新位於 /usr/local/share/sgml/catalog 的主目錄文件。確保您有下面這行：
CATALOG "/usr/local/share/sgml/docbook/4.2/docbook.cat"
如果您不想編輯文件，您還可以把環境變量 SGML_CATALOG_FILES 設置為一個冒號分隔 的目錄文件列資料表（比如上面那樣的）。
您可以在 FreeBSD 文件計劃教學裡找到更多教學.
Debian GNU/Linux 裡面也有一整套 可以用的文件工具的包。 安裝時，只需要用下面的命令：
apt-get install jade apt-get install docbook apt-get install docbook-stylesheets
DocBook 工具的手工安裝過程有些複雜，因此如果您有預製作好的包， 最好還是用它們。我們在這裡只描述一個標準的安裝，而且安裝到標準的路徑裡，並且沒有"神奇"的特性。 相關的更多的細節，您應該學習相關包的文件，並且閱讀 SGML 介紹性材料。
OpenJade 提供了一個 GNU 風格的 ./configure; make; make install 製作過程。您可以在 OpenJade 源程序包裡找到詳細內容。 在 shell 裡：
./configure --enable-default-catalog=/usr/local/share/sgml/catalog make make install
確保您記住了您放 "default catalog" 的位置； 後面您還會需要它。您也可以不用註明這句話，但是稍後您使用 jade 的時候， 您就會不得不把環境變量 SGML_CATALOG_FILES 設置為指向該文件的位置。 （如果 OpenJade 已經安裝，並且您想在本地安裝其它工具的時候，這也是個可選的方法。）
另外，您應該從 dsssl目錄裡把文件 dsssl.dtd，fot.dtd， style-sheet.dtd，和 catalog 安裝上，可能是安裝到 /usr/local/share/sgml/dsssl您。最簡單的可能 就是拷備整個目錄︰
cp -R dsssl /usr/local/share/sgml
最後，建立文件 /usr/local/share/sgml/catalog 並且把下面行 加入其中︰
CATALOG "dsssl/catalog"
(這是一個相對路徑，指向在 step 2 裡安裝的文件。請根據年自己的安裝佈局進行調整。)
獲取 DocBook V4.2 發佈。
建立目錄 /usr/local/share/sgml/docbook-4.2 並且進入該目錄。 （實際的位置並非關鍵，上面這個只是在我們這裡的佈局的比較合理的位置。）
$ mkdir /usr/local/share/sgml/docbook-4.2 $ cd /usr/local/share/sgml/docbook-4.2
解包歸檔。
$ unzip -a ...../docbook-4.2.zip
（這個歸檔將把它的文件解開到目前目錄。）
編輯 /usr/local/share/sgml/catalog文件（或者任何 安裝的時候您告訴 jade 的東西）並且把類似下面的行放到該文件裡面：
CATALOG "docbook-4.2/docbook.cat"
下載 ISO 8879 字元記錄 歸檔，解開它，然後把文件放到您放 DocBook 文件的同一個目錄裡。
$ cd /usr/local/share/sgml/docbook-4.2 $ unzip ...../ISOEnts.zip
在裝有 DocBook 和 ISO 文件的目錄裡執行下面的命令︰
perl -pi -e 's/iso-(.*).gml/ISO\1/g' docbook.cat
（這個動作修補了一個小毛病，這個毛病把 DocBook 目錄文件裡使用的名字和 ISO 字元實體文件的名字混淆了。）
要安裝風格資料表，解開發佈的工具包，然後把它挪到一個合適的地方， 比如 /usr/local/share/sgml。 （歸檔會自動生成一個子目錄。）
$ gunzip docbook-dsssl-1.xx.tar.gz $ tar -C /usr/local/share/sgml -xf docbook-dsssl-1.xx.tar
您也可以在 /usr/local/share/sgml/catalog 裡 製作常用的目錄條目︰
CATALOG "docbook-dsssl-1.xx/catalog
因為風格資料表變化頻繁，因此有時候多實驗幾個版本也挺好， PostgreSQL 並不使用這個資料表項。 參閱 Section G.3 獲取有關如何選擇風格資料表的訊息。
要安裝和使用 JadeTeX，您會需要 一套能用的 TeX 和 LaTeX2e，包括支援的 工具和圖形包。 Babel， AMS 字體 和 AMS-LaTeX， PSNFSS 擴展和伴侶工具箱 "the 35 fonts"， 用於生成 PostScript 的 dvips 程序，宏包 fancyhdr， hyperref， minitoc， url 和 ot2enc 所有這些您都可以在您最近的 CTAN 鏡象站點找到。 基本 TeX 系統的安裝遠遠超出了這份介紹 的範圍。您應該可以在任何可以執行 TeX 的系統上找到二進制包。
在您開始使用 JadeTeX 處理 PostgreSQL 文件之前，您需要 增大 TeX 的內部資料結構的尺寸。 關於這些事情的細節可以在 JadeTeX 的安裝教學裡找到。
在製作 jadetex.fmt 格式文件之前， 您可能想編輯 jadetex.ltx 文件， 把 Babel 的配置改變為適合您的路徑。 要修改的行看起來像
\RequirePackage[german,french,english]{babel}[1997/01/23]而且很顯然您應該只列出您需要的唯一的語言， 並且把 Babel 配置為用於該語言。
一旦完成了這些您就可以安裝 JadeTeX 了︰
$ gunzip jadetex-xxx.tar.gz $ tar xf jadetex-xxx.tar $ cd jadetex $ make install $ mktexlsr
最後兩步需要以 root 身份處理。
在您製作文件之前，您需要象製作程序本身那樣 執行 configure 腳本。 檢查執行結尾處的輸出，應該看起來像這樣：
checking for onsgmls... onsgmls checking for openjade... openjade checking for DocBook V4.2... yes checking for DocBook stylesheets... /usr/lib/sgml/stylesheets/nwalsh-modular checking for sgmlspl... sgmlspl
如果 onsgmls 和 nsgmls 都沒有找到，那麼您就看不到最後四行。 如果沒有找到 "DocBook V4.2"，那麼就是您沒有把 DocBook DTD 工具箱裝到 jade 可以找到的地方，或者您沒有正確設置目錄文件。 參閱上面的安裝提示。配置腳本會在一些比較標準的位置尋找 DocBook 風格資料表， 但如果您把它們放在其它位置，那麼您就應該設置環境變量 DOCBOOKSTYLE 為該位置並且在它後面重新執行 configure。