pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
目录
Postgres 文档使用 标准通用标记语言 (SGML) DocBook 文档类型定义(DTD)编写。
打包的文档有 HTML 和 Postscript 两种格式。它们作为标准 Postgres 安装的一部分提供。 我们在这里讨论如何使用文档源码以及如何生成文档包。
这是三年来 Postgres 新文档的 第一个发行版。内容和环境都还在变动和演化之中。
SGML 的目的是让作者能够指定文档的结构和内容 (例如使用 DocBook DTD), 并由文档样式定义 这些内容如何被渲染成最终形式 (例如使用 Norm Walsh 的样式表)。
参阅 Introduction to DocBook, 那里有一份不错的 DocBook 特性“快速入门”摘要。 DocBook Elements 为 DocBook 的特性提供了强大的交叉参考。
本文档集使用若干工具构建, 包括 James Clark 的 jade 和 Norm Walsh 的 Modular DocBook Stylesheets。
目前,硬拷贝是通过把 jade 输出的富文本格式(RTF) 导入 ApplixWare 做少量格式修正,然后导出为 Postscript 文件来生成的。
TeX 是 jade 输出的一种受支持格式,但当时未被使用, 原因有几点,包括在提交硬拷贝之前无法做小的格式修正,以及 TeX 样式表对表格的支持普遍不足。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。