Bücher

(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)

Ein Buch besteht aus verschiedenen Teilen, wobei die wichtigsten wohl Vorwort, Inhaltsverzeichnis, Kapitel, Anhänge, Glossar, Literaturverzeichnis und Indizes sind. Es gibt natürlich darüber hinaus noch weitere Elemente, die wir uns ebenfalls anschauen werden.

DocBook 4

Ein Muster eines Buches in DocBook 4 zeigt das folgende Beispiel.

Beispiel: Aufbau eines Buches in DocBook 4

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<book lang="de">
    <title>Mein erstes Buch in DocBook</title>
    <titleabbrev>Beispielbuch</titleabbrev>
    <bookinfo>
        <author>
            <firstname>Tux</firstname><surname>Pinguin</surname>
        </author>
        <pubdate>2002, 2003</pubdate>
    </bookinfo>
    <dedication>
        <para>Dieses Buch ist J. S. gewidmet.</para>
    </dedication>
    <preface><!-- Das Vorwort --></preface>

    <!-- Eigentlicher Inhalt des Buches -->

    <glossary>
        <!-- ... -->
    </glossary>
    <bibliography>
        <!-- ... -->
    </bibliography>
    <index/>
</book>

Zeile 3: Das Wurzelelement mit der Sprache
Zeile 4: Jedes Buch sollte einen Titel enthalten
Zeile 5: Falls der Titel zu lang ist, kann er mittels titleabbrev abgekürzt werden
Zeile 6: Metainformation zum Buch. In diesem Fall ist der Verfasser genannt und das Veröffentlichungsdatum angegeben.
Zeile 12: Eine Widmung
Zeile 15: Das Vorwort
Zeile 19: Ein Glossar
Zeile 24: Ein Literaturverzeichnis
Zeile 25: Ein Stichwortverzeichnis, genauso wie <toc/> wird es üblicherweise als leeres Element angegeben. Das Publishing-System ersetzt <index/> durch den sortierten Inhalt.

Jedes Buch sollte die Sprache angeben, in der es geschrieben wurde. Dies geschieht über das Attribut lang (siehe Attribut lang).

Ein Buch erlaubt auch ein Element bookinfo, welches beispielsweise Informationen enthält über Autoren, Beteiligte, Verlag, Auflage, Verlagsadressen und ähnliches. Im obigen Beispiel sehen Sie nur zwei mögliche Elemente (author und pubdate).

Die genaue Reihenfolge im Beispiel ist nicht zwingend vorgeschrieben; Sie könnten auch das Inhaltsverzeichnis ans Ende des Buches stellen, falls dies aus irgendwelchen Gründen notwendig sein sollte. Beispielsweise bei einem Roman, bei dem der Leser durch das Inhaltsverzeichnis nicht auf den Inhalt schließen soll.

DocBook 5

Das vorige Beispiel lässt sich ebenso in DocBook 5 abbilden. Sie müssen nur den DocBook-Namensraum einfügen, lang durch xml:lang ersetzen und bookinfo durch das Element info. Die Struktur als solche ist gleich. Eine DOCTYPE-Deklaration ist in DocBook 5 für gewöhnlich nicht vorhanden. Falls doch, dient sie zum Deklarieren von Entities.

Das Inhaltsmodell eines Buches wurde in DocBook 5 durch ein optionales Element acknowledgement (Danksagung) erweitert, das Sie im folgenden Beispiel sehen.

Beispiel: Aufbau eines Buches in DocBook 5 mit einem zusätzlichen acknowledgement

<book
    version="5.0"
    xmlns='http://docbook.org/ns/docbook'
    xml:lang="de">
    <title>Mein erstes Buch in DocBook</title>
    <acknowledgement>
        <!-- ... -->
    </acknowledgement>
    <!-- ... -->
</book> 

Zeile 2: Die DocBook-Version.
Zeile 3: Der DocBook-Namensraum
Zeile 4: Sprache des Buches

Ferner ist in info das Element cover erlaubt:

Beispiel: Deckblätter mit cover

<book>
    <info>
        <cover role="front">
            <para>DocBook-XML</para>
            <para>Medienneutrales und plattformunabhängiges Publizieren</para>
            <mediaobject>
                <imageobject>
                    <imagedata fileref="cover.png"/>
                </imageobject>
            </mediaobject>
        </cover>
        <cover role="back">
            <para>Texte und technische Dokumentationen werden heute...</para>
            <!-- ... -->
        </cover>
    </info>
</book>

Das cover-Element wird für zusätzliches Material verwendet, wie vorderer und hinterer Einband, Buchrücken, Schutzumschlag usw. Da es naturgemäß eine große Bandbreite an Variation gibt, definiert DocBook keine spezielle Semantik dafür. Für diesen Fall ist zweckmäßig, die Stylesheets anzupassen um eigene Wünschen zu berücksichtigen.

Erstellen Sie ein PDF und wird der Einband separat produziert, ist cover für Sie wohl eher uninteressant. In diesem Fall lassen Sie es weg und fügen die PDFs des Buches und der Einbände durch geeignete Programme wie pdftk später zusammen, wenn ein komplettes Buch gewünscht wird.

  

<< zurück vor >>
Tipp der data2type-Redaktion:
Zum Thema DocBook bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © 2009 Millin Verlag
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

Millin Verlag, Siebengebirgsring 36, 53797 Lohmar, info(at)millin.de