J.1. DocBook

Исходный материал документации пишется на языке разметки DocBook, который отдалённо напоминает HTML. Оба эти языка являются приложениями SGML (Standard Generalized Markup Language, Стандартного обобщённого языка разметки), который по сути является языком описания других языков. В следующем описании используется как термин DocBook, так и SGML, но технически они не взаимозаменяемы.

Примечание

Документация PostgreSQL в настоящее время переводится с формата DocBook SGML со стилями DSSSL в формат DocBook XML со стилями XSLT. Убедитесь, что вы читаете инструкции к той версии PostgreSQL, с которой имеете дело, так как процедуры и набор инструментов будут меняться.

Формат DocBook позволяет авторам определять структуру и содержимое технического документа, не заботясь о деталях представления. Как это содержимое будет представлено в различных конечных формах, определяет стиль документа. DocBook поддерживается группой OASIS. На официальном сайте DocBook имеется хорошая вводная и справочная документация, а также полная книга издательства О'Рейли для чтения в электронном виде. Новичкам будет очень полезно руководство NewbieDoc Docbook Guide. Кроме того, в Проекте документации FreeBSD (FreeBSD Documentation Project) так же применяется формат DocBook и даются полезные сведения, включая ряд замечаний по стилю, которые стоит принять во внимание.