[ 永遠的UNIX > PostgreSQL7.0手冊-附錄-文檔 ]

[ 永遠的UNIX::UNIX技術資料的寶庫 ] GB | BIG5

首頁 > 數據庫 > 其它 > 正文

PostgreSQL7.0手冊-附錄-文檔

編譯：何偉平 laser@zhengmai.com.cn (2001-04-21 23:50:44)

附錄　DG2.　文檔
內容　
文檔地圖　
文檔項目計劃　
文檔源文件　
制作文檔　
手冊頁　
v7.0　文檔硬拷貝生成　
工具集　
可選工具集　
文檔的目的是使　Postgres　易學習、使用和開發．文檔集應該描述　Postgres　系統、語言和接口．文檔應該能夠回答通常的問題並且讓用戶能夠找到這些答案而無須尋求郵件列表的支持．　
文檔地圖
Postgres　有四種主要的文檔格式：　
用安裝前信息的純文本格式．　
HTML，用在線瀏覽和參考．　

硬拷貝（Postscript　或　PDF），用深入了解和參考．　

man　pages（手冊頁），用快速參考．

表　DG2-1.　Postgres　文檔內容　
　　　
　
　文件　　描述　　
./COPYRIGHT　版權聲明　
./INSTALL　安裝指導（從　sgml->rtf->text　來的文本）　
./README　介紹性信息　
./register.txt　制作過程中的注冊信息　
./doc/bug.template　臭虫報告模版　
./doc/postgres.tar.gz　集成的文檔（HTML）　
./doc/programmer.ps.gz　程序員手冊（Postscript）　
./doc/programmer.tar.gz　程序員手冊（HTML）　
./doc/reference.ps.gz　參考手冊（Postscript）　
./doc/reference.tar.gz　參考手冊（HTML）　
./doc/tutorial.ps.gz　介紹（Postscript）　
./doc/tutorial.tar.gz　介紹（HTML）　
./doc/user.ps.gz　用戶手冊（Postscript）　
./doc/user.tar.gz　用戶手冊（HTML）　

有用安裝的手冊頁，同樣在　Postgres　的源代碼樹裡還有大量的純文本的　README　類型文件．

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

文檔項目計劃
打包的文檔可以同時獲得　HTML　和　Postscript　格式的．這些可以作為標準的　Postgres　安裝的一部分獲得．我們在這裡討論對文檔源文件的加工和生成文檔包的問題．　
文檔源文件是用　SGML　標記純文本文件寫成的。　DocBookSGML　的目的是允許作者聲明一個技術文檔的內容和結構（利用　DocBookDTD），並且由文檔的風格決定其內容最是如何呈現為最終形式（例如．使用　Norm　Walsh　的組件風格表（Modular　Style　Sheets））．　

參閱　DocBook　的介紹　獲取一些關　DocBook　特性的很好的"快速入門讀物"．DocBook　元素　提供了一個　DocBook　特性的很好的交叉參考．　

這份文檔集是使用好幾種工具寫成的，包括　James　Clark　的　jade　和　Norm　Walsh　的　組件　DocBook　風格表。　

目前，硬拷貝是把從　jade　輸出獲得的　富文本格式　（Rich　Text　Format）（RTF）輸入到　ApplixWare　做一些微小的修改然輸出成　Postscript　文件．　

TeX　是　jade　支持的輸出格式之一，但是目前因為幾個原因沒有使用，包括在提交之前不能做微小的格式修改以及通常在TeX　風格表裡面對表格的支持不夠．

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

文檔源文件
文檔源文件包括純文本文件，手冊頁和　html．不過，大多數新的　Postgres　文檔將用標準的一般性標記語言（Standard　Generalized　Markup　Language）（SGML）DocBook文檔類型定義　（Document　Type　Definition　）（DTD）書寫．目前存在的許多文檔都已經或將要被轉換成　SGML．　
SGML　的目的是允許一個作者聲明一份文檔的結構和內容（例如，使用　DocBookDTD），並且由文檔風格定義內容是如何呈現為最的形式（例如，使用　Norm　Walsh　的風格表（stylesheets））．　

文檔是從幾個不同的源收集來的．在我們把現有文檔整合組裝成一個連貫的文檔集時，原先的文檔就過時了並且將被從版本中刪除．但是，這些動作不會立即發生，並且不會對所有文檔同時產生作用．為簡化翻譯工作，以及為了給開發人員和作者提供幫助，我們定義了翻譯過程圖．　

