DocBook — это передовая технология подготовки документации.
Наиболее типичное применение DocBook — автоматическая генерация онлайновой (в формате HTML) и печатной (в формате PDF) документации из единого исходного документа. Исходный документ DocBook представляет собой XML-файл, схема которого стандартизована.
Хотя первоначально DocBook разрабатывался исходя из нужд написания технической документации, он вполне универсален и используется для самых разных целей, например для разработки веб-сайтов и создания презентаций.
DocBook является стандартом де-факто для документации на свободно распространяемое программное обеспечение. Его используют ведущие IT-компании и организации: IBM, Microsoft, Hewlett-Packard, Sun, Novell, WWW Consortium.
Использование DocBook дает наибольший эффект в следующих ситуациях:
когда объем документации велик
когда в документацию постоянно приходится вносить изменения
когда над документацией работает коллектив
когда документация включает в себя четко структурированные составляющие
когда необходимо строго выдерживать оформление множества документов
когда документацию требуется выпускать в различных форматах
когда требуется выпускать разные версии документации с отличающимся содержимым
В то же время DocBook не является наглядным средством (хотя графические редакторы для него имеются) и требует усилий для освоения и для развертывания инструментария. Поэтому его не стоит использовать для текущей переписки или для небольших по объему документов.
DocBook поддерживает 45 языков, включая русский.
По отношению к традиционным средствам подготовки документации — текстовым процессорам (например Microsoft Word), настольным издательским системам (например Adobe PageMaker) и языкам разметки (nroff, TeX, HTML) — DocBook обладает следующими преимуществами:
Возможность генерации документов в разном формате (онлайновых, печатных, help-файлов и т.д.) из единого исходного текста.
Авторам не приходится заботиться об оформлении — стиль верстки выходных документов задается программно.
Поддержка коллективной работы над документацией, возможность повторного использования документов.
Возможность создавать собственные расширения и разрабатывать на основе DocBook специализированные приложения.
Технологическая основа DocBook — языки разметки SGML (Standard Generalized Markup Language) и XML (eXtensible Markup Language). Исторически DocBook начинал разрабатываться как SGML-приложение, в настоящее время более популярной является XML-версия.
DocBook является по-настоящему открытым стандартом: вы не должны платить кому-либо за то чтобы им пользоваться, вы можете встраивать его в свои приложения и модифицировать его по своему усмотрению.
Программное обеспечение, составляющее инструментарий DocBook, достигло того уровня зрелости, которое позволяет использовать его в серьезных проектах. Основная часть инструментария доступна бесплатно на всех основных платформах, включая Windows, Linux, Mac.