2.1 – Datei oder Konfiguration

Der Inhalt einer Box kommt aus einer Datei oder direkt aus der Konfiguration:

options:
  file: snippet.html   # -> snippets/snippet.html

options:
  html: "<p>Notizen aus einer kleinen Stadt.</p>"

html gewinnt immer

Stehen beide da, wird file nicht einmal gelesen. Das ist keine Fehlermeldung wert, aber eine häufige Verwirrung: Wer eine Datei anlegt und sie nicht erscheint, hat oft noch ein html aus einem früheren Versuch im Eintrag stehen.

Wann welcher Weg

	Datei (file)	Konfiguration (html)
Umfang	mehr als zwei, drei Zeilen	Einzeiler
Bearbeiten	im Editor, mit Syntaxhervorhebung	in der YAML-Datei, mit ihren Ausweichregeln
Im Serve-Modus	Änderung wirkt beim Neuladen	Änderung braucht einen Neustart
Im Vorlagenpaket	reist über den Baustein Statische Dateien mit	reist im Eintrag selbst mit

Der letzte Punkt ist der, der am häufigsten überrascht — und er ist der Grund, warum die Example-Vorlage für QuartzControl sechs ihrer sieben Boxen mit html bestückt: Ein Vorlagenpaket ohne den Baustein Statische Dateien nimmt Schnipsel-Dateien nicht mit, und im Zielprojekt zeigte eine file:-Box dann ins Leere.

YAML und Markup vertragen sich mäßig

Mehrzeiliges HTML in YAML braucht einen Blockskalar. | behält die Zeilenumbrüche, >- faltet sie zu Leerzeichen und schluckt den letzten:

options:
  html: |
    <p>Erste Zeile.</p>
    <p>Zweite Zeile.</p>

Sobald Anführungszeichen, Doppelpunkte und Rautenzeichen im Markup vorkommen — also fast immer —, ist eine Datei der ruhigere Weg.