DocBook

DocBook ist ein Dokumentenformat, das in einer für SGML und XML vorliegenden Dokumenttypdefinition (DTD) festgelegt ist. Es eignet sich besonders zur Erstellung von Büchern, Artikeln und Dokumentationen im technischen Umfeld (Hardware oder Software). DocBook ist ein offener Standard, der von der Organization for the Advancement of Structured Information Standards (OASIS) gepflegt wird.

Am weitesten verbreitet ist die Verwendung von DocBook bei Open-Source-Projekten. So verwendet das Linux Documentation Project die DTD zum Erstellen der Howtos. KDE und GNOME/GTK+ verwenden es als grundlegendes Format für alle API-Dokumentationen sowie Benutzerhandbücher der Anwendungsprogramme.

Ein Vergleich zwischen DocBook und der für ähnliche Zwecke vorgesehenen Darwin Information Typing Architecture (DITA) findet sich dort im Abschnitt Vorteile und Vergleich gegenüber DocBook.

Beispiel-Code

<book id="einfaches_buch">
    <title>Ein sehr einfaches Buch</title>
    <chapter id="einfaches_kapitel">
        <title>Kapitel</title>
        <para>Hallo Welt!</para>
    </chapter>
</book>

Versionen

Die aktuelle Version ist DocBook V5.0 vom 12. August 2008. Der Hauptunterschied von 5.0 zu früheren 4.x Version ist, dass ein Docbook-Element unabhängig von seiner Position im Dokument den gleichen Inhalt hat. Version 5.0 ist nicht kompatibel mit früheren Versionen.

Literatur

• Norman Walsh: DocBook: The Definitive Guide. O’Reilly Associates, ISBN 1-56592-580-7
• Bob Stayton: DocBook XSL: The Complete Guide. Sagehill Enterprises, ISBN 0-9741521-1-0
• Joe Brockmeier: DocBook Publishing – A Better Way to Create Professional Documents, Prima Tech’s Linux Series, ISBN 0-7615-3331-1
• Thomas Schraitle: DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren. 2. Auflage. Millin Verlag, ISBN 978-3-938626-14-6, komplett online
• Lars Trieloff: DocBook-XML: Einführung und Anwendung. (Memento vom 26. Juni 2008 im Internet Archive) MITP Verlag, ISBN 3-8266-1519-0

Weblinks

Wikibooks: DocBook in „XML: Managing Data Exchange“ (englisch) – Lern- und Lehrmaterialien

• OASIS DocBook TC (englisch)
• Norman Walsh über DocBook (englisch)
• NewbieDoc Docbook Guide (englisch)
• komplettes Buch über Docbook online (deutsch)