Die Menü-Struktur anpassen#

Die Struktur und das Menü deiner Website werden über _meta.yaml Dateien gesteuert. Jede Datei definiert die Menü-Struktur für den jeweiligen Ordner.

Die vollständige Liste aller Felder findest du in der _meta-Referenz.

Grundprinzip#

• Jeder Ordner kann eine _meta.yaml enthalten.
• Die Dateinamen (ohne Erweiterung) dienen als Schlüssel.
• Die Reihenfolge der Einträge bestimmt die Reihenfolge im Menü.
• Seiten, die nicht in _meta.yaml aufgeführt sind, werden automatisch ausgeblendet (per URL aber weiterhin erreichbar).

Basis-Konfiguration#

Seitentitel setzen#

Dies erstellt Menüeinträge für index.md(x) und impressum.md(x) mit den angegebenen Titeln.

Wenn kein title gesetzt ist, wird der Titel aus dem Frontmatter der Seite (sidebarTitle → title) oder dem Dateinamen abgeleitet.

Sichtbarkeit steuern#

Nur im Footer anzeigen#

Seiten wie Impressum oder Datenschutzerklärung sollen oft nur im Footer erscheinen:

Seite ausblenden#

Mit display: hidden bleibt eine Seite per URL erreichbar, erscheint aber nicht in der Navigation:

Element im Header-Menü hinzufügen#

Standardmäßig erscheinen alle Einträge in der Sidebar. Mit type: 'page' wird ein Eintrag stattdessen in der Header-Navigation (Navbar) angezeigt:

Externe Links im Header-Menü#

Du kannst auch externe Links in die Header-Navigation einfügen:

Dropdown-Menüs erstellen#

Für komplexere Navigationsstrukturen kannst du Dropdown-Menüs mit mehreren Links erstellen, die dann in der Header-Navigation angezeigt werden:

Parameter:

• type: 'menu' — Erstellt ein Dropdown-Menü (kein eigener Link, nur Untereinträge)
• items — Enthält alle Untereinträge
• icon — Optionales Icon für jeden Eintrag (Pfad relativ zum public-Ordner)

Externe Links in der Sidebar#

Auch in der Sidebar können externe Links eingefügt werden:

Startseite für einen Menüordner festlegen#

Standardmäßig öffnet ein Klick auf einen Ordner in der Seitenleiste nur die zugehörigen Unterseiten. Du kannst einem Ordner eine eigene Startseite zuweisen — dann wird der Ordnertitel selbst zum Link und navigiert direkt zur Startseite, während der Pfeil daneben die Unterseiten aus- oder einklappt.

Möglichkeit 1 – Geschwisterdatei (Sibling-Pattern)#

Lege eine Datei mit demselben Namen wie der Ordner direkt neben den Ordner:

dokument/
  anleitungen.mdx       ← Startseite des Ordners
  anleitungen/
    _meta.yaml
    erste-anleitung.md

Die Datei anleitungen.mdx wird automatisch als Startseite des Ordners anleitungen/ erkannt.

Möglichkeit 2 – Innere Indexdatei#

Lege eine Datei namens index.mdx direkt in den Ordner:

dokument/
  anleitungen/
    _meta.yaml
    index.mdx             ← Startseite des Ordners
    erste-anleitung.md

Die Datei index.mdx wird dabei weiterhin als normaler Menüeintrag in der Seitenleiste angezeigt. Möchtest du sie dort ausblenden (und nur über den Ordnertitel erreichbar machen), setze folderIndex: true im Frontmatter der Datei:

Automatisches Auf- und Zuklappen#

Ordner mit einer zugewiesenen Startseite klappen in der Seitenleiste automatisch auf, wenn du in den Bereich navigierst, und klappen wieder zu, wenn du den Bereich verlässt.

Verschachtelte Strukturen#

In Unterordnern kannst du weitere _meta.yaml Dateien erstellen. Jede Datei steuert nur die direkten Kinder ihres Ordners:

document/
  _meta.yaml              # Hauptmenü
  fuer-redakteur-innen/
    _meta.yaml            # Untermenü
    index.mdx
    menuestruktur-anpassen.mdx