Navigation erstellen

Eine Seite kann zu einer oder mehreren Navigationslisten hinzugefügt werden. Dazu muss in der Seitendefinition ein Abschnitt mit dem Namen navigation eingefügt werden. Die Namen - in diesem Beispiel Main und Footer sind frei wählbar.

Hinweis

Der Name all-pages darf nicht verwendet werden (siehe unten).

Eine Seite kann zu beliebigen Navigationen hinzugefügt werden.

navigation:
    Main: 
        label: Meine erste Seite
        ranking: 100
    Footer: 
        label: Meine erste Seite
        ranking: 100

Die Variable ranking gibt dabei die Position/Sortierung innerhalb der Navigation wieder.

Diese Seite erscheint nun sowohl im Header, als auch in der Footer-Navigation.

Jede Navigation kann zudem eine eigene ID besitzen. Wird im Abschnitt der Navigation keine ID angegen, so wird die ID der Seite und wenn auch diese nicht definiert wurde ein MD5-Hash über die URL genommen.

Alle definierten Seiten sind zudem über den Schlüssel all-pages ansprechbar. Die Einträge unter all-pages haben die Schlüssel id, url und label.

Die ID kann entweder in der Seite gesetzt werden, oder wird als MD5-Hash aus der URL errechnet. Der Wert in label entspricht dem Titel aus den Meta-Beschreibungen.

Um eine hierarchische Navigation zu erstellen, kann das Schlüsselwort parent verwendet werden. Hierzu muss in Navigation die ID der übergeordneten Seite angegeben werden:

navigation:
    Main: 
        label: Meine erste Seite
        ranking: 100
        parent: perant-id

Im nächsten Artikel wird gezeigt, wie man die Navigation im Inhalt verwenden kann.