文檔結構
目前有五套用　DodBook　書寫的獨立的文檔．每個文檔都有一個源文檔容器，該容器定義　DocBook　環境和其他文檔源文件．這些基本的源文件放在　doc/src/sgml/，與許多文檔使用的其他源文件放在一起．主要的源文件是：　
postgres.sgml　
這是一個集成的文檔，包括作為部件的所有其他文檔．生成的輸出是　HTML　格式，因為瀏覽器的界面把在各個文檔中跳轉簡化成簡單的敲擊．可以同時得到其他文檔的　HTML　和硬考貝。
tutorial.sgml　
介紹教程和例子．不包括編程的話題，而且是試圖幫助那些不熟悉　SQL　的讀者．這是"啟蒙"文檔．　
user.sgml　
用戶手冊．包括數據類型和用戶級接口的信息．這是放關"為什"的信息的地方．　
reference.sgml　
參考手冊．包括　Postgres　SQL　語法．這是放關"怎做"的信息的地方．　
programming.sgml　
程序員手冊．包括　Postgres　擴展性和編程接口的信息．　
admin.sgml　
管理員手冊．包括安裝和發布信息．　
風格和傳統
DocBook　有著豐富的標記和構件，並且讓人驚奇的是其中有很大一部分很顯然對格式良好的文檔很有幫助．Postgres　的文檔集只是最近才採納了　SGML，並且在不遠的將來，有一部分章節將被選擇出來並且作為　DocBook　應用的樣例原形進行維護．同樣在下面將包括一個簡短的DocBook　標記的概要．
SGML　寫作工具
目前的　Postgres　文檔集是用純文本編輯器（或者說　emacs/psgml；見下文）用　SGML　對其內容進行標記寫成的．　
SGML　和　DocBook　沒有受到過多的開放源碼寫作工具的影響．最常用的工具集是帶有　psgml　擴展特性的　emacs/xemacs　編輯包．在一些系統上（例如．RedHat　Linux）這些工具在典型的完全安裝時是一並安裝的．　

emacs/psgml
emacs（以及　xemacs）有一個　SGML主模式（major　mode）。如果正確的做了配置，它將允許你使用emacs　插入標簽和檢查標記連貫性。　
把下面這幾行放到你的　~/.emacs　環境文件裡（根據你的系統調整路徑名）：　

;　**********　for　SGML　mode　(psgml)

(setq　sgml-catalog-files　"/usr/lib/sgml/CATALOG")
(setq　sgml-local-catalogs　"/usr/lib/sgml/CATALOG")

(autoload　'sgml-mode　"psgml"　"Major　mode　to　edit　SGML　files."　t　)
在同一個文件裡增加一條記錄，把　SGML　加入（現存的）自動模式別名的定義中（auto-mode-alist）：　
(setq
　　auto-mode-alist
　　'(("\\.sgml$"　.　sgml-mode)
　　　))
每個　SGML　源文件在末尾都有下面的塊：　
!--　Keep　this　comment　at　the　end　of　the　file
Local　variables:
mode:　sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"./reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:("/usr/lib/sgml/catalog")
sgml-local-ecat-files:nil
End:
--
Postgres　的發布版包含一個已經分析好了的　DTD　定義文件　reference.ced。你可以找到（譯注：未完？）　
當使用　emacs/psgml　時，有一個讓自己在這些分離的文件上幹活方便些的辦法：就是你在編輯它們的時候插入合適的　DOCTYPE　定義．例如，如果你在這個源文件上幹活，這是一個附錄章節，因此你將通過把第一行標記成象下面的樣子，從而把這個文檔聲明為一個　DocBook　文檔的"附錄"（appendix）：　

　　　　　　!doctype　appendix　PUBLIC　"-//Davenport//DTD　DocBook　V3.0//EN"
這意味著任何或所有讀取　SGML　的軟件將能正確讀取這份文件，並且我可以用　"nsgmls　-s　docguide.sgml"　校驗此文檔．

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

制作文檔
GNU　make　被用從　DocBook　源文件裡制作文檔．在你安裝時可能有幾個環境變量定義需要設置或更改．Makefile　將查找　doc/../src/Makefile　和　（隱含地）查找　doc/../src/Makefile.custom　以獲取環境信息．在我的系統上，src/Makefile.custom　是這樣的　
#　Makefile.custom
#　Thomas　Lockhart　1998-03-01

