DocBook

DocBook
Последний выпуск	5.1 (22.11.2016)
Тип формата	язык разметки
Стандарт(ы)	4.5 (June 2006), 5.0 (November 2009), 5.1 (November 2016)

DocBook — подмножество языка разметки SGML или XML (проще говоря — популярный набор тегов), предназначенное для разметки документов, такое же, как HTML для разметки веб-документов.

Текущая версия DocBook V5.1 — официальный стандарт OASIS.

Преобразованием DocBook-документа в форматы, доступные для печатного или просто визуального представления (в том числе PDF, HTML, man-страницы) занимаются различные утилиты, обычно осуществляющие такое преобразование на основе настраиваемых шаблонов, или «таблиц стилей» (DSSSL или XSL), то есть происходит настоящая изоляция структуры документа от визуального представления.

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

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

Пример

 <?xml version="1.0" encoding="UTF-8"?>
 <book xml:id="simple_book" xmlns="http://docbook.org/ns/docbook" version="5.0">
   <title>Very simple book</title>
   <chapter xml:id="chapter_1">
     <title>Chapter 1</title>
     <para>Hello world!</para>
     <para>I hope that your day is proceeding <emphasis>splendidly</emphasis>!</para>
   </chapter>
   <chapter xml:id="chapter_2">
     <title>Chapter 2</title>
     <para>Hello again, world!</para>
   </chapter>
 </book>

История

Разработка DocBook началась в 1991 году и, в разное время, развивалась и поддерживалась различными организациями:

• 1991—1994: HaL Computer Systems и O’Reilly & Associates (+большое влияние Novell и Digital)
• 1994—1998: Davenport Group (+ большое влияние Novell и Sun)
• 1998—2007: OASIS. DocBook XML v4.5
• 2 Aug 2008: OASIS. DocBook XML v5.0
• 22 Nov 2016: OASIS. DocBook XML v5.1

См. также

• TEI
• FictionBook

Ссылки

• DocBook.org ^(англ.)
• wiki.DocBook.org ^(англ.)

• Русская документация по DocBook

• Сергей Бердачук. Eclipse RCP. Глава 1.4 «Использование DocBook для написания документации»

• techwriters.ru — форум технических писателей
• MoinMoin + DocBook
• О стандарте и практике применения DocBook в блоге "Технология единого источника в технической документации" Архивная копия от 6 марта 2018 на Wayback Machine