YAML-Syntax mit Beispielen
YAML ist das häufigste Format für Konfigurationsdateien. Mit diesen Regeln liest und schreibst du es ohne Fehler.
Die Grundbausteine
| Baustein | YAML | Bedeutung |
|---|---|---|
| Zuordnung | name: web-server | Ein Schlüssel mit einem Wert |
| Verschachtelte Zuordnung | Unterschlüssel um 2 Leerzeichen einrücken | Ein Objekt in einem Objekt |
| Liste | - erster Eintrag | Ein Eintrag einer Liste |
| Liste in einer Zeile | [a, b, c] | Eine kurze Liste in einer Zeile |
| Kommentar | # Notiz | Wird von Programmen ignoriert |
| Nullwert | ~, null oder nichts | Kein Wert |
Mehrzeiliger Text
Mit | bleiben Zeilenumbrüche genau erhalten, ideal für Skripte und Zertifikate. Mit > werden die Zeilen zu einem Absatz zusammengefügt, ideal für lange Beschreibungen. Ein - nach dem Zeichen (|- oder >-) entfernt den letzten Zeilenumbruch.
Anker und mehrere Dokumente
- Schreibe &name vor einen Wert, um ihn zu markieren, und später *name, um ihn wiederzuverwenden.
- Mit <<: *name fügst du eine wiederverwendete Zuordnung in eine andere ein.
- Trenne mehrere Dokumente in einer Datei mit einer Zeile aus drei Bindestrichen (---).
- Beende ein Dokument mit ..., wenn ein Tool ein ausdrückliches Ende braucht.