POSTGRESDIR=　/opt/postgres/current
CFLAGS+=　-m486
YFLAGS+=　-v

#　documentation

HSTYLE=　/home/lockhart/SGML/db143.d/docbook/html
PSTYLE=　/home/lockhart/SGML/db143.d/docbook/print
這裡　HSTYLE　和　PSTYLE　分別確定用　HTML　和硬拷貝（打印）的風格表的　docbook.dsl　的路徑．這些風格表文件名是用　Norm　Walsh　的模塊化風格表（Modular　Style　Sheets）的；如果使用了其他風格表，那你可以定義　HDSL　和　PDSL　為該風格表的全路徑和名稱，就象上面對　HSTYLE　和　PSTYLE　做的那樣．在許多系統上，這些風格表將可以在安裝在　/usr/lib/sgml/　或　/usr/local/lib/sgml/　裡的軟件包裡找到．　
HTML　文檔包可以鍵入下面命令從　SGML　源文件裡生成　

%　cd　doc/src
%　make　tutorial.tar.gz
%　make　user.tar.gz
%　make　admin.tar.gz
%　make　programmer.tar.gz
%　make　postgres.tar.gz
%　make　install
這些包可以在主文檔目錄裡面鍵入下面命令生成　
%　cd　doc
%　make　install

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

手冊頁
我們使用工具　docbook2man　把　DocBook參考頁轉換成適合手冊頁的　*roff　輸出。在我們寫作的時候，這個工具需要打補丁才能成功的在Postgres　標記上面運行，同時我們增加了一小部分新的功能，以允許在輸出文件名上設置手冊頁的段落。　
docbook2man　是用　perl　寫的，並且需要　CPAN　包　SGMLSpm　來運行。同樣，它還要求使用　nsgmls，這個軟件包含在jade　的發布版裡。在安裝完這些包，只需要運行　

$　cd　doc/src
$　make　man
就會在　doc/src　裡生成一個　tar　文件。　
docbook2man　安裝過程　

安裝　docbook2man　包，可在　http://shell.ipoline.com/~elmert/comp/dobook2X/　獲得。
安裝　SGMLSpm　perl　模塊，可在　CPAN　獲得。
如果你安裝　jade　是還沒有安裝　nsgmls，安裝之。

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

v7.0　的硬拷貝生成
Postscript　文檔的硬拷貝是通過把　SGML　源碼轉換成RTF，然輸入到　ApplixWare-4.4.1．經過一些清理（見面章節）把輸出"打印"到一個　postscript　文件裡面去．　
文本硬拷貝
INSTALL　和　HISTORY　文件每次版本升級都要更新。由歷史原因，這些文件是純文本的，不過是從新的SGML　源文件裡產生的。　
　　
生成純文本　
INSTALL　和　HISTORY　都是從現存的　SGML　源文件裡生成的。他們是從同樣的中間　RTF　裡抽取出來的。　

　　
鍵入下面命令，生成　RTF：　
%　cd　doc/src/sgml
%　make　installation.rtf
把　installation.rtf　輸入到　Applix　Words　裡。　
設置頁面寬度和頁邊距。　

調整　File.PageSetup　裡的頁面寬度為　10　英寸。　
選擇所有文本。用尺子調整右邊距為　9.5　英寸。這樣將得到一個最多　79　字符的列寬，處目標的　80　列的上限裡。

刪掉文檔中不需要的部分。　
對　INSTALL，刪掉文本底部的所有版本信息。對　HISTORY，刪掉直到版本信息的所有內容，保存和修改標題和目錄（ToC）。　

把結果輸出為“ASCII　Layout”（文本格式）。　

用　emacs　或　vi，清理　INSTALL　裡面的制表信息。刪除移植貢獻人的“mailto”URL　（郵件地址）以減少列高。

Postscript　硬拷貝
在生成　Postscript　硬拷貝時要注意幾個地方。包括　RTF　修復，ToC　省城，以及分頁調整．　
　　
Applixware　RTF　清理　
Applixware　對輸入的由　jade/MSS　生成的　RTF　文件好象處理得不充分．尤其是所有文本都賦予了　“Header1”　風格屬性標簽，盡管文本格式本身可以接受的．還有，目錄（Table　of　Contents）頁數並沒有指向列在表中的章節的頁數，而是　ToC　自己的頁數．　

