Taggingbeispiele

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.

Beispiel: Werkstruktur mit Kapitel „Inhalt“ und Element <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>

Ergebnis mit @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>

Ergebnis mit @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>

Ergebnis mit @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>

Verwendung von <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>

Ergebnis

<inhaltsverzeichnis>
	<abschnitt>
		<eintrag>
			<zaehler>1.</zaehler><text>hauptteil/kapitel/u1</text>
		</eintrag>
		<eintrag>
			<zaehler>Kap.2</zaehler><text>alternative Überschrift</text>
		</eintrag>
	</abschnitt>
</inhaltsverzeichnis>