DocBook — это описание типа документа (DTD) для языка XML, разработанное для создания документации.
В отличие от LinuxDoc и HTML, DocBook очень сильно ориентирован на разметку, описывающую что это, а не на описание того, как это должно выглядеть.
DocBook позволяет структурировать документ несколькими способами. В Проекте Документирования FreeBSD мы используем два основных типа документа DocBook: книга (book) и статья (article).
Книга организуется в виде глав (<chapter>). Это обязательное условие. Между книгой и главой могут быть части (<part>) для того, чтобы дать дополнительный уровень организации. Руководство организовано именно так.
Глава может содержать (или может не содержать) один или большее количество разделов. Это выделяется элементом <sect1>. Если раздел содержит другой подраздел, то используются элемент <sect2> и так далее, до <sect5>.
В главах и разделах содержится оставшийся текст.
Статья устроена проще, чем книга, в ней не используются главы. Вместо них содержимое статьи организуется в один или большее количество разделов, с использованием те же самые элементы <sect1> (<sect2> и так далее), что используются в книгах.
Очевидно, что вы должны следовать характеру документа, который вы создаете, для решения того, лучше размечать его как книгу или как статью. Статьи хорошо подходят для информации, которую не нужно разбивать дальше на несколько глав, и которая имеет относительно небольшой объем, до 20-25 страниц текста. Книги лучше подходят для информации, которая может разбиваться на несколько глав, возможно, с примечаниями и тому подобным содержимым.
Ссылки на информацию по Docbook (на английском языке):
Домашняя страница Docbook;
http://www.docbook.org/
«DocBook: The Definitive Guide». Можно скачать одним файлом;
http://docbook.org/tdg/en/html/docbook.html
Docbook FAQ;
http://www.dpawson.co.uk/docbook/index.html
DocBook
