Die Beispiele für das Ergebnis zeigen die generierte XML Struktur, die der Ausgabe z.B. im PrintCSS oder EPUB zugrunde liegt. Sie wird im parsX-Framework nicht direkt als XML ausgegeben, kann aber im CSS als <inhaltsverzeichnis>
gestyled werden.
<ausgabe_inhaltsverzeichnis>
<werk> <vorspann> <kapitel> <u1> <titel><zaehler>1.</zaehler><text>vorspann/kapitel/u1</text></titel> </u1> <kapitel> <u2> <titel><zaehler>1.1</zaehler><text>vorspann/kapitel/kapitel/u2</text></titel> </u2> </kapitel> </kapitel> </vorspann> <hauptteil> <kapitel> <u1> <titel><zaehler>1.</zaehler><text>hauptteil/kapitel/u1</text></titel> </u1> <kapitel> <u2> <titel> <text>Inhalt</text></titel> </u2> <ausgabe_inhaltsverzeichnis/> <!-- Hier wird ein Inhaltsverzeichnis ausgegeben --> </kapitel> <kapitel> <u2> <titel><zaehler>1.1</zaehler><text>hauptteil/kapitel/kapitel/u2</text></titel> </u2> </kapitel> <kapitel> <u2> <titel><zaehler>1.2</zaehler><text>hauptteil/kapitel/kapitel/u2</text></titel> </u2> </kapitel> </kapitel> <kapitel> <u1> <titel><zaehler>2.</zaehler><text>hauptteil/kapitel/u1</text></titel> </u1> </kapitel> </hauptteil> </werk>
@kontext="werk"
(Default)Es werden die Überschriften im gesamten Werk ausgegeben:
<inhaltsverzeichnis> <abschnitt> <eintrag> <zaehler>1.</zaehler><text>vorspann/kapitel/u1</text> <ebene> <eintrag> <zaehler>1.1</zaehler><text>vorspann/kapitel/kapitel/u2</text> </eintrag> </ebene> </eintrag> </abschnitt> <abschnitt> <eintrag> <zaehler>1.</zaehler><text>hauptteil/kapitel/u1</text> <ebene> <eintrag> <zaehler>1.1</zaehler><text>hauptteil/kapitel/kapitel/u2</text> </eintrag> <eintrag> <zaehler>1.2</zaehler><text>hauptteil/kapitel/kapitel/u2</text> </eintrag> </ebene> </eintrag> <eintrag> <zaehler>2.</zaehler><text>hauptteil/kapitel/u1</text> </eintrag> </abschnitt> </inhaltsverzeichnis>
@kontext="teil"
Es werden die Überschriften im übergeordneten <hauptteil>
ausgegeben:
<inhaltsverzeichnis> <abschnitt> <eintrag> <zaehler>1.</zaehler><text>hauptteil/kapitel/u1</text> <ebene> <eintrag> <zaehler>1.1</zaehler><text>hauptteil/kapitel/kapitel/u2</text> </eintrag> <eintrag> <zaehler>1.2</zaehler><text>hauptteil/kapitel/kapitel/u2</text> </eintrag> </ebene> </eintrag> <eintrag> <zaehler>2.</zaehler><text>hauptteil/kapitel/u1</text> </eintrag> </abschnitt> </inhaltsverzeichnis>
@kontext="kapitel"
Mit @kontext="kapitel"
wird ein Verzeichnis der Unterkapitel des aktuellen Kapitels ausgegeben. Im Beispiel oben würde im Ergebnis kein Inhaltsverzeichnis generiert, da das Kapitel mit der Überschrift „Inhalt“ keine Unterkapitel hat.
Um das Inhaltsverzeichnis eines Kapitels zu erzeugen, muss das Ausgabe-Element in dem Kapitel stehen, dessen Unterkapitel gelistet werden sollen. Soll das Verzeichnis selbst einen Titel bekommen, kann man diesen im Ausgabe-Element angeben. Anstelle von
<kapitel> <u2> <titel> <text>Inhalt</text></titel> </u2> <ausgabe_inhaltsverzeichnis kontext="kapitel"/> </kapitel>
muss man also taggen:
<ausgabe_inhaltsverzeichnis kontext="kapitel"> <titel> <text>Inhalt</text></titel> </ausgabe_inhaltsverzeichnis>
Auf diese Weise erhält man:
<inhaltsverzeichnis> <titel> <text>Inhalt</text></titel> <eintrag> <zaehler>1.1</zaehler><text>hauptteil/kapitel/kapitel/u2</text> </eintrag> <eintrag> <zaehler>1.2</zaehler><text>hauptteil/kapitel/kapitel/u2</text> </eintrag> </inhaltsverzeichnis>
<toctitel>
und @toc
Im folgenden Beispiel wird für das 1. Kapitel die Überschrift ausgegeben, für das zweite der Toctitel, das Motto erscheint nicht im Verzeichnis:
<hauptteil> <kapitel toc="nein"> <abs>Motto</abs> </kapitel> <kapitel> <u1> <titel><zaehler>1.</zaehler><text>hauptteil/kapitel/u1</text></titel> </u1> </kapitel> <kapitel> <meta> <toctitel><zaehler>Kap.2</zaehler><text>alternative Überschrift</text></toctitel> </meta> <u1> <titel><zaehler>2.</zaehler><text>hauptteil/kapitel/u1</text></titel> </u1> </kapitel> </hauptteil>
<inhaltsverzeichnis> <abschnitt> <eintrag> <zaehler>1.</zaehler><text>hauptteil/kapitel/u1</text> </eintrag> <eintrag> <zaehler>Kap.2</zaehler><text>alternative Überschrift</text> </eintrag> </abschnitt> </inhaltsverzeichnis>