YAML

YAML (YAML Ain't Markup Language) is een tekstformaat voor gegevens dat je vooral tegenkomt in configuratiebestanden met de extensie .yaml of .yml. Waar JSON accolades en XML tags nodig heeft, bepaalt in YAML de inspringing de structuur, waardoor een bestand bijna leest als een gewone lijst. De naam stond eerst voor Yet Another Markup Language, maar werd later veranderd om te benadrukken dat YAML om gegevens draait en niet om opmaak.

Een regel als omgeving: productie is een sleutel met een waarde. Regels die je verder inspringt, horen bij de regel erboven, en een streepje aan het begin maakt er een lijstitem van. Die inspringing doe je altijd met spaties, want tabs zijn volgens de specificatie niet toegestaan.

Die leesbaarheid heeft een keerzijde. Eén spatie te veel of te weinig verandert de betekenis of maakt het bestand ongeldig. Parsers die de oude YAML 1.1-regels volgen, lezen bovendien woorden als no en yes als false en true. Dat staat bekend als het Norway-probleem, omdat de landcode NO voor Noorwegen zo ineens een ja/nee-waarde werd. Zet zulke waarden daarom tussen aanhalingstekens.

Op je hosting kom je YAML vooral tegen bij automatisch deployen. Laat je je site via GitHub Actions naar je pakket uploaden, dan staan de stappen in het bestand .github/workflows/deploy.yml in je repository. Controleer zo'n bestand met een YAML-validator voordat je pusht, want één inspringfout en de workflow start niet.