Syntax und Elemente von DocBook

Die zentrale Struktur in DocBook ist das Buch, aber auch ganze Sätze von Büchern, einzelne Artikel, API-Referenzen, UNIX-Manpages und FAQs lassen sich in DocBook schreiben.

Die Elemente der DocBook-DTD lassen sich grob in drei Gruppen aufteilen: Metainformationen, Hierarchie und Information Pool. Auf die drei Gruppen verstreut sind eine Vielzahl von Elementen für das Markup technischer Konzepte. Für eine detailierte Beschreibung der mehr als 300 Elemente von DocBook sei auf [DocBookReference] verwiesen. An dieser Stelle soll ein grober Überblick genügen.

Die DocBook-DTD enthält über 100 Elemente zur Auszeichnung von Metainformationen. Beispiele sind title, author, pubdate, revhistory, contractsponsor, legalnotice und issuenum.

In DocBook 4.2 wurde eine Harmonisierung mit dem Dublin Core Standard vorgenommen. Die Elemente heißen in DocBook teilweise anders, haben aber äquivalente Semantik ([DocBook4.2#DC]).

Fast alle Hierarchie-Elemente können ein info-Element als Kind enthalten, also book enthält bookinfo, section enthält sectioninfo usw. Sie dienen als Container für Metainformationen. Das bedeutet, dass nicht nur das Root-Element Metainformationen haben kann. Wenn beispielsweise ein Kapitel von einem anderen Autor geschrieben wurde, so lässt sich dies kenntlich machen.

Alle Elemente für Metainformationen können auch im bibliography-Abschnitt verwendet werden, um Literaturangaben auszuzeichnen.

Beispiel 8. Metadaten eines Buches


<bookinfo>
<title>User's Guide for the DocBook DTD</title>
<authorgroup>
  <author><firstname>Terry</firstname><surname>Allen</surname></author>
  <author><firstname>Eve</firstname><surname>Maler</surname>
    <affiliation><orgname>Arbortext, Inc.</orgname></affiliation>
  </author>
  <author><firstname>Norman</firstname><surname>Walsh</surname>
    <affiliation><orgname>Arbortext, Inc.</orgname></affiliation>
  </author>
</authorgroup>
<edition>User's Guide version 1.0 for DocBook V3.0</edition>
<pubdate>1997</pubdate>
<copyright>
  <year>1992</year>
  <year>1993</year>
  <year>1994</year>
  <year>1995</year>
  <year>1996</year>
  <year>1997</year>
  <holder>
    Arbortext, Inc., HaL Computer Systems, Inc.,
    Fujitsu Software Corp., and O'Reilly &amp; Associates, Inc.
  </holder>
</copyright>
<legalnotice>
  <para>
    Permission to use, copy, modify and distribute
    the DocBook DTD and its accompanying documentation for any purpose and
    without fee is hereby granted in perpetuity, provided that the above
    copyright notice and this paragraph appear in all copies.
  </para>
</legalnotice>
<legalnotice>
  <para>
    The copyright holders make no representation about the suitability of
    this DTD for any purpose. It is provided
    <quote>as is</quote> without expressed
    or implied warranty.  If you modify the DocBook DTD in any way,
    except for declaring and referencing additional general entities
    and declaring additional notations, identify your DTD as a variant
    of DocBook.
  </para>
</legalnotice>
</bookinfo>