PostgreSQL 有四种主要的文档格式:
纯文本,用于安装前信息的纯文本格式。
HTML,用于在线浏览和参考。
Postscript,用于打印。
手册页,用于快速参考。
另外,在 PostgreSQL 源码树里面还有许多 README 风格的文件,它们记录了许多与实现有关的东西的文档。
HTML 文档和手册页(man pages)是标准版本的 一部分并且缺省时安装。Postscript 格式的文档可以独立地下载。
文档源文件是用 DocBook 写的, 它是一种标记语言,类似 HTML。 这两种语言都是 Standard Generalized Markup Language, SGML,(标准通用标记语言)的应用, 它实际上是描述另外一种语言的语言。也就是说,术语上 DocBook 和 SGML 都可以用,而技术上是不能互换的。
DocBook 允许作者不用考虑表现细节 地描述一份技术文档的结构和内容。一份文档风格定义该内容 如何呈现为几种最终形式之一。DocBook 是由 OASIS 组维护的。 DocBook 官方站 有很好的介绍和参考手册以及一整本 O'Reilly 的书可供你在线阅读。 Docbook 菜鸟指南 非常适合初学者阅读。 FreeBSD 文档计划 也使用 DocBook 并且有一些很好的信息,包括一些很值得考虑的风格向导。