Wikibooks Automatische Vorlagen/ Dokumentation/ AutoNavigation/ Vorbereitung

Regal:Anleitungen

Inhaltsverzeichnis

Inhalt „Dokumentation“

Allgemeine Hinweise

AutoInhalt/ Musterdaten

AutoNavigation/ Anzeige

Ergänzende Vorlagen

Hier wird die Arbeitsweise der folgenden Vorlagen für die Navigation genauer beschrieben:

Beachte auch die allgemeinen Hinweise zur Definition dieser Vorlagen, zu Parametern und zur Abfrage von Werten.

Struktur

Die folgende Darstellung zeigt stark vereinfacht den Zusammenhang der Vorlagen.

AutoNavigation
⇓
AutoNavigation Start
⇓
AutoNavigation Vorbereitung	⇒	AutoNavigation Ebene3 Start
⇓	⇒	⇓	⇒	⇓
AutoNavigation Ebene2	⇒	AutoNavigation Ebene3	⇒	AutoNavigation Ebene4
⇓	⇒	⇓	⇒	⇓
	AutoNavigation Anzeige

Einleitung, Zusammenfassung

Die Namen eines einleitenden und eines abschließenden Kapitels innerhalb des Buchs oder eines Teils werden immer mit der Zusatzvorlage GetStandard geholt. Überall dort, wo kapE, kapZ bestimmt wird, wird diese Vorlage mit den richtigen Parametern eingebunden.

AutoNavigation

Die Vorlage AutoNavigation wird in allen Seiten verwendet, die die Navigation anzeigen sollen, also in jedem Kapitel sowie den Seiten Gesamter Teil. Sie wird ohne Parameter aufgerufen.

Diese Vorlage registriert einige feste Werte und übergibt diese als Parameter an die nächste Vorlage.

AutoNavigation Start

Name	Beispiel	Bedeutung
Dieser Vorlage werden die folgenden Informationen übergeben:
daten	Wikibooks Automatische Vorlagen/ Vorlage:Daten	Verweis auf die `Buchdaten`
name1	Wikibooks Automatische Vorlagen	erster Bestandteil des Seitennamens, also der Name des Buches
name2	Dokumentation	zweiter Bestandteil des Seitennamens, also der Name des Buches
name3	AutoNavigation	dritter Bestandteil des Seitennamens, also der Name des Buches (nicht vorhanden bei einem Buch ohne Teile und bei den Gesamtseiten eines Teils)
name4	Vorbereitung	vierter Bestandteil des Seitennamens, also der Name des Buches (nur vorhanden bei Kapiteln eines Bereichs)
kapE	Einführung	Name eines einleitenden Kapitels, sofern vorhanden (nur möglich bei einem Buch ohne Teile)
kapZ	Zusammenfassung	Name eines abschließenden Kapitels, sofern vorhanden
max2	4	Anzahl der Teile oder Kapitel des Buches (also die möglichen Einträge auf Ebene 2)
Mit diesen Angaben werden weitere Angaben bestimmt und an die nächste Vorlage Vorbereitung übergeben.

AutoNavigation Vorbereitung

Name	Beispiel		Bedeutung
Dieser Vorlage werden die folgenden Informationen übergeben:
Die Parameter `daten, name1, name2, name3, name4, max2, kapE, kapZ` werden einfach weitergereicht.
buch	Wikibooks Automatische Vorlagen/ Inhaltsverzeichnis		Verweis auf die Seite mit dem Inhaltsverzeichnis
nr2	3		Nummer des Teils oder Kapitels, unter der die Angabe zu `name2` in den `Buchdaten` steht; dazu wird die ergänzende Vorlage GetNumber benutzt – Dokumentation im letzten Kapitel des Teils.
var	4		Variante, für die die Navigation benötigt wird Kapitel in einem Buch ohne Teile Gesamter Teil für ein Buch mit Teilen Kapitel in einem Teil eines Buches ohne Bereich, kann aber auch die Einleitung oder Zusammenfassung sein Kapitel in einem Bereich eines Teils
Mit diesen Angaben werden die folgenden Prüfungen ausgeführt.
Ergebnis	Ebenen	Situation	Erläuterung
Handelt es sich um eine Seite mit 2 Ebenen (Variante 1 oder 2) oder nicht, also um ein Kapitel in einem Buch mit Teilen (Variante 3 oder 4)?
Ja	1 oder 2	einfache Struktur	Die AutoNavigation zur Ebene2 kann angezeigt werden. Die vorhandenen Parameter werden weitergereicht; nicht benötigte Parameter werden ignoriert; weitere Parameter werden bestimmt. Weiter mit der Anzeige durch die Vorlage AutoNavigation Ebene2 – Dokumentation im nächsten Kapitel.
Nein	3 oder 4	genauere Struktur	Für die Struktur mit 3 oder 4 Ebenen werden weitere Informationen benötigt. Die vorhandenen Parameter werden an die nächste Vorlage Ebene3 Start weitergereicht; weitere Parameter werden dazu bestimmt.

AutoNavigation Ebene3 Start

Name	Beispiel		Bedeutung
Dieser Vorlage werden die folgenden Informationen übergeben:
Die Parameter `var, name1, name2, name3, name4, nr2, max2` werden einfach weitergereicht. `datenB` erhält den Wert des bisherigen Parameters `daten`.
datenT	Wikibooks Automatische Vorlagen/ Vorlage:Daten Dokumentation		Verweis auf die `Teildaten`
link	Wikibooks Automatische Vorlagen/ Dokumentation		der vollständige Name des Teils
kapE	Einführung		Name eines einleitenden Kapitels des Teils, sofern vorhanden
kapZ	Zusammenfassung		Name eines abschließenden Kapitels des Teils, sofern vorhanden
max3	4		Anzahl der Bereiche oder Kapitel des Teils (also die möglichen Einträge auf Ebene 3)
Mit diesen Angaben werden die folgenden Prüfungen und Maßnahmen ausgeführt.
Ergebnis	Ebenen	Situation	Erläuterung
Handelt es sich um ein Kapitel mit 3 Ebenen (also direkt innerhalb eines Teils) oder mit 4 Ebenen (also innerhalb eines Bereichs)?
	3	in einem Teil	Die AutoNavigation zur Ebene3 kann angezeigt werden. Die vorhandenen Parameter werden weitergereicht; weitere Parameter können einfach bestimmt werden. Weiter mit der Anzeige durch die Vorlage AutoNavigation Ebene3 – Dokumentation im nächsten Kapitel.
	4	in einem Bereich	Die AutoNavigation zur Ebene4 kann angezeigt werden. Die vorhandenen Parameter werden weitergereicht; weitere Parameter müssen aber – teilweise umständlich – noch bestimmt werden. Weiter mit der Anzeige durch die Vorlage AutoNavigation Ebene4 – Dokumentation im nächsten Kapitel.