options:
folderLink: index # index | first-child | none| Wert | Ein Ordnertitel führt auf … |
|---|---|
index (Vorgabe) | seine Ordnerseite; gibt es keine, seine erste Seite |
first-child | seine erste Seite, auch wenn er eine Ordnerseite hat |
none | nichts — der Titel ist Text |
Die erste Seite
„Erste Seite“ heißt: der erste Eintrag in der Reihenfolge des Baums (2.2), der eine Seite ist. Steht dort ein Unterordner, sucht das Plugin in ihm weiter — es sei denn, er hat selbst eine Ordnerseite, dann ist die die erste Seite.
first-child passt zu Ordnern, die nur Gliederung sind: Ein Klick auf „Anleitungen“ landet direkt
bei der ersten Anleitung statt auf einer Übersicht, die nichts zu sagen hat.
Gibt es überhaupt Ordner ohne Seite?
Selten. Quartz’ Plugin folder-page erzeugt jedem Ordner eine Seite, auch ohne index.md. Der
Rückfall von index auf die erste Seite greift erst, wenn folder-page abgeschaltet ist — oder wenn
die Ordnerseite ausgeblendet wurde, etwa mit exclude: ["docs/index"].
Was die anderen Varianten daraus machen
| Variante | Ordner ohne Linkziel (none) |
|---|---|
| Listen, Leisten, Menüs | Titel als Text |
select | Option ist nicht auswählbar |
pager | wird übersprungen |
Und eine Besonderheit beim pager: Führen ein Ordner und seine erste Seite auf dieselbe Adresse,
blättert er nur einmal dorthin. Ein „Zurück“, das auf die Seite zeigt, auf der man gerade steht, gibt
es nicht.
Ordner, die aufklappen
In accordion, flyout, dropdown und mega ist ein Ordner mehr als ein Titel — er klappt auf.
Ob seine Zeile dann klappt oder verlinkt, entscheidet eine zweite Option, folderClick
(5.1). folderLink sagt nur, wohin ein Link führt, wenn es einen
gibt.