鍵入下面命令生成　RTF（例如）：　
%　cd　doc/src/sgml
%　make　tutorial.rtf
修復　RTF　文件，以正確聲明所有風格，尤其是缺省風格．這些域可以　vi　或者下面簡單的l　sed　過程處理：　
#!/bin/sh
#　fixrtf.sh
#　Utility　to　repair　slight　damage　in　RTF　files　generated　by　jade
#　Thomas　Lockhart　
#
for　i　in　$*　;　do
　　mv　$i　$i.orig
　　cat　$i.orig　|　sed　's#\\stylesheet#\\stylesheet{\\s0　Normal;}#'　>　$i
done

exit
這裡該腳本把　{\s0　Normal;}　作為文檔的零級風格．根據　ApplixWare，RTF　標準會禁止增加一種隱含的零級風格，盡管　M$Word　碰巧可以處理這種情況．　
在　Applix　Words　裡打開新的文檔，然輸入該　RTF　文件．　

用　ApplixWare　生成一個新的　ToC．　

選擇現有的　ToC　行，從第一行第一個字符到最一行最一個字符．　
用　　Tools.BookBuilding.CreateToC　制作一個新的　ToC．選擇頭三層頭用包含在　ToC裡．這將用本地的　ApplixWare　ToC　代替從　RTF　裡輸入進來的行．　

使用　Format.Style　調整　ToC　格式，選擇每三種　ToC　風格，然為　First　和　Left調整邊距．使用下面的值：　

表　DG2-2.　目錄的邊距格式　
　　　
　
　風格　　第一邊距（英寸）　　左邊距（英寸）　　
TOC-Heading　1　0.6　0.6　
TOC-Heading　2　1.0　1.0　
TOC-Heading　3　1.4　1.4　

對文檔進行加工：　
調整分頁符．　
調整表列寬．　

向文檔中插入圖片．用　Applixware　工具條上的居中調整按鈕把每幅圖片放到中央．　

注意：不是所有文檔都有圖片．你可以　grep　SGML　源文件查找字串　"graphic"　以標出那些有圖片的文檔．有幾幅圖片在不同的文檔中有重復．
用正確的值替換　ToC　裡例子和圖片部分右對齊的頁數．這些對每個文檔只需要花幾分鐘．　
如果出現了引用書目，刪去每個記錄的短形式參考標題．Norm　Walsh　的　DocBook　風格表好象把這些打印出來的，甚至這些就是隨根著的信息的子集也一樣．　

把該文檔保存為　Applix　Words　本地文檔格式以便最的編輯．　

把該文檔以　Postscript　格式　"打印"　到一個文件．　

用　gzip　壓縮　Postscript　文件．把壓縮的文件放到　doc　目錄．

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

工具集
安裝處理文檔需要的工具的經驗已經文檔化了，總共有三種方法。一種是在Linux　上從　RPM　裡安裝，第二種是從　FreeBSD　的　port（移植）裡安裝，最一種是從獨立的工具的最初發布裡安裝。這些方法將在下面描述。　
可能還有一些這些工具的其他發布包．請向文檔郵件列表報告包狀態，我們將在這裡包含那些信息．　

Linux　RPM　安裝
使用　Cygnus　的　Mark　Galassi　開發的　RPM　集是對一個　RedHat　兼容的　Linux　系統最簡單的安裝方式。也可以通過源代碼安裝，我們隨的章節將要介紹。　
　　
安裝　RPM　
為　Jade　和相關包安裝　RPM。　
安裝　Norm　Walsh　的最新風格表。取決　RPM　的新舊，最新的風格表可能比　RPM　裡包含的要改進了一些。　

更新你的　src/Makefile.custom　以包含指向風格表的　HSTYLE　和　PSTYLE　定義。

