Die Menü-Struktur steuern

Die Struktur und das Menü deiner Website werden über _meta.yaml Dateien gesteuert. Diese Dateien kannst du in jedem Ordner deines Dokuments anlegen. Sie definieren, wie die Unterseiten in der Navigation angezeigt werden. Du kannst die Seitennavigation, das Footer-Menü und die Header-Navigation individuell anpassen.

Grundprinzip

Jede _meta.yaml Datei definiert die Menü-Struktur für den jeweiligen Ordner. Die Dateinamen (ohne Erweiterung) dienen als Schlüssel, und die zugehörigen Einstellungen bestimmen, wie die Seiten im Menü erscheinen.

Basis-Konfiguration

Einfacher Seitentitel

Die einfachste Form ist die Definition eines Titels für eine Seite:

index:
  title: "Startseite"
impressum:
  title: Impressum

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

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

impressum:
  title: Impressum
  displayOnlyInFooter: true
datenschutz:
  title: Datenschutz
  displayOnlyInFooter: true

Erweiterte Menü-Optionen

ELement im Header-Menü hinzufügen

Du kannst auch einen Eintrag in die Header-Navigation einfügen:

meine-md-datei:
  title: 'Ein Beispiel'
  type: 'page'

Externe Links im Header-Menü

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

a-header-menu-entry:
  title: 'Ein Beispiel'
  type: 'page'
  href: 'https://example.com/contact'
  newWindow: true

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

all-tools-services:
  title: 'Alle Tools & Services'
  type: 'menu'
  items:
    easypdf:
      title: 'easyPDF'
      href: 'https://services.opencode.de/easypdf/'
      icon: '//assets/icons/easypdf.svg'
    easyweb:
      title: 'easyWebsite'
      href: 'https://services.opencode.de/easywebsite/'
      icon: '//assets/icons/easyweb.svg'

Parameter:

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

Reihenfolge der Menüeinträge

Die Reihenfolge der Einträge in der _meta.yaml Datei bestimmt die Reihenfolge im Menü. Einträge erscheinen von oben nach unten in der gleichen Reihenfolge, wie sie in der Datei definiert sind.

Verschachtelte Strukturen

In Unterordnern können Sie weitere _meta.yaml Dateien erstellen, um die Struktur weiter zu verfeinern:

document/
  _meta.yaml              # Hauptmenü
  fuer-autor-innen/
    _meta.yaml            # Untermenü für "Für Autor:innen"
    index.mdx
    menu-struktur-steuern.mdx

Menü