DocBook Überblick

DocBook ist eine Document Type Definition (DTD), die in den Formaten SGML und XML vorliegt und frei verfügbar ist. DocBook eignet sich besonders für technische Dokumentationen und kann in verschiedenen Formaten ausgegeben werden. Dadurch wird die Dokumentation nur einmal geschrieben und kann mehrfach publiziert werden ("single sourcing").

In den folgenden Beispielen beschränke ich mich auf das XML Format von DocBook.

Beispiel Artikel

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE book SYSTEM "file:///C:/docbook/dtd/docbookx.dtd">
<article>
 <title>My first article</title>
 <articleinfo>
     <author>
       <honorific>Dipl.-Ing</honorific>
       <firstname>Ulrich</firstname>
       <surname>Kulle</surname>
     </author>
 </articleinfo>
 <para>This is a simple article. This term
     <indexterm>
       <primary>term</primary>
     </indexterm>
         shall appear in the index.</para>
 <appendix>
     <title>Appendix 1</title>
     <para>This is an appendix.</para>
 </appendix>
 <glossary>
     <glossdiv>
       <title>A glossary</title>
       <glossentry>
         <glossterm id="DocBook">DocBook</glossterm>
         <glosssee>DocBook is a standard for the development ... </glosssee>
       </glossentry>
     </glossdiv>
 </glossary>
</article>