DocBook XML
是一种用于创建文档的基于 XML 的文档类型。
DocBook 和 PostgreSQL
从 6.3 版本(提交 c8cfb0ce)开始,PostgreSQL 就以 DocBook 格式提供文档。多年来,它一直以 SGML 格式维护,但在 PostgreSQL 11(提交 3c49c6fa)中转换为 XML,尽管出于连续性原因,文件名保留了 .sgml
扩展名。此更改极大地简化了文档构建过程。
源代码
文档源文件包含在 doc/src/sgml/ 目录中。
构建文档
如果安装了所需的工具链,则在已配置的源树中构建 HTML 文档只需在 doc/ 目录中执行 make
即可。在一台配置合理的机器上,构建 HTML 文件应该不到一分钟。
要将文档生成 PDF 文件,请从 doc/src/sgml/ 目录执行以下命令之一:
make postgres-A4.pdf
或者对于非标准的美国字母格式:
make postgres-US.pdf
有用链接
- DocBook.org
- DocBook - 维基百科文章