DocBook

Docbook ist eine XML-Anwendung, die geschaffen wurde, um Bücher, Artikel und insbesonderen technische Dokumentationen zu verfassen.
Die Entwicklung von DocBook begann im Jahr 1991 und hatte ursprünglich den Zweck, den Austausch von Unix-Dokumenationen mittels einer SGML-Anwendung zu erleichtern.
Das eigentliche DocBook besteht aus einer Dokument-Typ-Definition (DTD), mit der ein XML-Vokabular definiert wird. Aufgrund der erwähnten Entwicklung existiert neben der "DocBook XML DTD" auch ein "DocBook DTD" für SGML. Um die DocBook-XML-Dateien in ein Präsentationsformat umwandeln zu können, gibt es unter http://docbook.org/wiki/moin.cgi/DocBookXslStylesheets verschiedene XSL-Stylesheets. Zur Zeit werden XHTML, HTML, XSL-FO (ermöglicht eine weitere Umwandlung, z.B. nach PDF), HTML Help und JavaHelp unterstützt, jedoch ist auch eine Transformation in andere Formate wie VoiceXML denkbar. Um den Einstieg zu erleichtern existieren neben der umfangreichen DTD auch vereinfachte DTD's.

Ähnlich wie in TeX, kann man DocBook-Dokumente sowohl in physische Einheiten (verschiedene Dateien) als auch in logische Einheiten (Buch, Kapitel, Sektionen, Paragraphen, Listen, ...) unterteilen. Desweiteren werden die üblichen Techniken wie zum Beispiel interne und externe Verweise, Fußnoten, Links, das Einbinden von Bildern, das Erstellen von Inhaltsverzeichnissen und Bibliographien unterstützt.
Für das Markup von Programmiersprachen, Betriebssystembegriffen und anderen technischen Begriffen hat man in DocBook besondere Elemente bereitgestellt. Zur Darstellung mathematischer Formeln wird der Einsatz von MathML empfohlen.

Quellenangabe:

• DocBook: The Definitive Guide v2.0.7 von Norman Walsh und Leonard Muellner (auch als Buch erhältlich)
• Docbook Frequently Asked Questions

Beispiel eines DocBook-Dokumentes

<?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "docbook\xml-dtd-4.1.2\docbookx.dtd"> <?xml-stylesheet type="text/xsl" href="C:\Daten\Job\Standards) docbook\docbook\xsl\html\docbook.xsl"?> <book> <bookinfo> <date>20.11.2002</date> <title>Mein erstes Buch</title> <subtitle>Wie alles begann</subtitle> </bookinfo> <toc/> <chapter> <title>Der Anfang</title> <para>Text Text TextText Text Text...</para> <sect1> <title>Kurz darauf</title> <para>Text Text TextText Text Text...</para> </sect1> </chapter> <chapter> <title>Später</title> <sect1> <title>Kurz vorm Ende</title> <para>Text Text TextText Text Text...</para> </sect1> </chapter> <appendix> <title>Hinweise</title> <para>Man sollte folgende Dinge unbedingt beachten:</para> <sect1> <title>Sektion des Anhangs</title> <para>Ein Paragraph...</para> </sect1> </appendix> </book> Dieses XML-Dokument kann man jetzt mittels eines entsprechenden Stylesheets in verschiedene Ausgabeformate umwandeln.