| PostgreSQL 7.4 文檔 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Appendix G. 文檔 | Fast Forward | Next |
下面的工具用于處理此文檔．有些可能是可選的，在文中標注了．
這是 DocBook 本身的定義．我們目前使用版本 3.1； 你不能使用更新或者早些的版本．請注意還有一個 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/docbook-310
textproc/iso8879
textproc/dsssl-docbook-modular
很多東西來自 /usr/ports/print （tex，jadetex） 你也可能會安裝．
這些 port 很可能不會更新位于 /usr/local/share/sgml/catalog 的主目錄文件．確保你有下面這行：
CATALOG "/usr/local/share/sgml/docbook/3.1/catalog"
如果你不想編輯文件，你還可以把環境變量 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 V3.1 發布．
創建目錄 /usr/local/share/sgml/docbook31 並且進入該目錄． (實際的位置並非關鍵，上面這個只是在我們這裡的布局的比較合理的位置．)
$ mkdir /usr/local/share/sgml/docbook31 $ cd /usr/local/share/sgml/docbook31
解包歸檔．
$ unzip -a ...../docbk31.zip
(這個歸檔將把它的文件解開到當前目錄．)
編輯 /usr/local/share/sgml/catalog文件（或者任何 安裝的時候你告訴 jade 的東西）並且把類似下面的行放到該文件裡面：
CATALOG "docbook31/docbook.cat"
然後，你可以編輯文件 docbook.cat 然後注釋掉或者刪除含有 DTDDECL 的行．如果你不這麼幹，你會收到來自 jade的警告，不過沒什麼害處．
下載 ISO 8879 字符記錄 歸檔，解開它，然後把文件放到你放 DocBook 文件的同一個目錄裡．
$ cd /usr/local/share/sgml/docbook31 $ 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 V3.1... yes checking for DocBook stylesheets... /usr/lib/sgml/stylesheets/nwalsh-modular checking for sgmlspl... sgmlspl
如果 onsgmls 和 nsgmls 都沒有找到，那麼你就看不到最後四行． 如果沒有找到 "DocBook V3.1"，那麼就是你沒有把 DocBook DTD 工具箱裝到 jade 可以找到的地方，或者你沒有正確設置 目錄文件．參閱上面的安裝提示．配置腳本會在一些比較標準的位置 尋找 DocBook 風格表，但如果你把它們放在其它位置，那麼你就應該 設置環境變量 DOCBOOKSTYLE 為該位置並且在它後面重新運行 configure．