FreeBSD　安裝
在　FreeBSD　上有一整套用文檔工具的移植（ports）。實際上，postgresql.org，其自身的文檔每天晚上自動更新，就是一台　FreeBSD　機器。　
　　
安裝　FreeBSD　移植　
　　
要在　FreeBSD　上面制作文檔，我們需要安裝許多移植包（ports）。　
%　cd　/usr/ports/devel/gmake　&&　make　install
%　cd　/usr/ports/textproc/docproj　&&　make　install
%　cd　/usr/ports/textproc/docbook　&&　make　install
%　cd　/usr/ports/textproc/dsssl-docbook-modular　&&　make　install
設置環境變量以訪問　jade　工具集。　
注意：這些對　postgresql.org　那台　FreeBSD　機器是不需要的，因此你也可能不需要做這些事情。
export　SMGL_ROOT=/usr/local/share/sgml　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　
SGML_CATALOG_FILES=/usr/local/share/sgml/jade/catalog　　　　　　　　　　　　　　　　　　　　　　　　　　　
SGML_CATALOG_FILES=/usr/local/share/sgml/html/catalog:$SGML_CATALOG_FILES　　　　　　　
SGML_CATALOG_FILES=/usr/local/share/sgml/iso8879/catalog:$SGML_CATALOG_FILES　　　　
SGML_CATALOG_FILES=/usr/local/share/sgml/transpec/catalog:$SGML_CATALOG_FILES　　　
SGML_CATALOG_FILES=/usr/local/share/sgml/docbook/catalog:$SGML_CATALOG_FILES　　　　
export　SGML_CATALOG_FILES
（這是　sh/bash　語法；根據實情為　csh/tcsh　做調整）。　
Make　需要一些特殊的參數，或者你要把這些加入你的　Makefile.custom　裡：　

HSTYLE=/usr/local/share/sgml/docbook/dsssl/modular/html/　
PSTYLE=/usr/local/share/sgml/docbook/dsssl/modular/print/
當然，你要用　gmake　而不只是簡單的　'make'　來制作。
Debian　安裝
Debian　裡也有一整套文檔工具包。　
安裝　Debian　包　

安裝　jade，docbook，和　unzip：　
apt-get　install　jade
apt-get　install　docbook
apt-get　install　docbook-stylesheets
安裝最新的風格表。　
確認已經安裝了　unzip，或者安裝包：　
apt-get　install　unzip
從　http://www.nwalsh.com/docbook/dsssl　抓取最新的風格表並且解壓縮到一個位置（可能是　/usr/share）。
編輯　src/Makefile.custom，增加合適的　HSTYLE　和　PSTYLE　定義：　
HSTYLE=　/usr/share/docbook/html
PSTYLE=　/usr/share/docbook/print
手工安裝這些工具
下面是你獲取和安裝用　Emacs　編輯　DocBook　源文件然用　Norman　Walsh　的　DSSSL　風格表處理並創建　HTML　和　RTF　文件所需要工具的一個簡介．　
獲取　SGML　和　DocBook　工具的最簡單方法可能是從　sgmltools　獲取　sgmltools。sgmltools　需要　GNU　版本的　m4。要核實你擁有正確的　m4　版本，鍵入　

gnum4　--version
如果你安裝　GNU　m4，把它裝成名為　gnum4，這樣　sgmltools　將能找到它。在安裝過，你將有　sgmltools，jade　和　Norm　Walsh　的　DocBook　風格表。下面的步驟是分別用安裝這些工具的。　
前提
你需要的東西：　
一個可用的　GCC　2.7.2　
一個可用的　Emacs　19.19　或更新版本　

一個用　UNIX　的　unzip　程序,　用以解包

你需要獲取的：　
James　Clark　的　Jade　（在文件　jade1_1.zip　裡的版本　1.1　是寫作的時候最新的版本）
　　
DocBook　版本　3.0　
Norman　Walsh　的　Modular　Stylesheets　（最初用制作這些文檔的是版本　1.19）　

Lennart　Staflin　的　PSGML　（寫作的時候可用的最新版本是　psgml-1.0.1.tar.gz　裡的　1.0.1）

重要的　URL：　
The　Jade　web　page　
The　DocBook　web　page　

The　Modular　Stylesheets　web　page　

The　PSGML　web　page　

Steve　Pepper's　Whirlwind　Guide　

Robin　Cover's　database　of　SGML　software

安裝　Jade
安裝　Jade　
閱讀上面　URL　列出的安裝指導．　
在一個合適的位置　Unzip　（解壓縮）發布包．做這些的命令看起來象　

unzip　-aU　jade1_1.zip
Jade　不是用　GNU　Autoconf　制作的，所以你需要自己編輯　Makefile。因為　James　Clark　把他的工具做得很容易處理這些事情，所以你最好在　Jade　發布的主目錄下建立一個制作目錄（也許用你的機器的體系命名），把主目錄的　Makefile　拷貝到這個位置，在這裡編輯之，然在該目錄下運行　make。　
不過，可以不編輯　Makefile．在主目錄裡有一個文件名為　Makefile.jade，其作用是制作　Jade（相對只是制作　Jade　倚賴的　SGML　分析器工具　SP）時可以用　make　-f　Makefile.jade．不過我們建議不要這樣做，因為這樣你需要修改比　Makefile.jade　裡更多的東西，所以不管怎樣你都要編輯其中之一（譯注：Makefile　Makefile.jade）。　

