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.

9.3 – Grenzen

Nur Seiten aus dem Inhaltsordner

Ein Menüpunkt, der auf eine andere Website führt, ist keine Seite und steht in keinem Baum. Dafür sind Quartz’ Fußzeile (links) oder eine Layout-Box da.

Die Wörter gibt es nur auf Deutsch und Englisch

„Zurück“, „Weiter“, „Übersicht“, „Start“ und die Namen für Screenreader bringt das Plugin in diesen beiden Sprachen mit; jede andere bekommt Englisch. Ändern lassen sich nur title und ariaLabel, und die übersetzt das Plugin nicht (7.3).

Geteilte Seiten bekommen die Standardsprache

Tag-Seiten und Ordnerseiten, die sich mehrere Sprachen teilen, gehören zu keiner Sprache. Die Navigation zeigt dort den Baum der Standardsprache von quartz-multilanguage — auch auf der Tag-Seite eines englischen Tags. Liegt jede Seite in einem Sprachordner, entscheidet stattdessen das locale der Site (8.3).

Mit der Sprache im Frontmatter hat nur eine Sprache eine Startseite

Die index.md in der Wurzel gehört genau einer Sprache. Der Baum der anderen hat keine Startseite: showHome und showScopeRoot mit scope: root zeigen dort nichts.

detection mit frontmatter vor folder

Stellt man die Erkennung in quartz-multilanguage so um, behalten Seiten in einem Sprachordner, die lang im Frontmatter tragen, den Ordner in ihrem Pfad; die übrigen verlieren ihn. Im englischen Baum steht docs dann zweimal: an der Wurzel und unter en. Mit der Vorgabe [folder, suffix, frontmatter] passiert das nicht.

breakpoints gilt nicht für eine einzelne Navigation

Das Stylesheet ist eines für alle. Verschiedene Werte in verschiedenen Einträgen landen als zwei Stylesheets auf der Site, die beide auf jede Navigation wirken (6.2).

stripNumericPrefix trifft auch Titel aus dem Frontmatter

Nicht nur Titel aus Dateinamen, sondern jeder Titel, der mit einer Zahl und -, _, . oder einem Leerzeichen beginnt. Aus „1.2 – Einstieg“ wird „2 – Einstieg“. Nur navTitle bleibt unberührt (2.1).

columns.max wirkt nicht

Die Option wird angenommen, das Raster richtet sich aber nur nach der Breite (4.3).

Das Sprungmenü braucht JavaScript

select und mobile: select navigieren über ein Skript. Ohne JavaScript lässt sich eine Option wählen, aber nichts passiert (5.3).

Eigene Icons nicht im Sprungmenü

Eine Option eines <select> kann nur Text enthalten (7.1).

Eine Reihenfolge je Navigation, nicht je Seite

Die Sortierung gilt für den ganzen Baum eines Eintrags. Eine Seite kann nicht verlangen, in einer bestimmten Navigation woanders zu stehen als in einer anderen — außer beide Navigationen sortieren verschieden.

Hover nur mit Maus

trigger: hover wirkt auf Geräten, die Hover melden. Auf Touch-Geräten öffnet der Klick.

Das mobile Menü braucht freie Bahn

Es liegt mit position: fixed über dem Fenster. In einem Vorfahren mit transform, filter oder Maske wird es zusammengestaucht oder abgeschnitten (6.1).

exclusive hängt am Browser

Ein Ordner je Ebene über das name-Attribut von <details> können aktuelle Browser. Ältere lassen mehrere Ordner offen — die Navigation funktioniert trotzdem.

Das Gedächtnis hängt an der ID

persistState speichert unter der id. Ohne feste id ändert jede Optionsänderung die ID, und das Gemerkte ist weg (5.1). Gespeichert wird im Browser des Besuchers; ein anderer Browser, ein privates Fenster oder gelöschte Websitedaten fangen von vorn an.

Gemerkt wird je Ordner unter seinem echten Pfad. Mit Sprachordnern sind de/docs und en/docs zwei Ordner, das Gedächtnis beginnt nach einem Sprachwechsel neu; mit Sprachsuffixen teilen sich beide Sprachen einen Ordner und damit auch, was offen war.