Abschnitte

Die Schichtung von Abschnitten kann explizit und implizit erfolgen

Bei längeren Kapitel bietet es sich an, die Kapitel in Abschnitte und Unterabschnitte aufzuteilen. Diese Unterabschnitte werden dann auch im Inhaltsverzeichnis aufgeführt. Für DocBook gibt es im wesentlichen zwei Varianten, Kapitel in Abschnitte aufzuteilen, die explizite Nennung der Schichtungsebene und die implizite Schichtung.

Bei der expliziten Schichtung fügen Sie in ein Kapitel das Element sect1, für Abschnitt erster Ebene ein. Wenn Sie diesen Abschnitt wiederum unterteilen möchten, fügen Sie sect2 ein, dann sect3 und so weiter bis sect5. Diese Variante hat den Vorteil, dass man beim Schreiben des Dokuments immer bestimmen kann, in welcher Gliederungsebene man sich gerade befindet. Der Nachteil besteht darin, dass man fünf verschiedene Elemente benutzen muss, die im Wesentlichen alle das gleiche bedeuten. Ein weiterer Nachteil ist, dass man auf fünf Gliederungsebenen beschränkt bleibt.

Die implizite Schichtung hingegen braucht nur ein Element, section. Dieses kann beliebig oft ineinander geschachtelt werden, jedoch werden zu stark fragmentierte Dokumente oft unlesbar. In den folgenden Erläuterung werde ich nur auf section eingehen, aber es ist klar, dass alles auch für sect1 bis sect5 gilt.

Abschnitte sind Kapiteln sehr ähnlich

Vom Inhaltsmodell entspricht section dem eines Kapitels. Abschnitte müssen einen Titel haben, oder einen title innerhalb von sectioninfo. Nach dem Titel können Navigationskomponenten wie Inhaltsverzeichnisse, Beispielverzeichnisse sowie glossary und bibliography auftauchen. Danach kommt dann der eigentliche Inhalt des Abschnitts, also Absätze, Tabellen, Grafiken und Beispiele. Und am Ende des Abschnittes können die bekannten Navigationskomponenten wieder auftauchen.

Wenn Sie eine section einfügen möchten, egal ob sie ein Kapitel oder in eine andere section, ist folgendes zu beachten: Vor dem Beginn des Abschnitts kann Fließtext, z.B. Absätze stehen. Im Abschnitt ebenfalls, aber nach dem Ende des Abschnitts können nur weitere Abschnitte oder Navigationskomponenten und, wenn Sie einen article unterteilen auch Anhänge (appendix) folgen. In einem Satz: Nach dem ersten Abschnitt kann kein Absatz folgen.

Abschnitte ohne Titel kann man mit simplesect erzeugen

Für den besonderen Fall, dass sie einen Abschnitt einfügen möchten, sich aber sicher sind, diesen nicht weiter unterteilen zu wollen, so können Sie auch das Element simplesect benutzen. Wie Kapitel auch, kann section mit dem Attribut label ausgestattet werden, um dem Abschnitt eine bestimmte Bezeichnung zu geben, die nicht identisch mit dem Titel ist.

Beispiel 2.12. explizite Schichtung von Abschnitten

<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<chapter><title>Testkapitel</title>
<para>Dieses Kapitel benutzt geschachtelte Abschnitte</para>
<sect1>
<sect1info>
<abstract><para>Ein einfaches Beispiel für geschachtelte Abschnitte</para>
</abstract>
</sect1info>
<title>Ich bin Sect1</title>
<subtitle>Oder wie ich die Rekursion 
    kennen lernte</subtitle>
<para>Dieser Abschnitt ist ein Sect1.</para>
<sect2><title>Ich bin Sect2</title>
<para>Dieser Abschnitt ist ein Sect2.</para>
<sect3><title>Ich bin Sect3</title>
<para>Dieser Abschnitt ist ein Sect3.</para>
<sect4><title>Ich bin Sect4</title>
<para>Dieser Abschnitt ist ein Sect4.</para>
<sect5><title>ich bin Sect5</title>
<para>Dieser Abschnitt ist ein Sect5.</para>
<simplesect><title>Ich hätte Sect6 sein können</title>
<para>Wenn es Sect6 gäbe, so wäre ich Sect6, so bin
  ich nur Simplesect</para>
</simplesect>
</sect5>
</sect4>
</sect3>
</sect2>
</sect1>
</chapter>

Beispiel 2.13. implizite Schichtung von Abschnitten

<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<chapter><title>Testkapitel</title>
<para>Dieses Kapitel nutzt die Schachtelung von Abschnitten</para>
<section>
<sectioninfo>
<abstract><para>Ein einfaches Beispiel von Schachtelungen</para>
</abstract>
</sectioninfo>
<title>Wie ein Sect1</title>
<subtitle>Oder: Fortsetung von Rekursionen, diesmal
  implizit geschichtet</subtitle>
<para>Dieser Abschnitt verhält sich wie ein Sect1.</para>
<section><title>Wie ein Sect2</title>
<para>Dieser Abschnitt verhält sich wie ein Sect2.</para>
<section><title>Wie ein Sect3</title>
<para>Dieser Abschnitt verhält sich wie ein Sect3.</para>
<section><title>Wie ein Sect4</title>
<para>Dieser Abschnitt verhält sich wie ein Sect4.</para>
<section><title>Wie ein Sect5</title>
<para>Dieser Abschnitt verhält sich wie ein Sect5.</para>
<section><title>Wäre wie ein Sect6</title>
<para>Dieser Abschnitt würde sich wie ein Sect6
  verhalten, wenn es denn so etwas gäbe.</para>
<section><title>Wäre wie ein Sect7</title>
<para>Dieser Abschnitt würde sich wie ein Sect7
  verhalten, wenn es denn so etwas gäbe.</para>
</section>
</section>
</section>
</section>
</section>
</section>
</section>
</chapter>