Verschachtelte Abschnitte
(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)
In DocBook gibt es zwei Möglichkeiten, Abschnitte ineinander zu verschachteln:
- sect1, sect2… sect5
- Verschachtelte section-Elemente
Strukturell gesehen sind die beiden folgenden Beispiele gleich:
Beispiel: Vergleich verschachtelter Abschnitte mit section und sect1 (section.xml)
<chapter>
<!-- ... -->
<section>
<title>Ein Abschnitt</title>
<para>Dies ist ein normaler Abschnitt.</para>
<section>
<title>Ein Unterabschnitt</title>
<para>Dies ist ein Unterabschnitt.</para>
</section>
</section>
</chapter><chapter>
<!-- ... -->
<sect1>
<title>Ein Abschnitt</title>
<para>Dies ist ein normaler Abschnitt.</para>
<sect2>
<title>Ein Unterabschnitt</title>
<para>Dies ist ein Unterabschnitt.</para>
</sect2>
</sect1>
</chapter>Die Unterschiede zwischen diesen beiden Auszeichnungsmethoden sind:
- Das section-Element lässt sich rekursiv verschachteln, bei den sectX-Elementen ist nach der fünften Ebene Schluß.
- Die Verschachtelungstiefe bei section ist durch kein DocBook-Schema limitiert. Dies kann als ein Vor- oder Nachteil angesehen werden. Sollte eine bestimmte Tiefe nicht überschritten werden, müsste dies anderweitig überprüft werden (entweder durch eine Schematron-Regel oder über XSLT).
Im Gegensatz dazu dürfen sectX-Elemente maximal fünfmal ineinander verschachtelt werden. Sollten Sie eine tiefere Struktur benötigen, müssen Sie entweder ein DocBook-Schema anpassen oder auf section ausweichen.
- Je nach Publishing-System kann eine zu tiefe Verschachtelungstiefe bei section zu Fehlern im Layout führen. Bei sectX kann dies nicht passieren.
- Ein Abschnitt das mit einem section-Element ausgezeichnet wurde, lässt sich an eine beliebige Position verschieben. Bei sectX-Elementen ist dies nicht möglich; hier ist die Hierarchiestufe bereits fest im Namen vorgegeben, so dass man diese Elemente umbenennen müsste.
| << zurück | vor >> |
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
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