Что такое DocBook

DocBook — это передовая технология подготовки документации.

Наиболее типичное применение DocBook — автоматическая генерация онлайновой (в формате HTML) и печатной (в формате PDF) документации из единого исходного документа. Исходный документ DocBook представляет собой XML-файл, схема которого стандартизована.

Хотя первоначально DocBook разрабатывался исходя из нужд написания технической документации, он вполне универсален и используется для самых разных целей, например для разработки веб-сайтов и создания презентаций.

DocBook является стандартом де-факто для документации на свободно распространяемое программное обеспечение. Его используют ведущие IT-компании и организации: IBM, Microsoft, Hewlett-Packard, Sun, Novell, WWW Consortium.

Использование DocBook дает наибольший эффект в следующих ситуациях:

  • когда объем документации велик

  • когда в документацию постоянно приходится вносить изменения

  • когда над документацией работает коллектив

  • когда документация включает в себя четко структурированные составляющие

  • когда необходимо строго выдерживать оформление множества документов

  • когда документацию требуется выпускать в различных форматах

  • когда требуется выпускать разные версии документации с отличающимся содержимым

В то же время DocBook не является наглядным средством (хотя графические редакторы для него имеются) и требует усилий для освоения и для развертывания инструментария. Поэтому его не стоит использовать для текущей переписки или для небольших по объему документов.

DocBook поддерживает 45 языков, включая русский.



Powered by DocBook Website
На главнуюОбратная
связь