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:

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