↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本PostgreSQL 10 已于 2022 年 11 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

附录 J. 文档

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

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

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

  • PDF,用于打印

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

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

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

J.1. DocBook #

文档源码使用 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,并提供了一些很有价值的信息,其中包括若干值得参考的风格指南。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。