选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

Appendix J. 文档

PostgreSQL有四种主要的文档格式:

  • 纯文本,用于安装前信息

  • HTML,用于在线浏览和参考

  • PDF,用于打印

  • 手册页,用于快速参考。

另外,若干纯文本README文件可以在 PostgreSQL源代码树各处找到,用于说明各种实现方面的问题。

HTML文档和手册页属于标准发行包的一部分,并会默认安装。 PDF 格式的文档可单独下载。

J.1. DocBook #

文档源码使用DocBook编写,这是一种表面上类似于HTML的标记语言。这两种语言都是标准通用标记语言SGML)的应用,后者本质上是一种描述其他语言的语言。下文会同时使用 DocBook 和SGML这两个术语,但从技术上讲,它们不能互换。

Note

PostgreSQL 文档目前正在从 DocBook SGML 和 DSSSL 样式表迁移到 DocBook XML 和 XSLT 样式表。请注意查看与你正在处理的 PostgreSQL 版本相关的说明,因为操作步骤和所需工具会发生变化。

DocBook允许作者指定技术文档的结构和内容,而无需操心展示细节。 文档样式定义这些内容如何被渲染成若干最终形式之一。DocBook 由 OASIS group维护。 官方 DocBook 站点提供了很好的入门和参考文档,以及一本可供在线阅读的完整 O'Reilly 图书。NewbieDoc Docbook Guide对初学者非常有帮助。 FreeBSD Documentation Project也使用 DocBook,并提供了一些很有价值的信息, 其中包括若干值得参考的风格指南。