Ihmisen luettavaksi suunniteltu tiedostomuoto, jolla kirjoitetaan asetuksia ja rakenteista dataa sisennysten avulla.
YAML · Koodaus
YAML on datan esitysmuoto, jota käytetään erityisesti asetustiedostoissa. Nimi on rekursiivinen lyhenne sanoista "YAML Ain't Markup Language". Määrittelyn mukaan YAML on ihmisystävällinen, ohjelmointikielestä riippumaton tapa tallentaa dataa. Rakenne ilmaistaan sisennyksillä: avain ja arvo erotetaan kaksoispisteellä, ja listan kohdat alkavat viivalla. Tiedostot päättyvät yleensä .yaml- tai .yml-päätteeseen.
YAML ja JSON esittävät samaa asiaa: avain-arvopareja, listoja ja sisäkkäisiä rakenteita. YAML 1.2 on määritelty JSONin ylijoukoksi, joten kelvollinen JSON on myös kelvollista YAMLia. YAMLissa on vähemmän merkkejä ja siihen voi kirjoittaa kommentteja, siksi sitä käytetään tiedostoissa, joita ihmiset muokkaavat käsin. JSON on tavallisempi ohjelmien välisessä datassa, kuten API-vastauksissa. Nykyinen versio on YAML 1.2.2 vuodelta 2021.
Vibekoodauksessa YAML tulee vastaan asetuksissa: GitHub Actionsin työnkulut, Docker Composen palvelut ja monet julkaisupalvelut käyttävät sitä. Tavallisin virhe on sisennys. Määrittely kieltää sarkainmerkit sisennyksessä, joten käytä välilyöntejä, ja yksikin väärin sisennetty rivi muuttaa rakenteen. Kun pyydät tekoälyä kirjoittamaan YAML-tiedoston, liitä mukaan virheilmoitus tai palvelun dokumentaation esimerkki, niin rakenne osuu oikein.
YAML on tiedostomuoto rakenteiselle datalle, jota on helppo lukea ja muokata käsin. Sitä käytetään erityisesti asetustiedostoissa, kuten GitHub Actionsissa ja Docker Composessa. Rakenne ilmaistaan sisennyksillä.
Molemmat esittävät samanlaista dataa. YAML käyttää sisennyksiä ja sallii kommentit, joten se sopii käsin muokattaviin asetuksiin. JSON käyttää aaltosulkeita ja lainausmerkkejä, ja se on tavallisempi ohjelmien välisessä tiedonsiirrossa. YAML 1.2 on JSONin ylijoukko.
Useimmiten syy on sisennys: sarkainmerkki välilyöntien sijaan tai rivi, joka on sisennetty eri tasolle kuin viereiset. Tarkista myös, että kaksoispisteen jälkeen on välilyönti. Editorin YAML-laajennus näyttää nämä virheet heti.
nimi: Vibekoodaus on YAML-avain ja sen arvo
Listan kohdat kirjoitetaan omille riveilleen viivalla: - react ja - nextjs
.github/workflows/testit.yml määrittää GitHub Actionsin työnkulun
docker-compose.yml kertoo, mitkä kontit käynnistetään ja miten ne liittyvät toisiinsa
# Tämä on kommentti, jota JSON ei salli mutta YAML sallii
"Muuta tämä JSON-asetustiedosto YAML-muotoon ja lisää kommentit jokaiselle asetukselle"
Tutustu kaikkiin vibekoodauksen termeihin.