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.2 – Meldungen

Alle Meldungen beginnen mit [navigations] und erscheinen einmal je Ursache, nicht einmal je Seite. Keine davon bricht den Bau ab: Das Plugin nimmt die Vorgabe oder lässt das Fehlerhafte weg und baut weiter.

Unknown value "…" for `…`; using `…`.

Ein Wert, den die Option nicht kennt — ein Tippfehler, eine deutsche Schreibweise (variant: baum), ein Wert aus einer anderen Option. Es gilt die genannte Vorgabe. Die erlaubten Werte stehen in 9.1.

`…` must be an integer >= …; using ….

depth oder columns.max sind keine ganze Zahl, oder zu klein. depth: "2" in Anführungszeichen geht; depth: 1.5 und depth: -1 nicht.

Ignoring invalid `…` entry …

Ein Eintrag in include, exclude oder einer order-Liste ist kein Text oder leer. Nur dieser Eintrag fällt weg.

`order` must be a map of folder → list. · `nodeIcons` must be a map of path → icon.

Die Option ist eine Liste statt einer Zuordnung. Richtig:

order:
  docs: [einstieg, setup]
nodeIcons:
  docs: lucide:book-open

Ignoring invalid `nodeIcons` entry for "…".

Der Wert zu diesem Pfad ist leer oder kein Text.

`order` for "…" lists unknown entry "…".

Die order-Liste eines Ordners nennt etwas, das es darin nicht gibt — meist eine umbenannte Datei oder ein Slug statt eines Dateinamens mit anderer Schreibung. Die übrigen Einträge wirken weiter. Siehe 2.2.

`rootPath: …` is not a folder with visible pages.

Den Ordner gibt es nicht, rootPath nennt eine Seite statt eines Ordners, oder alles darin ist ausgeblendet — durch exclude, navHide, Entwürfe. Die Navigation erscheint auf keiner Seite.

`language: …` matches no page language (…).

Die feste language passt zu keiner Sprache, die quartz-multilanguage an den Seiten vermerkt hat; in Klammern stehen die vorhandenen. Meist ein Tippfehler oder eine Sprache, für die es noch keine Seite gibt. Die Navigation erscheint auf keiner Seite (8.3).

Unknown Lucide icon `…`; see https://lucide.dev/icons

Ein Name aus navIcon, nodeIcons oder iconNames steht nicht in der Lucide-Sammlung. An der Stelle erscheint kein Icon. Häufige Ursachen: ein Name aus einer älteren Lucide-Fassung (home heißt heute house), oder bei iconNames ein überflüssiges lucide: davor.

Could not read quartz/styles/variables.scss; using 800px / 1200px as breakpoints.

Der Bau läuft nicht im Projektordner, oder die Datei fehlt. Die Navigation schaltet bei 800 Pixeln auf mobil (6.2).

`variant: vertical` is now `tree`. · `dropdownTrigger` is now `trigger`.

Alte Schreibweisen aus Version 0.1. Sie wirken weiter; die Meldung verschwindet, sobald die neue Schreibweise dasteht.

`style` was removed; …

Die Option style gibt es nicht mehr, sie wird übergangen. Gestaltet wird über die CSS-Variablen (7.2).

Wenn gar nichts passiert

Keine Meldung, keine Navigation — dann liegt es selten am Plugin:

UrsacheWas hilft
enabled: falseumstellen
Der Ausschnitt ist auf dieser Seite leerscope, rootPath, hideOutsideRoot prüfen (3.1)
Der Pager hat keine Nachbarndie Seite ist ausgeblendet, oder sie ist die einzige im Ausschnitt
Die Navigation steht an einer unerwarteten Stellelayout-Block fehlt — dann links, priority: 10