Preskoči na vsebino

YAML oblikovalnik

Preverjanje in oblikovanje YAML s jasnim sporočanjem napak vrstice in stolpca.

Vhod
Izhod

YAML oblikovalnik

YAML se pojavlja povsod — od Kubernetes manifestov do GitHub Actions delovnih takov in konfiguracije aplikacij — in je nemilosrdna do presledkov: en napačno poravnan prostor uniči celoten dokument. To orodje preveri sintakso YAML dokumenta in ga ponovno natisne dosledno tako da lahko ujamete zlomljeni pipeline ali datoteko konfiguracije preden se sploh zažene.

Prilepite dokument in se takoj analizira. Veljavni vnos se vrne preoblikovan s vašo izbrano širino uvlake; neveljaven vnos vrne točno vrstico in stolpec problema skupaj s onim kar je parser pričakoval da boste vedeli kateri od štiridesetih vrstic ima zablelano tabulator. Dve preverjanju se izvršita samodejno na vsakem veljavnem dokumentu: opozorilo če katera koli vrstica uporablja tabulator za uvlako saj specifikacija YAML prepoveduje tabulatorje čeprav mnogi urejevalniki jih privzeto vstavljajo in štetje duplikatnih ključev znotraj istega preslikovanja ki ga YAML dovoljuje vendar ponavadi pomeni da samo zadnja vrednost ostane in ostali so mrtva teža.

Možnosti nadzirajo obliko in presledke. Razvrsti ključe po abecedi da dobiš determinirani primerljiv dokument — koristno ko ima generirani config neprestano hrupne git razlike brez funkcionalnega razloga. Stiskanje kratkih seznamov spremeni skalarno zaporedje kot tvorečna lista oznak v eno vrstico v flow slogu kot je tags: [a, b, c]; pustite jo onemogočeno in vse vstavitve flow seznamov v vnos se razširijo nazaj na en predmet na vrstico kar je običajno lažje pregled in spajanje. Odstranjevanje komentarjev izbriše tako polne vrstice kot zaključne hash komentarje za različico namenjeno minifikaciji ali deljenju brez opomb medtem ko njihovo spreminjanje ohrani komentarje dokumenta točno kot so napisani.

Oblikovanje poteka v celoti v vašem brskalniku. YAML ki ga prilepite se nikoli ne naloži zapiše ali pošlje nikamor — analizira se preoblikuje in prikaže lokalno ter izgine takoj ko zaprete ali ponovno naložite zavihek.

FAQ

Ali je moj YAML naložen nekje?
Ne. Analiza in oblikovanje potekajo v celoti v JavaScript motorju vašega brskalnika. Ničesar kar prilepite se ne pošlje na strežnik se ne zapiše ali shrani zunaj vašega naprave.
Kaj pomenita vrstica in stolpec v napaki?
Kažeta na točno mesto v vašem dokumentu kjer je parser nehal razumevati preštevajoč od vrha in leve strani besedila ki ste ga prilepili. Navaja tudi kaj je pričakoval tam kot je skladna uvlaka ali vrednost za dvopičjem.
Zakaj opozarja na tabulatorje?
YAML specifikacija prepoveduje uporabo znakov tabulatorja za uvlako — dovoljeni so samo presledki. Dokument z uvlako tabulatorja se lahko analizira neskladno ali popolnoma ne uspe v drugi implementaciji YAML zato orodje to označit tudi kadar se vaš vnos tukaj še vedno analizira.
Kaj se zgodi z duplikativnimi ključi?
YAML dovoljuje ponovitev ključa znotraj istega preslikovanja in večina parserjev tiho obdrži samo zadnjo vrednost. Orodje tega ne zavrne vendar šteje duplikate in označi prizadeto vrstico da se lahko odločite ali je bilo namerno.
Ali lahko popravi neveljaven YAML zame?
Ne — vam natančno pravi kje je analiza spodletela da lahko popravite vir. Samodejno ugibanje popravka za zlomljeno uvlako bi tvegalo spremembo pomena dokumenta.