Fertig
Navigation
Auf dieser Seite steht, wie man die Unterseiten des Handbuches miteinander verbindet.
- Suche
- Navigation erstellen
- Unterseiten
- Reihenfolge festlegen
- Navigationspfad
- Inhaltstabelle (Table of Content (TOC))
- Überschrift mit manuellem Anchor
- Permalink
- Interne Links
Suche
Die Suche muss nicht gesondert erstellt werden. In der Suche tauchen alle Seiten auf, die nicht von der Suche ausgenommen wurden.
...
search_exclude: true
...
Standard ist false und muss nicht explizit erwähnt werden. Die Seite wird also standardmäßig durchsucht.
> Vollständige Liste der Elemente im Header
Navigation erstellen
Die Navigation muss nicht gesondert erstellt werden. In der Navigation tauchen alle Seiten auf, die nicht von der Navigation ausgenommen wurden.
...
nav_exclude: true
...
Standard ist false und muss nicht explizit erwähnt werden. Die Seite wird also standardmäßig eingebunden.
> Vollständige Liste der Elemente im Header
Unterseiten
Jede Seite kann Unterseiten haben, die bis zur 3. Ebene auch in der Navigation angezeigt werden. Damit eine Seite eine Unterseite wird, muss im Kopf der Seite bei parent: die Seite eintragen sein, unter der die Kind-Seite einsortiert werden soll. Ist die Seite einer Kind-Seite untergeordnet, muss auch unter grand_parent: etwas stehen.
Auf der Eltern-Seite:
title: Gestaltung des Inhaltes
Auf der Kind-Seite:
title: Videos
...
parent: Gestaltung des Inhaltes
...
Auf der Enkel-Seite:
title: Lokale Videos
...
grand_parent: Gestaltung des Inhaltes
parent: Videos
...
Notiz: Enkel-Seiten kommen in diesem Handbuch nicht vor.
> Vollständige Liste der Elemente im Header
Reihenfolge festlegen
Standardmäßig werden die Seiten alphabetisch sortiert. Die Seiten sollten thematisch sortiert sein und so sollten die Seiten im ersten Schritt in 100er-Schritten sortiert sein, damit man noch Seiten einfügen kann, ohne dass man alle Seiten ändern muss.
Die ersten 7 Seiten hätten also die nav_order 100, 200, 300… 700. Fügt man zwischen Seite 300 und 400 eine Seite ein, bekäme sie die nav_order 350. Eine weitere eingefügte Seite zwischen 300 und 350 hätte die Nummer 325 usw.
Navigationspfad
Auf allen Seiten, die Eltern-Seiten haben, wird ein Navigationspfad unterhalb der Suche eingeblendet.
Inhaltstabelle (Table of Content (TOC))
Ein Navigations-Element mit allen Überschriften einer Seite wird erzeugt, wenn folgendes Element an der Stelle steht, wo die Liste auftauchen soll:
+ Navigation
{:toc}
+ Navitation erstellt einen Ersten Listeneintrag. {:toc} erzeugt eine Liste aus den Überschriften einer Seite. Der erste Eintrag + Navigation wird ignoriert.
Soll eine Überschrift nicht in der Navigationsliste erscheinen, muss die Überschrift die Klasse .no_toc haben.
# Überschrift
{:.no_toc}
Um an einer beliebigen Stelle ein Pfeilelement zu erzeugen, mit dem wieder zum Seitenanfang gesprungen werden kann, muss folgender Code eingefügt werden:
[↑](#){:.no-border}
Das komplette Element (mit horizontaler Linie), welches eine Überschrift # Überschrift auf einer Seite abschließt, sieht so aus:
Letzte Zeile
[↑](#){:.no-border}
---
# Überschrift
Überschrift mit manuellem Anchor
Ist eine Überschrift sehr lang oder enthält Sonderzeichen, ist es u.U. notwendig oder ratsam einen selbst definierten Anchor zu wählen. Dieser wird auch automatisch in die Inhaltstabelle (TOC) übernommen.
# Überschrift mit manuellem Anchor {#manueller-anchor}
Permalink
Für eine Seite kann ein permanenter Link festgelegt werden, unter dem die Seite erreichbar ist. Der Permalink überschreibt die automatische Festlegung und ist vor allem sinnvoll für z.B. Fehlerseiten, die alle in einem Ordner Fehlerseiten gesammelt sind.
permalink: /404.html
Warnung: Sollte die Seite in einem Unterordner einer Domain liegen, können Permalinks zu Problemen führen. Permalinks müssen also mit äußerster Sorgfalt genutzt werden.
> Vollständige Liste der Elemente im Header
Interne Links
Interne Links werden auf der Seite Formatierung des Inhaltes unter Interne Links beschrieben.