Dieser Abschnitt beschreibt die Navigation bei HTMLfee.
Mit der Variable {navigation.text} wird die voreingestellte
Navigation angesprochen. Die Navigation wird durch folgende
Konfigurationseinstellungen festgelegt:
Die Navigation wird unter einem eindeutigen Namen in der Konfiguration definiert und unter diesem Namen als Variable in der Vorlage angesprochen. Die Navigation gilt für die Dateien im Verzeichnis der Konfigurationsdatei und darunter. Die voreingestellte Navigation ist unter dem Namen "navigation" in allen Konfigurationsdateien vordefiniert.
Die automatische Navigation wird aus der Verzeichnisstruktur extrahiert. In der Standardeinstellung werden, ausgehend von der Konfigurationsdatei, Dateien bis zur 1. Unterverzeichnisebene gesucht. Die Datei- und Verzeichnisnamen bestimmen die Titel der Navigationselemente. Die Navigationselemente sind pro Verzeichnis alphabetisch sortiert.
Dem Dateinamen kann ein Sortierschlüssel der Form "*Z_" vorangestellt werden (* = Buchstaben oder Zahlen, Z = Zahl), um die Sortierung zu beeinflussen. Der Sortierschlüssel wird in der Navigation ausgeblendet.
Alternativ kann der Titel für ein Navigationselement per Meta-Angabe im Inhalt der Datei angegeben werden:
<META name="htf:kurztitel" content="10_Startseite">
Mit der Konfigurationseinstellung "var.navigation.index" wird
der Name der Indexdateien festgelegt, per Voreinstellung "index.html". Diese
Dateien repräsentieren das darüberliegende Verzeichnis in der Navigation.
Normalerweise tauchen sie nicht in der Navigation auf. Wenn in einer Indexdatei
die Meta-Angabe "htf:kurztitel" vorhanden ist, wird sie für den
Verzeichniseintrag verwendet.
Alternativ zur automatischen Navigation, kann die komplette Navigationshierarchie manuell angegeben werden.
In der Option "var.navigation.Dateien" wird die Liste der
Dateien angegeben, aus denn sich die Navigation zusammensetzt. Die Option
"var.navigation.Titel" enthält die Hierarchie der zugehörigen
Navigationseinträge. Jedem Navigationseintrag wird seine Hierarchieebene durch
eine entsprechende Anzahl von "*"-Zeichen vorangestellt. Beispiel:
var.navigation.Dateien = datei1.html, datei2.html, datei3.html, datei4.html var.navigation.Titel = Startseite, * Seite 1.html, * Unterverzeichnis, ** Seite 2.html
Stellen Sie sich die Titel wie in einer Baumstruktur vor. Die obige Konfiguration erzeugt folgende Navigation:
Startseite -> datei1.html * Seite 1.html -> datei2.html * Unterverzeichnis -> datei3.html ** Seite 2.html -> datei4.html