Какой программой открыть файлы .docbook (DocBook)

DocBook это отличным форматом для любой документации… пока вы не попытаетесь её прочитать. На самом деле, файлы .docbook и не предназначены для чтения — они предназначены для конвертации в HTML, man, PDF, DOCX, ODT, EPUB, FictionBook2 и во многие другие.

Что такое DocBook?

DocBook — это стандарт на основе XML, который используется во многих современных задачах документации. Если вы хотите создать источник документа DocBook, вы пишете файлы XML, которые описывают макет документа, разделение на абзацы и другие атрибуты. Структура файла XML может показаться вам знакомой, если вы уже видели HTML-код раньше. XML имеет тенденцию быть улучшением по сравнению со старой спецификацией HTML и может использоваться для создания полных веб-страниц и других документов разметки.

Каковы преимущества DocBook?

DocBook — это стандарт OASIS и формат, в котором большинство проектов с открытым исходным кодом хранят свою документацию. Docbook разработан как приложение с открытым исходным кодом. Проект размещён на SourceForge и доступен под лицензией GPL. DocBook доступен как определение типа документа (DTD) и XML-схема (XSD). У проекта есть большое сообщество разработчиков и техподдержки, охватывающее как группы с открытым исходным кодом, так и коммерческие группы.

Наиболее важные причины, по которым в проектах используется DocBook:

• DocBook — это стандарт
• DocBook с открытым исходным кодом
• DocBook используется в большинстве крупных проектов
• DocBook имеет большое сообщество разработчиков и техподдержки.

DocBook также является приложением XML, а технологии XML решают ряд проблем публикации для групп документации, в том числе:

• Единый исходник
• Совместная разработка
• Кросс-платформенное редактирование
• Многоканальная публикация
• Повышение качества и согласованности информации
• Расширение функциональности электронного вывода
• Отказ от привязки к поставщику

Если вы уже разбираетесь в XML, тогда вы можете начать изучать DocBook. Если вы не понимаете XML, хорошая новость заключается в том, что изучение DocBook поможет вам изучить XML. Ниже приведены две книги, которые необходимо прочитать всем, кто только начинает работать с DocBook.

DocBook - The Definitive Guide http://www.docbook.org/tdg/en/html/docbook.html

DocBook XSL – The Complete Guide http://www.sagehill.net/docbookxsl/index.html

Но я думаю вы попали на эту статью в первую очередь для того, чтобы открыть файл DocBook. Ну или хотя бы конвертировать.

DocBook в Writer (LibreOffice)

Если вам нужно просто быстро открыть файл .docbook, то вам даже не нужно устанавливать дополнительные программы если у вас уже есть LibreOffice. Редактор Writer умеет открывать файлы .docbook. Но я настоятельно не рекомендую этот варианта, поскольку по каким-то причинам Writer пропускает совершенно случайные фрагменты текста, никак не обозначая это. В открывшемся файле может быть пропущено около 10%! Используйте это только как крайний вариант.

Как конвертировать DocBook в PDF

Далее мы будем рассматривать универсальную программу, которая умеет конвертировать во множество форматов, в том числе и в PDF. Но если вам нужен именно PDF, то я настоятельно рекомендую dblatex (DocBook to LaTeX Publishing), которая может конвертировать DocBook (XML и SGML) в DVI, PDF, PostScript используя latex. Дело в том, что dblatex делает самые красивые PDF! Эти PDF файлы включают оглавление и другие элементы, которые в универсальной программе просто пропущены.

Установите пакет dblatex.

За затем просто запустите команду вида:

dblatex ФАЙЛ.docbook

В этой же папке будет создан ФАЙЛ.pdf.

Pandoc — универсальный конвертер документов

Если вам нужно конвертировать файлы из одного формата разметки в другой, pandoc — ваш швейцарский армейский нож. Pandoc может конвертировать между большим числом форматов, их полный перечень вы найдёте на сайте программы: https://pandoc.org/

Установите пакет pandoc.

Затем выполните одну из команд следующего вида:

pandoc --from docbook --to docx --output myDocbook.docx myDocbook.xml

pandoc --from docbook --to odt --output myDocbook.odt myDocbook.xml

pandoc --from docbook --to latex --output myDocbook.pdf myDocbook.xml

pandoc --from docbook --to epub3 --output myDocbook.epub myDocbook.xml

pandoc --from docbook --to markdown --output myDocbook.md myDocbook.xml

pandoc --from docbook --to html --output myDocbook.html myDocbook.xml

Как вы могли уже понять:

• --from — это исходный формат
• --to — формат, в который нужно конвертировать
• --output — имя файла для нового формата
• myDocbook.xml — исходный документ DocBook.

Всё очень просто. Но для PDF я рекоменду dblatex!

Другие программы для конвертации DocBook

Есть ещё несколько приложений, которые могут вам пригодиться, если вы хотите преобразовать файл DocBook в другой формат.

• kdoctools — генерация документации из docbook.
• poxml — Переводит XML-файлы DocBook используя po-файлы gettext
• docbook2x — пакет программ, преобразующих документы DocBook в традиционный формат страниц руководства Unix и формат GNU Texinfo.
• docbook-to-man — пакетный конвертер из DocBook SGML в макросы nroff/troff man.