目录
PostgreSQL有四种主要的文档格式:
纯文本,用于安装前信息
HTML,用于在线浏览和参考
PDF,用于打印
手册页,用于快速参考。
另外,若干纯文本README文件可以在 PostgreSQL源代码树各处找到,用于说明各种实现方面的问题。
HTML文档和手册页属于标准发行包的一部分,并会默认安装。 PDF 格式的文档可单独下载。
文档源码使用DocBook编写,这是一种表面上类似于HTML的标记语言。这两种语言都是标准通用标记语言(SGML)的应用,后者本质上是一种描述其他语言的语言。下文会同时使用 DocBook 和SGML这两个术语,但从技术上讲,它们不能互换。
PostgreSQL 文档目前正在从 DocBook SGML 和 DSSSL 样式表迁移到 DocBook XML 和 XSLT 样式表。请注意查看与你正在处理的 PostgreSQL 版本相关的说明,因为操作步骤和所需工具会发生变化。
DocBook允许作者指定技术文档的结构和内容,而无需操心展示细节。 文档样式定义这些内容如何被渲染成若干最终形式之一。DocBook 由 OASIS group维护。 官方 DocBook 站点提供了很好的入门和参考文档,以及一本可供在线阅读的完整 O'Reilly 图书。NewbieDoc Docbook Guide对初学者非常有帮助。 FreeBSD Documentation Project也使用 DocBook,并提供了一些很有价值的信息, 其中包括若干值得参考的风格指南。