Handbuch für Redakteure – biodeliver YAML-CMS

Überblick

Dieses Handbuch zeigt dir, wie du mit dem biodeliver YAML-CMS Seiten erstellst und bearbeitest.
Viele Inhalte werden automatisch durch KI generiert, du prüfst und passt nur an, was nötig ist.

Seitenaufbau

• YAML-Datei mit Metadaten (Titel, URL, Sichtbarkeit, Template)

• Inhaltsblöcke (cmsBlockCollection → cmsBlocks)

• Jeder Block hat einen type (headline, html, multicolumn, widget, media)

• Blöcke sind nach Position sortiert (Reihenfolge auf der Seite)

Blocktypen im Überblick

• headline – Überschrift, mit headline-Text und hierarchy (h1, h2, …)

• html – Freier HTML-Text (z.B. Absätze, Definition Lists)

• multicolumn – Mehrspaltiges Layout (z.B. 3 Spalten mit Text/Bild)

• widget – Interaktive Elemente wie Buttons (subType: button)

• media – Bilder mit Metadaten (Dateiname, Beschreibung)

Wie Inhalte bearbeiten

• Überschriften: Text im headline ändern, Hierarchie beachten (h1 nur einmal!)

• Text: Im html-Block den body anpassen, bei Bedarf mit einfachem HTML

• Bilder: Im media-Block den filename und description aktualisieren

• Buttons: Im widget-Block btn_text, btn_href und btn_class anpassen

• Mehrspalter: In multicolumn jede Spalte separat bearbeiten

Tipps & Hinweise

• Sichtbarkeit prüfen (visible: true)

• Positionierung durch position steuern

• Barrierefreiheit beachten: klare Überschriftenstruktur, Bildbeschreibungen, ausreichend Kontrast

• SEO: Meta-Beschreibung im Header pflegen (metaTagDescription)

• Änderungen speichern und prüfen im Vorschau-Modus

Fehlerbehebung

• Block nicht sichtbar? visible auf true setzen

• Änderungen nicht übernommen? Datei richtig speichern und neu laden

• Bild fehlt? Prüfe Dateipfad und ob das Bild im CMS hochgeladen ist

Beispiel

yaml
KopierenBearbeiten
- type: headline
  headline: "Frische Bio-Getränke"
  hierarchy: h1
- type: html
  body: "<p>Unsere Getränke stammen aus nachhaltigem Anbau.</p>"
- type: widget
  subType: button
  data:
    btn_href: "/produkte/getraenke"
    btn_text: "Jetzt entdecken"
    btn_class: "btn btn-primary"