編輯　Makefile，閱讀　James　的指導並且修改你需要修改的地方．有許多變量需要設置．下面是最重要的一些，以及它們的典型的值：　

prefix　=　/usr/local
XDEFINES　=　-DSGML_CATALOG_FILES_DEFAULT=\"/usr/local/share/sgml/catalog\"
XLIBS　=　-lm
RANLIB　=　ranlib
srcdir　=　..
XLIBDIRS　=　grove　spgrove　style
XPROGDIRS　=　jade
注意　SGML　支持文件缺省路徑的聲明－－你可能需要針對你自己的安裝做一些改動．如果你的系統不需要上面那些關數學庫和　ranlib　命令的設置，僅僅把它們留在　Makefile　裡．　
鍵入　make　制作　Jade　和各種各樣　SP　工具．　

一旦完成軟件的制作，make　install　將完成安裝．

安裝　DocBook　DTD　工具
安裝　DocBookDTD　工具　
你需要把制作　DocBookDTD　工具的文件放到你制作　Jade　的目錄裡，如果你按照我們上面建議的話，應該是　/usr/local/share/sgml/。除了　DocBook　文件以外，你還需要有一個就位的　catalog　文件，用文檔類型聲明和該目錄裡實際文件的外部實體參考．你還要有　ISO字符集映射以及可能還需要一個或更多個版本的HTML．
　　
安裝多種多樣的　DTD　和支持文件的一種方法是設置　catalog　文件，就是收集所有的文件到上面提到的目錄裡，用一個叫　CATALOG　的文件描述所有這些文件，然創建文件　catalog　作為指向前者的目錄指針　－－　往裡面輸入下面一行內容：　
CATALOG　/usr/local/share/sgml/CATALOG
文件　CATALOG　應該包含三種類型的行．第一種是（可選的）SGML　聲明，這樣：　
SGMLDECL　docbook.dcl
下一步，必須解釋各種各樣的　DTD　的參考和實體文件．對　DocBook　文件，這些看起來象下面幾行：　
PUBLIC　"-//Davenport//DTD　DocBook　V3.0//EN"　docbook.dtd
PUBLIC　"-//USA-DOD//DTD　Table　Model　951010//EN"　cals-tbl.dtd
PUBLIC　"-//Davenport//ELEMENTS　DocBook　Information　Pool　V3.0//EN"　dbpool.mod
PUBLIC　"-//Davenport//ELEMENTS　DocBook　Document　Hierarchy　V3.0//EN"　dbhier.mod
PUBLIC　"-//Davenport//ENTITIES　DocBook　Additional　General　Entities　V3.0//EN"　dbgenent.mod
當然，一個包含這些的文件和　DocBook工具一起發布．注意這些行的最一項都是文件名，這裡給出的沒有路徑．你可以把這些文件放到你的　SGML　目錄的子目錄裡，當然還要修改　CATALOG　文件裡的引用．DocBook　還引用了　ISO字符集實體，所以你還要獲取和安裝這些東西（它們可以通過幾種不同途徑獲取，並且可以在上面列出的　URL　裡很容易的找到），以及所有這些東西的目錄實體，類似：　
PUBLIC　"ISO　8879-1986//ENTITIES　Added　Latin　1//EN"　ISO/ISOlat1
注意這裡文件名是如何包含一個目錄名的，這裡顯示了我們把　ISO　實體文件放到了一個名為　ISO　的子目錄．同樣，正確的目錄入口應該對應你獲取的工具實體．
安裝　Norman　Walsh　的　DSSSL　風格表
安裝　Norman　Walsh　的　DSSSL　風格表　
閱讀上面　URL　列出的安裝指導．　
安裝　Norman　的風格表，只需要在合適的位置簡單的解壓縮發布的工具．一個處理這些事情的合適的位置是　/usr/local/share，把工具放到在　/usr/local/share/docbook　目錄樹下的目錄裡．處理這些的命令看起來將象　

