Kapitel 4. DocBook für Dokumentationen und Anderes

Inhaltsverzeichnis

DocBook ganz einfach
Webseiten erstellen mit DocBook
Definition der Navigationsstruktur
Erstellung der Seiten
Umwandlung in HTML
Präsentationen erstellen mit DocBook
Ausgabeformate für Präsentationen
Formeln einbinden in DocBook
MathML
Weitere Module
DocBook anpassen und erweitern
DTD anpassen und erweitern
XSL-Stylesheets anpassen und erweitern

DocBook ganz einfach

Die Simplified DocBook DTD

Seit 2002 gibt es eine offizielle Vereinfachung von DocBook

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.

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>