Kapitel 4. DocBook für Dokumentationen und Anderes

Dokumentationen mit DocBook-XML

Kapitel 4. DocBook für Dokumentationen und Anderes

DocBook ganz einfach

Die Simplified DocBook DTD

Für viele Benutzer, die mit DocBook arbeiten wollen ist die Fülle an Elementen und möglichen Konstrukten verwirend. Deshalb kamen öfter Vorschläge auf, DocBook zu vereinfachen. Seit 2002 gibt es eine offizielle Version von Simplified DocBook.

Anmerkung

Seit 2002 gibt es eine offizielle Vereinfachung von DocBook

Diese Version von DocBook wurde nach folgenden Richtlinien erstellt:

  • Dokumente, die in Simplified DocBook geschrieben werden müssen gültige DocBook-Dokumente sein

  • Mit Simplified DocBook kann man nur einzelne Dokumente erstellen, also ist nur article relevant

  • Es soll sich um die minimale Untermenge von Elementen handeln, so dass von einer Gruppe ähnlicher Elemente nur eines ausgewählt wird.

  • Dokumente sollen sich in XML-fähigen Webbrowsern darstellen lassen.

Die Simplified DocBook DTD hat 106 Elemente und 525 Entities. Sie wird mit dem Public Identifier „-//OASIS//DTD Simplified DocBook XML V4.1.2.5//EN“ und dem System Identifier „http://www.oasis-open.org/docbook/xml/simple/4.1.2.5/sdocbook.dtd“ angesprochen. Die DTD und eine Liste der erlaubten Elemente kann bei Oasis eingesehen werden. Weiterhin gibt es eine Version von DocBook - The Definite Guide speziell für Simplified DocBook.

Beispiel 4.1. Ein Simplified DocBook-Dokument

<!DOCTYPE article PUBLIC "-//OASIS//DTD Simplified DocBook XML V4.1.2.5//EN"
 "http://www.oasis-open.org/docbook/xml/simple/4.1.2.5/sdocbook.dtd"
<article>
 <title>Simpified DocBook ...</title>
 <para>... ist ganz einfach.</para>
</article>