unzip　-aU　db119.zip
測試安裝成功與否的一個方法是制作　PostgreSQL用戶手冊的HTML　和　RTF　形式．　
　　
制作　HTML　文件，進入　SGML　源文件目錄，doc/src/sgml，鍵入　
jade　-t　sgml　-d　/usr/local/share/docbook/html/docbook.dsl　-D　../graphics　postgres.sgml
book1.htm　是輸出的頂級節點。　
生成　RTF　輸出，為你常用的字處理系統和打印系統做準備，鍵入：　

jade　-t　rtf　-d　/usr/local/share/docbook/print/docbook.dsl　-D　../graphics　postgres.sgml
安裝　PSGML
安裝　PSGML　
閱讀上面　URL　列出的安裝指導．　
解開發布的壓縮文件，運行　configure，make　和　make　install　把　byte-compiled（字節編譯）文件和信息庫就位．

然往你的　/usr/local/share/emacs/site-lisp/site-start.el　文件裡增加下面行讓你的　Emacs　在需要時正確裝載　PSGML：　
(setq　load-path
　　　　　　(cons　"/usr/local/share/emacs/site-lisp/psgml"　load-path))
(autoload　'sgml-mode　"psgml"　"Major　mode　to　edit　SGML　files."　t)
如果你在編輯　HTML　時也需要使用　PSGML，再加一行：　
(setq　auto-mode-alist
　　　　　　(cons　'("\\.s?html?\\'"　.　sgml-mode)　auto-mode-alist))
有一個關　PSGML　的很重要的問題：它的作者假設你的主　SGMLDTD　目錄是　/usr/local/lib/sgml．如果如我們本章例子所說，你用的是　/usr/local/share/sgml，你必須為此做些補償．　
你可以設置　SGML_CATALOG_FILES　環境變量．
你可以定制你的　PSGML　安裝（其手冊告訴你如何做）．　
你甚至可以在編譯和安裝　PSGML　前編輯源文件　psgml.el，把寫死的路徑硬代碼改成你自己的缺省值．

安裝　JadeTeX
如果你需要的話，你還可以安裝　JadeTeX　以便用　TeX　作為　Jade　的格式化端．注意這個軟件還不很成熟，將會生成比你從　RTF　端得到的差得多的打印輸出．不過，它還是工作的很好的，尤其是不用表的簡單文檔，並且　JadeTeX　和風格表都在不斷的改進中，顯然以它會變得更好．　
要安裝和使用JadeTeX，你需要有一個可用的TeX　和LaTeX2e　安裝，包括支持的工具（tools）和圖形（graphics）包，Babel，AMS　字體　和　AMS-LaTeX，PSNFSS　－－"35種字體"　（"the　35　fonts"）的擴展和伴侶工具，用生成　PostScript　的　dvips　程序，宏包　fancyhdr，hyperref，minitoc，url　和　ot2enc，當然還有　JadeTeX　本身．所有這些可以在離你最近的　CTAN　站點找到．　

JadeTeX　到寫作時為止還沒有隨著一些發布帶有安裝向導，但是有一個　makefile　顯示了需要的東西．它還包括一個目錄　cooked，在這裡你會發現一些你需要的宏軟件包，但不是全部，並且也不完整－－至少我們最一次看到的是這樣的．　

在制作　jadetex.fmt　格式文件之前，你可能需要編輯　jadetex.ltx　文件，以便更改　Babel　的配置以適合你的路徑．要修改的行看起來象　

\RequirePackage[german,french,english]{babel}[1997/01/23]
並且很顯然你應該只列出你實際上需要的語言，然把　Babel　配置成那樣．　
在　JadeTeX　能工作，你應該可以用下面命令為PostgreSQL手冊生成和格式化TeX輸出（象上面，在　doc/src/sgml　目錄裡面）　

jade　-t　tex　-d　/usr/local/share/docbook/print/docbook.dsl　-D　../graphics　postgres.sgml
jadetex　postgres.tex
jadetex　postgres.tex
dvips　postgres.dvi
當然，你做這些的時候，TeX會在第二次運行時停下來，並且告訴你超出其容量了．據我們所知，這是由　JadeTeX　生成交叉引用信息造成的．當然　TeX　可以編譯為大的數據結構尺寸．這些的細節問題根據你的安裝不同而異。

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

可選工具集
sgml-tools　v2.x　現在支持　jade　和　DocBook．　

--------------------------------------------------------------------------------

(http://www.fanqiang.com) 進入【UNIX論壇】

相關文章

===更多相關===

★ 樊強制作歡迎分享 ★