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

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

不受支持的版本: 6.3
历史版本PostgreSQL 6.3 已于 2003 年 3 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本手册首页。

附录 A. 文档

Thomas Lockhart

Postgres 文档使用 标准通用标记语言 (SGML) DocBook 文档类型定义(DTD)编写。

打包的文档有 HTML 和 Postscript 两种格式。它们作为标准 Postgres 安装的一部分提供。 我们在这里讨论如何使用文档源码以及如何生成文档包。

注意

这是三年来 Postgres 新文档的 第一个发行版。内容和环境都还在变动和演化之中。

A.1. 引言

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 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。