Appendix B. 文件

Table of Contents
B.1. DocBook
B.2. 工具集
B.3. 制作文件
B.4. 文件寫作
B.5. 風格指導

PostgreSQL 有四種主要的文件格式:

另外,在 PostgreSQL 源碼樹裡面還有許多 README 風格的文件,它們記錄了許多與實現有關的東西的文件.

文件組織成了幾本"書(book)"

上面五本書都有 HTML 和 Postscript 格式的. 參考手冊 包含參考手冊的內容,同時也是 手冊頁的內容.

HTML 文件和手冊頁(man pages)是標準版本的 一部分並且預設時安裝.Postscript 格式的文件可以獨立地下載.

B.1. DocBook

文件源文件是用 DocBook 寫的, 它是一種標記語言,類似 HTML. 這兩種語言都是 Standard Generalized Markup LanguageSGML, (標準通用標記語言)的應用, 它實際上是描述另外一種語言的語言.也就是說,術語上 DocBook 和 SGML 都可以用,而技術上是不能互換的.

DocBook 允許作者不用考慮表現細節 地描述一份技術文件的結構和內容.一份文件風格定義該內容 如何餘現為幾種最終形式之一.DocBook 是由 OASIS 組維護的. DocBook 官方站 有很好的介紹和參考手冊以及一整本 O'Reilly 的書可供你線上閱讀. FreeBSD 文件計劃也使用 DocBook 並且有一些很好的 資訊,包括一些很值得考慮的風格向導.