DocBook

DocBook — мова розмітки для технічної документації, що є розвитком SGML та XML. Спочатку вона призначалася для автоматизації створення технічних документів під апаратне і програмне забезпечення комп'ютерів, але вона може бути використана для будь-якого іншого роду документації.

Поточна версія DocBook V5.0, прийнята у листопаді 2009, є офіційним стандартом OASIS.

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

На відміну від HTML-документа, DocBook-документ не розглядається як кінцевий формат, тому, наприклад, один документ в цьому форматі після перетворення може виглядати і як один великий документ з складною структурою, і як набір невеликих простих документів-розділів.

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

Приклад

<book id="simple_book">

  <title>Very simple book</title>

  <chapter id="chapter_1">
    <title>Chapter 1</title>
    <para>Hello world!</para>
    <para>I hope that your day is proceeding splendidly!</para>
  </chapter>

  <chapter 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 і DEC)
• 1994—1998: Davenport Group (+ великий вплив Novell і Sun)
• 1998—2007: OASIS. DocBook XML v4.5
• 2001-2009: DocBook XML v5.0

Посилання

• DocBook.org [Архівовано 28 квітня 2022 у Wayback Machine.](англ.)
• wiki.DocBook.org [Архівовано 31 березня 2022 у Wayback Machine.](англ.)
• DocBook.ru [Архівовано 2 квітня 2022 у Wayback Machine.](рос.)
• Російська документація по DocBook [Архівовано 28 вересня 2007 у Wayback Machine.]
• Сергей Бердачук. Eclipse RCP. [Архівовано 9 травня 2008 у Wayback Machine.] Глава 1.4 «Использование DocBook для написания документации» [Архівовано 9 травня 2008 у Wayback Machine.](рос.)
• Внедрение DocBook: практический опыт(рос.)
• techwriters.ru -- форум технічних документалістів [Архівовано 30 січня 2019 у Wayback Machine.]
• MoinMoin + DocBook
• Мировое зло vs. XML в белых одеждах(рос.)