Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zum Quartz-Plugin quartz-navigations. Und es ist mit ihm gebaut: das Menü darüber und „Zurück / Weiter“ unter jedem Text kommen von dort.

  • Einstieg — die erste Navigation in fünf Minuten
  • Varianten — alle zehn im Vergleich
  • Rezepte — fertige Kombinationen zum Abschauen
  • Nachschlagen — alle Optionen auf einer Seite

Wie die Einträge dafür aussehen, steht in 8.1.

4.3 – Eigene Formen

columns

options:
  variant: columns
  depth: 2
layout:
  position: footer

Die erste Ebene als Spaltenköpfe, ihre Kinder darunter. Das Raster füllt die Breite mit so vielen Spalten, wie mit einer Mindestbreite von --quartz-nav-column-min-width (Vorgabe 10rem) hineinpassen. Die klassische Sitemap in der Fußzeile.

columns.max

Die Option ist vorgesehen, um die Zahl der Spalten zu begrenzen, wirkt aber derzeit nicht — das Raster richtet sich allein nach der Breite. Wer weniger Spalten will, erhöht die Mindestbreite.

select

options:
  variant: select
  title: Springe zu
  select:
    button: false   # Vorgabe

Ein <select>-Sprungmenü. Ordner der ersten Ebene werden zu Optionsgruppen, ihre Ordnerseite steht darin als „Übersicht“; tiefere Ebenen sind eingerückt. Solange die aktuelle Seite nicht in der Liste steht, zeigt das Menü „Springe zu…“.

Wie es navigiert: Mit der Maus gewählt, geht es sofort los. Mit der Tastatur gewählt, wartet es auf Enter — sonst spränge die Seite schon beim Durchblättern mit den Pfeiltasten weiter. select.button: true stellt einen Button „Los“ daneben, für Sites, die einen ausdrücklichen Schritt wollen.

Das Menü navigiert über Quartz’ eigenen Seitenwechsel und braucht JavaScript. title wird hier zur Beschriftung des Menüs.

Oft ist ein select nicht die Navigation selbst, sondern ihre mobile Fassung: mobile: select setzt dasselbe Menü unterhalb der Mobil-Grenze an die Stelle einer Liste (6.1).

pager

options:
  variant: pager
layout:
  position: afterBody

„Zurück“ und „Weiter“, jeweils mit dem Titel der Nachbarseite und einem Pfeil. Unter jedem Text dieser Website steht einer.

In welcher Reihenfolge

options:
  pager:
    order: tree   # tree (Vorgabe) | siblings
pager.orderGeblättert wird …
treedurch den ganzen Ausschnitt in Lesereihenfolge: Ordnerseite, dann ihre Kinder, dann der nächste Ordner
siblingsnur durch die Nachbarn im selben Ordner; am Ende des Ordners ist Schluss

Mit tree bestimmt der Ausschnitt, wie weit geblättert wird (Kapitel 3):

  • scope: root blättert durch die ganze Site — oder durch rootPath.
  • scope: section hört am Ende des Bereichs auf.
  • depth begrenzt die Tiefe.

Ordner ohne Linkziel werden übersprungen, ebenso ein Ordner, der auf dieselbe Seite führt wie sein erster Eintrag (3.3). Auf der ersten Seite fehlt „Zurück“, auf der letzten „Weiter“; hat eine Seite keinen von beiden, erscheint nichts.

Beschriftung

options:
  pager:
    labels: false   # nur Pfeil und Titel

Die Wörter „Zurück“ und „Weiter“ folgen auf einer mehrsprachigen Site der Sprache der Seite, sonst der Sprache der Site (7.3).