ZaLinux.ru

Какой программой открыть файлы .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.

Рекомендуемые статьи:

Оставить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *