DocBook

aus Wikipedia, der freien Enzyklopädie

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) wird dort im Abschnitt Vorteile und Vergleich gegenüber DocBook angestellt.

[Bearbeiten] 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>

[Bearbeiten] Versionen

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

[Bearbeiten] 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, Millin Verlag, ISBN 3-89990-078-2
• Lars Trieloff: DocBook-XML: Einführung und Anwendung, MITP Verlag, ISBN 3-8266-1519-0

[Bearbeiten] Weblinks

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

• OASIS DocBook TC (englisch)
• Norman Walsh über DocBook (englisch)
• Häufig gestellte Fragen (englisch)
• HTML / XHTML / DocBook XML Validator and Transformer (englisch)
• NewbieDoc Docbook Guide (englisch)
• Dokumentationen mit DocBook-XML: Tutorial von Lars Trieloff (deutsch)
• >e-novative> DocBook Environment - "eDE" Einsteiger-Umgebung für Windows