DocBook

DocBook

Тип формата	язык разметки
Стандарт(ы)	[www.oasis-open.org/docbook/specs/docbook-4.5-spec-cs-03.html 4.5 (June 2006)], [docs.oasis-open.org/docbook/specs/docbook-5.0-spec.html 5.0 (November 2009)]

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

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

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

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

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

Пример

 <?xml version="1.0" encoding="UTF-8"?>
 <book xml:id="simple_book" xmlns="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

См. также

• TEI
• FictionBook

Ссылки

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

• Русская [lib.custis.ru/SGML_Docbook документация] по DocBook

• Сергей Бердачук. [www.berdaflex.com/ru/eclipse/books/rcp_filemanager/index.html Eclipse RCP.] Глава 1.4 [www.berdaflex.com/ru/eclipse/books/rcp_filemanager/ch01s04.html «Использование DocBook для написания документации»]

• [www.techwriters.ru/ techwriters.ru — форум технических писателей]
• [moinmoin.wikiwikiweb.de/DocBook MoinMoin + DocBook]
• [old.computerra.ru/2005/578/206770/ Мировое зло vs. XML в белых одеждах]
• О стандарте и практике применения DocBook на форуме [forum.singlesourcing.ru/ "Технология единого источника в технической документации"]

Отрывок, характеризующий DocBook

– Вот он… наш то… Друг мой, Коля… Переменился! Нет свечей! Чаю!
– Да меня то поцелуй!
– Душенька… а меня то.
Соня, Наташа, Петя, Анна Михайловна, Вера, старый граф, обнимали его; и люди и горничные, наполнив комнаты, приговаривали и ахали.
Петя повис на его ногах. – А меня то! – кричал он. Наташа, после того, как она, пригнув его к себе, расцеловала всё его лицо, отскочила от него и держась за полу его венгерки, прыгала как коза всё на одном месте и пронзительно визжала.
Со всех сторон были блестящие слезами радости, любящие глаза, со всех сторон были губы, искавшие поцелуя.
Соня красная, как кумач, тоже держалась за его руку и вся сияла в блаженном взгляде, устремленном в его глаза, которых она ждала. Соне минуло уже 16 лет, и она была очень красива, особенно в эту минуту счастливого, восторженного оживления. Она смотрела на него, не спуская глаз, улыбаясь и задерживая дыхание. Он благодарно взглянул на нее; но всё еще ждал и искал кого то. Старая графиня еще не выходила. И вот послышались шаги в дверях. Шаги такие быстрые, что это не могли быть шаги его матери.
Но это была она в новом, незнакомом еще ему, сшитом без него платье. Все оставили его, и он побежал к ней. Когда они сошлись, она упала на его грудь рыдая. Она не могла поднять лица и только прижимала его к холодным снуркам его венгерки. Денисов, никем не замеченный, войдя в комнату, стоял тут же и, глядя на них, тер себе глаза.
– Василий Денисов, друг вашего сына, – сказал он, рекомендуясь графу, вопросительно смотревшему на него.
– Милости прошу. Знаю, знаю, – сказал граф, целуя и обнимая Денисова. – Николушка писал… Наташа, Вера, вот он Денисов.
Те же счастливые, восторженные лица обратились на мохнатую фигуру Денисова и окружили его.
– Голубчик, Денисов! – визгнула Наташа, не помнившая себя от восторга, подскочила к нему, обняла и поцеловала его. Все смутились поступком Наташи. Денисов тоже покраснел, но улыбнулся и взяв руку Наташи, поцеловал ее.
Денисова отвели в приготовленную для него комнату, а Ростовы все собрались в диванную около Николушки.
Старая графиня, не выпуская его руки, которую она всякую минуту целовала, сидела с ним рядом; остальные, столпившись вокруг них, ловили каждое его движенье, слово, взгляд, и не спускали с него восторженно влюбленных глаз. Брат и сестры спорили и перехватывали места друг у друга поближе к нему, и дрались за то, кому принести ему чай, платок, трубку.
Ростов был очень счастлив любовью, которую ему выказывали; но первая минута его встречи была так блаженна, что теперешнего его счастия ему казалось мало, и он всё ждал чего то еще, и еще, и еще.
На другое утро приезжие спали с дороги до 10 го часа.