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.1 – Alle Optionen

Was nicht in der Konfiguration steht, nimmt das Plugin als Vorgabe an. Ein unbekannter Wert wird durch die Vorgabe ersetzt und gemeldet (9.2).

Form

OptionWerteVorgabeKapitel
varianttree, accordion, flyout, bar, dropdown, mega, tabs, columns, select, pagertree4
mobilesame, accordion, offcanvas, select, hiddensame6.1
alignleft, center, right, fullleft4.2
titleTextleer7.3
ariaLabelTextübersetzt „Hauptnavigation“7.3
classNameKlassenleer7.2
idBuchstaben, Ziffern, -, _Prüfwert der Optionen7.3
breakpoints{ mobile, desktop } in px, rem, emaus variables.scss6.2

Ausschnitt

OptionWerteVorgabeKapitel
languageauto, all, Sprachcodeauto8.3
rootPathOrdnerpfadWurzel3.1
scoperoot, section, parent, currentroot3.1
depthganze Zahl ab 0; 0 = unbegrenzt03.2
hideOutsideRoottrue, falsetrue3.2
showScopeRoottrue, falsefalse3.2
showHometrue, falsefalse3.2
indexEntrynone, firstnone3.2
folderLinkindex, first-child, noneindex3.3

Baum

Diese Optionen bestimmen den Baum selbst. Navigationen, die in ihnen übereinstimmen, teilen sich einen (1.3).

OptionWerteVorgabeKapitel
sortmanual, alphabetical, datemanual2.2
sortDirectionasc, descasc2.2
foldersFirstfirst, last, mixedfirst2.2
dateFieldcreated, modified, publishedcreated2.2
order{ Ordnerpfad: [Einträge] }{}2.2
stripNumericPrefixtrue, falsefalse2.1
frontmatterKeys{ order, title, hide, icon }navOrder, navTitle, navHide, navIcon2
hideTagstrue, falsetrue2.3
hideUnlistedtrue, falsetrue2.3
hideDraftstrue, falsetrue2.3
hideEmptyFolderstrue, falsetrue2.3
keepIndexOnlyFolderstrue, falsetrue2.3
includeListe von Musternleer = alles2.3
excludeListe von Musternleer2.3
iconsboth, type, custom, none (auch true, false)both7.1
nodeIcons{ Pfad: Icon }{}7.1

Bedienung

OptionWerteVorgabeKapitel
folderClicktoggle, linktoggle5.1
folderDefaultStatecollapsed, opencollapsed5.1
expandActivetrue, falsetrue5.1
exclusivetrue, falsefalse5.1
persistStatetrue, falsefalse5.1
chevronstrue, falsetrue5.1
triggerclick, hoverclick5.2
iconNames{ folder, folderOpen, file, home, chevron, menu, close, previous, next }Lucide-Namen, siehe 7.17.1

Nur für einzelne Varianten

OptionWerteVorgabeKapitel
flyout.sideauto, right, leftauto4.1
tabs.secondarytrue, falsetrue4.2
select.buttontrue, falsefalse4.3
columns.maxganze Zahl ab 14 — wirkt derzeit nicht4.3
pager.labelstrue, falsetrue4.3
pager.ordertree, siblingstree4.3

Frontmatter

FeldWerteKapitel
navTitleText2.1
navOrderZahl2.2
navHidetrue, false, yes, no2.3
navIconlucide:<name>, Emoji, kurzer Text, none7.1

Alte Schreibweisen

Aus Version 0.1 werden noch verstanden, mit einer Meldung beim Bau:

AltNeu
variant: verticalvariant: tree
variant: horizontalvariant: bar
dropdownTriggertrigger
styleentfällt; Gestaltung über CSS-Variablen (7.2)