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