I-convert ang JSON sa YAML JavaScript Object Notation ↔ YAML Ain't Markup Language Libre Online Ligtas

Bakit kino-convert ng mga tao ang JSON sa YAML

Ang JSON ang notasyong gusto ng mga program: mahigpit, siksik at nauunawaan ng bawat wika. Ngunit hindi ito mabait sa tao. Ang mahabang JSON file ay gubat ng mga brace, bracket, panipi at kuwit, na walang lugar para sa komento at may trailing comma na maaaring sumira sa lahat. Ang YAML ang notasyong pinipili ng mga tao kapag kailangan nilang magbasa at mag-edit ng data nang mano-mano. Gumagamit ito ng indentation sa halip na mga brace, pinapayagan ang mga komento at halos nababasa na parang balangkas, kaya ito ang naging paborito para sa configuration: mga build pipeline, kahulugan ng container, mga file ng deployment, mga setting ng static site at mga documentation tool. Kapag dumarating ang data bilang JSON at gusto mo itong gamitin sa anyong kaaya-ayang basahin, kailangan ng conversion. Kaya kino-convert ng mga tao ang JSON sa YAML.

Pang-araw-araw ang mga sitwasyon. Isang developer na may output ng tool sa JSON at gustong gawin itong configuration file. Isang koponang naglilipat ng mga setting mula sa isang sistema patungo sa iba at mas gusto ang nababasang format. Isang manunulat na gustong basahin ang istruktura ng sagot ng API nang walang kalat. Isang estudyanteng gustong makita kung paano nagiging indentation ang mga brace. Sa bawat kaso, pareho ang data, at ang notasyon lang ang nagbabago.

Kino-convert ng pahinang ito ang JSON sa YAML sa loob ng browser mo. Binabasa at isinusulat dito ang file mo, kaya hindi kailanman lumalabas sa device mo ang file, na mahalaga para sa mga configuration file, na madalas na naglalaman ng mga address, pangalan ng mga panloob na sistema at minsan ay mga lihim. At sinasabi ng pahina nang maaga kung ano ang pinananatili ng paglipat at kung ano ang hindi, sa halip na hayaan kang madiskubre ito mismo. Sa ibaba makikita mo kung paano gumagana ang conversion, ano ang nangyayari sa malalim na nesting at mahahabang string at kung paano makakakuha ng maayos na resulta.

Paano gumagana ang conversion

Parehong hugis sa dalawang notasyon

Binabasa ang JSON mo sa loob ng browser mo, at isinusulat bilang YAML ang istruktura nito. Parehong hugis ang hawak ng dalawa, at pinananatili ang lahat sa dalawang direksyon: mga map, listahan, string, numero, boolean at null. Ang object sa JSON ay nagiging mapping sa YAML, ang array ay nagiging sequence, at pinananatili ng mga scalar na halaga ang kanilang mga uri. Ang key na port na may numerong 8080 ay nagbibigay ng port: 8080, at ang key na enabled na may true ay nagbibigay ng enabled: true.

Buong isinusulat ang mga paulit-ulit na istruktura

May paraan ang YAML para iwasan ang pag-uulit, gamit ang mga anchor at alias. Hindi ito ginagamit ng converter. Buong isinusulat ang mga paulit-ulit na istruktura sa halip na bilang mga anchor, kaya diretso pababa ang pagbasa sa file. Medyo pinahahaba nito ang YAML, ngunit walang kailangang hanapin sa ibang lugar, at nauunawaan ng sinumang mambabasa ang bawat bloke nang mag-isa.

Pinananatili ng mga key ang pagkakasunod

Pinananatili ng mga key ang pagkakasunod nila ayon sa JSON. Nababasa ang YAML sa parehong sequence ng pinagmulan, kaya agad na makakahanap ng daan ang sinumang nakakaalam ng JSON.

Ang pinananatili

Lahat ng data

Pinananatili ang lahat, sa dalawang direksyon: mga map, listahan, string, numero, boolean at null. Kung halaga ito sa JSON mo, halaga ito sa YAML, na may parehong uri.

Mga string na kailangang protektahan

Ang ilang string ay mababasa nang mali sa YAML kung isusulat nang hubad: ang salitang true, numerong nasa panipi, tekstong may colon. Inilalagay ng converter sa panipi ang mga ganoong string para bumalik ang mga ito bilang string at hindi maging boolean o numero. Ang JSON string na nagsasabing "true" ay nananatiling string sa YAML.

Unicode

Pinananatili kung ano sila ang mga letrang may accent, simbolo at character mula sa ibang alpabeto, kaya nananatiling nababasa ang file sa ilang wika.

Ang dapat mong malaman bago i-convert ang JSON sa YAML

Ang malalim na nesting ay malalim na indentation

Naglalagay ang YAML ng kahulugan sa indentation nito, kaya ang halagang napupunta nang malalim ang nesting ay nagiging file na malalim ang indentation: nababasa, ngunit hindi maikli. Ang JSON na puno na walong antas ay nagbibigay ng mga linyang nagsisimula nang malayo sa kaliwang margin. Kung maging mahirap ito, isaalang-alang ang pagpapatag ng istruktura sa pinagmulan nito.

Binabalot ang mahahabang string

Binabalot ang mahahabang string sa mga isandaang column, na nagbabago kung saan nahuhulog ang mga line break nang hindi binabago ang halaga. Ang talatang iisang mahabang linya sa JSON ay lilitaw sa ilang linya sa YAML, ngunit pareho ang teksto. Natatanggap ng program na bumabasa ng YAML ang orihinal na string.

Hindi maaaring mag-imbento ng mga komento

Pinapayagan ng YAML ang mga komento, ngunit walang dala ang JSON, kaya wala rin ang resulta. Maaari kang magdagdag ng mga paliwanag nang mano-mano pagkatapos, na isa sa mga pangunahing dahilan para magkaroon ng file sa YAML sa unang lugar.

Paano i-convert ang JSON sa YAML dito

Idagdag ang file mo

Ihulog ang JSON file sa pahina o piliin ito mula sa device mo. Binabasa ito sa loob ng browser mo at hindi ina-upload.

I-convert

Pindutin ang button. Sandali lang ang file na may karaniwang laki. Iwanang bukas ang pahina hanggang matapos.

I-download at suriin

I-download ang YAML at buksan ito sa text editor. Tingnan ang simula at ang dulo, at tiyaking ang istruktura at mga uri ay ayon sa inaasahan mo.

Mas malapitang pagtingin sa JSON at YAML

Dalawang notasyon para sa parehong data

Idinisenyo ang JSON para madaling basahin at isulat ng mga program. Idinisenyo ang YAML para madali para sa mga tao. Magkatugma sila nang husto kaya halos subset ng YAML ang JSON, at kadalasang nababasa ng YAML reader ang JSON. Kaya ang pag-convert ng JSON sa YAML ay hindi pagbabago ng data kundi pagbibihis muli rito, sa anyong may lugar para sa mga tala at walang kalat na bantas.

Bakit kailangan ng ingat ang indentation

Dahil umaasa ang YAML sa indentation, binabago ng linyang hindi nakahanay ang kahulugan. Pare-parehong isinusulat ng converter ang indentation, gamit ang mga espasyo at may parehong lapad sa bawat antas, kaya tama ang file kung paano ito ginawa. Kapag in-edit mo ito sa susunod, panatilihin ang parehong lapad, at iwasan ang mga tab, na hindi pinapayagan ng YAML para sa indentation.

Nababasa ngunit hindi laging mas maikli

Madalas na inilalarawan ang YAML bilang mas siksik kaysa sa JSON, dahil inaalis nito ang mga brace at ang mga panipi sa paligid ng mga key. Totoo ito para sa flat na data. Para sa malalim na nested na data, ang indentation ay maaaring magpahaba rito sa dami ng character. Nasa pagiging nababasa ang pakinabang, hindi sa laki.

Mga karaniwang sitwasyon nang detalyado

Paggawang configuration ng output ng tool

Madalas na ini-print ng mga tool ang kanilang mga setting o resulta bilang JSON. I-convert ang JSON sa YAML, magdagdag ng mga komento at itago ito bilang configuration file na pinapanatili ng mga tao.

Paglilipat ng mga setting sa pagitan ng mga sistema

Ang paglilipat ng configuration mula sa sistemang gumagamit ng JSON patungo sa gumagamit ng YAML ay usapin ng isang conversion, kasunod ang pagtiyak na tinatanggap ng target ang mga key.

Pagbasa ng sagot ng API

Ang sagot ng API ay maaaring umabot sa daan-daang linya ng mga brace. Sa YAML, nababasa ang parehong data na parang balangkas, at makikita mo ang istruktura sa isang sulyap.

Pagtuturo at dokumentasyon

Ang pagpapakita ng parehong data sa dalawang notasyon ay mahusay na paraan para ituro kung paano gumagana ang structured data. Ang dokumentasyong gumagamit ng mga halimbawa sa YAML ay madalas na mas madaling basahin.

Praktikal na payo bago i-convert ang JSON sa YAML

Tiyaking balido ang JSON

Ang nawawalang kuwit o nawawalang panipi ay magpapatigil sa conversion. Kung may iniulat na error ang pahina, buksan ang file sa editor na nagha-highlight ng mga problema sa JSON at ayusin ang linyang itinuturo nito.

Ipatag kung saan mo kaya

Kung mas malalim ang istruktura kaysa sa kailangan, gawing simple muna ito. Ang mas patag na istruktura ay nagbibigay ng YAML na mas madaling basahin at i-edit.

Isipin ang gagamit

Tingnan kung ano ang babasa ng YAML. Ang ilang tool ay umaasa ng partikular na mga pangalan ng key at mga uri, at mas madaling i-adjust ang JSON nang maaga kaysa i-edit ang YAML pagkatapos.

Malalaking file

Tumatakbo ang lahat sa device mo, kaya nangangailangan ng memorya ang napakalaking file. Para sa mga file na ilang megabyte, gumamit ng computer, at hatiin ang data kung nahihirapan ang pahina.

Mga tanong ng mga tao bago mag-convert

Mababago ba ang data ko?

Hindi. Pinananatili ang lahat sa dalawang direksyon: mga map, listahan, string, numero, boolean at null.

Bakit nahahati sa ilang linya ang mahahaba kong string?

Binabalot ang mahahabang string sa mga isandaang column. Binabago nito kung saan nahuhulog ang mga line break nang hindi binabago ang halaga.

Bakit napakalalim ng indentation ng file ko?

Dahil malalim ang nesting ng data, at ipinapahayag ng YAML ang nesting sa pamamagitan ng indentation.

Nasaan ang mga anchor?

Buong isinusulat ang mga paulit-ulit na istruktura sa halip na bilang mga anchor, kaya diretso pababa ang pagbasa sa file.

Ina-upload ba ang file ko?

Hindi. Tumatakbo ang conversion sa iyong browser at hindi kailanman lumalabas sa device mo ang file.

Makakabalik ba ako sa JSON?

Oo. Binabasa muli ng YAML sa JSON ang file, bagaman hindi mananatili ang anumang komentong idinagdag mo.

Matalinong pagpili kapag kino-convert ang JSON sa YAML

Kailangan ba talaga ang YAML?

Kung JSON ang binabasa ng tool na tatanggap, panatilihin ang JSON. Mag-convert kapag kailangang basahin at i-edit ng mga tao ang file, o kapag kinakailangan ng tool ang YAML.

Iba pang target

Kung markup file ang destinasyon, maaaring sumunod ang JSON sa XML. Para sa mga talahanayan, nagsisilbi sa mga spreadsheet ang JSON sa CSV at JSON sa XLSX.

Itago ang JSON

Ang JSON ang master kung galing ito sa isang program. Itago ito, at buuin muli ang YAML kapag nagbago ito.

Pagkuha ng magandang resulta pagkatapos ng conversion

Magdagdag ng mga komento

Wala nito ang resulta, at dito nangingibabaw ang YAML. Magdagdag ng maikling tala sa ibabaw ng bawat bloke para sabihin kung ano ang ginagawa nito at anong mga halaga ang pinapayagan.

Suriin ang mga uri

Tingnan ang mga halagang gaya ng mga bersyon, code at flag. Tiyaking mga string ang mga ito kung saan string ang nilayon mo at mga numero kung saan numero ang nilayon mo.

Panatilihing pare-pareho ang indentation

Kapag nag-e-edit ka, gumamit ng mga espasyo at panatilihin ang parehong lapad sa bawat antas. Ang editor na nagpapakita ng whitespace at sumusuri sa YAML ay magliligtas sa iyo mula sa mga error.

Paghahanda ng JSON para maayos itong ma-convert

Panatilihin itong regular

Kapag kino-convert mo ang JSON sa YAML, pinakamahusay na nako-convert ang regular na data: pare-parehong mga key at malinaw na mga uri. Ang irregular na data ay nagbibigay ng tamang ngunit magulong resulta.

Pangalanan nang malinaw ang mga key

Babasahin ng mga tao ang YAML, kaya pumili ng mga key na nagsasabi ng ibig sabihin ng mga ito. Mas madaling panatilihin ang configuration kapag payak ang mga pangalan nito.

Subukan muna sa maliit na bahagi

Kung malaki ang file mo, kumuha ng seksyon sa test file at i-convert iyon. Ang mabilis na pagtingin sa resulta ay nagpapakita kung ang istruktura ay ayon sa inaasahan mo.

Pagtatrabaho sa YAML pagkatapos mong i-convert ang JSON sa YAML

Idagdag ang mga tala na hindi kayang hawakan ng JSON

Ang unang gagawin sa bagong na-convert na file ay basahin ito mula sa itaas at magdagdag ng mga komento kung saan malilito ang estranghero. Mas mahalaga ang maikling linya sa ibabaw ng seksyon na nagsasabi kung ano ang kinokontrol nito kaysa sa isang pahina ng dokumentasyong itinatabi sa ibang lugar, dahil katabi nito ang bagay na inilalarawan nito. Ito ang pangunahing bentahe na makukuha mo kapag kino-convert mo ang JSON sa YAML.

Pagsama-samahin ang magkakaugnay na mga setting

Pinananatili ng mga key ang pagkakasunod nila sa JSON, na maaaring pagkakasunod na nagkataong inilabas ng isang program. Sa YAML, malaya mong ayusin muli ang mga ito para magkakatabi ang magkakaugnay na mga setting, na may blangkong linya sa pagitan ng mga grupo. Dahil walang kahulugan para sa karamihan ng mambabasa ang pagkakasunod ng mga key sa isang mapping, ligtas ito, ngunit suriin ang tool na ginagamit mo kung sakaling mahalaga ito rito.

Suriin kung ano ang inaasahan ng tool na tatanggap

Ang balidong YAML file ay hindi kinakailangang balidong configuration. Umaasa ang mga tool ng partikular na mga key at uri, at ang ilan ay mahigpit sa mga hindi kilalang key. Pagkatapos ng conversion, ihambing ang file sa dokumentasyon ng tool, at patakbuhin ang sarili nitong checker kung mayroon.

Gumamit ng version control

Madaling ihambing linya-linya ang configuration sa YAML, na ginagawa itong angkop para sa version control. I-commit ang na-convert na file at hayaang makita ng mga kasamahan ang bawat pagbabago bilang malinaw na pagkakaiba, na mas mahirap nang malaki sa iisang linya ng minified na JSON.

Bantayan ang mga lihim

Minsan ay may kasamang mga token at password ang JSON na na-export mula sa mga tool. Dahil nangyayari ang conversion sa browser mo, walang lumalabas sa device mo, ngunit maglalaman ang YAML file ng parehong mga lihim. Alisin ang mga ito, o ilipat sa mas ligtas na lugar, bago mo i-commit o ibahagi ang file.

Bantayan ang indentation kapag nag-e-edit

Kapag nagsimula ka nang mag-edit nang mano-mano, ang pangunahing panganib ay linyang isang espasyo ang layo sa tamang lugar. Gumamit ng editor na nagpapakita ng whitespace at sumusuri sa YAML habang nagta-type ka, at panatilihin ang parehong lapad sa bawat antas, gaya ng ginawa ng converter.

Mag-convert muli kapag nagbago ang pinagmulan

Kung ang JSON ay ginawa ng isang program at nagbabago paminsan-minsan, i-convert muli ang JSON sa YAML para sa bawat bagong bersyon, at pagsamahin ang mga komento mo mula sa lumang file sa bago. Ang comparison tool ay ginagawa itong usapin ng ilang minuto.

Privacy at paghawak

Bakit mahalaga ang lokal na conversion para sa configuration

Madalas na naglalaman ang mga configuration file ng mga address, pangalan ng mga panloob na sistema at minsan ay mga key at password. Maraming online converter ang nag-a-upload ng file mo sa server, pinoproseso ito at ibinabalik ang resulta, at sa ilang panahon ay nasa makinang hindi mo kontrolado ang kopya. Dito, ang sarili mong browser ang gumagawa ng trabaho, kaya nananatili ang file sa device mo.

Ano ang nangyayari kapag umalis ka

Kapag isinara mo ang pahina, nawawala sa browser ang na-convert na file, kaya i-download muna ito. Walang anumang tungkol sa file mo ang itinatago.

Kung may magkamali

Sinasabi ng pahina na hindi balidong JSON ang file

Maaaring may nawawalang kuwit, nawawalang panipi o bracket na hindi nagsasara. Buksan ang file sa editor na nagha-highlight ng mga error sa JSON at ayusin ang linyang itinuturo nito.

Tinatanggihan ng tool ang YAML

Suriin ang mga pangalan ng key at ang mga uring inaasahan nito. Balido ang YAML, ngunit maaaring gusto ng tool ng ibang mga pangalan o ibang istruktura.

Nagyeyelo ang pahina sa malaking file

Tumatakbo ang lahat sa device mo, at nangangailangan ng memorya ang malaking file. Subukan ulit sa computer, o hatiin ang data.

Mga kaugnay na tool

Sakop ng parehong pamilya ng mga tool ang mga kalapit na gawain. Para bumalik, gamitin ang YAML sa JSON. Para sa markup, nagko-convert sa pagitan ng dalawang iyon ang JSON sa XML at XML sa JSON. Para sa mga talahanayan, may JSON sa CSV, CSV sa JSON, JSON sa XLSX at XLSX sa JSON.

Isang halimbawang nalutas

Sabihin nating ini-print ng isang tool ang mga setting nito bilang JSON file na 150 linya, at gusto mong itago ang mga ito sa repository mo bilang configuration na mababasa at makokomentohan ng mga kasamahan. Ihuhulog mo ang file dito at pipindutin ang button. Pagkalipas ng sandali, magda-download ka ng YAML na humigit-kumulang 90 linya kung saan nababasa ang istruktura na parang balangkas. Magdaragdag ka ng komento sa ibabaw ng bawat seksyon, ico-commit ito at sasabihin sa koponan kung saan mag-e-edit. Mananatili ang JSON bilang output ng tool.

Maikling checklist

Bago mag-convert

Tiyaking balido ang JSON. Gawing simple ang malalim na nesting kung kaya mo. Itago ang JSON.

Habang nagko-convert

Manatili sa pahina hanggang handa na ang file.

Pagkatapos mag-convert

Buksan ang YAML, suriin ang istruktura at mga uri, magdagdag ng mga komento at subukan ito sa tool na babasa nito.

Mga karaniwang pagkakamali

Pag-asang mas maikli ang file

Ang malalim na nesting ay gumagawa ng malalim na indentation. Mas nababasa ang YAML, hindi laging mas maliit.

Pag-e-edit gamit ang mga tab

Hindi pinapayagan ng YAML ang mga tab para sa indentation. Gumamit ng mga espasyo.

Pagkawala ng pinagmulan

Kung galing sa isang program ang JSON, itago ito at buuin muli ang YAML kapag nagbago ito.

Nananatili sa device mo ang file mo

Lokal na nangyayari ang conversion. Binabasa ng sarili mong browser ang file mo, isinusulat muli roon at ibinabalik bilang YAML. Walang ina-upload, kaya walang kopya sa server at walang ibang makakabasa nito. Para sa configuration na may pribadong nilalaman, iyon ang ligtas na paraan para i-convert ang JSON sa YAML.

Buod

Para i-convert ang JSON sa YAML dito, ihulog ang file at pindutin ang button. Binabasa at isinusulat ito sa browser mo, kaya hindi kailanman lumalabas sa device mo ang file. Pinananatili ang lahat, sa dalawang direksyon: mga map, listahan, string, numero, boolean at null. Buong isinusulat ang mga paulit-ulit na istruktura sa halip na bilang mga anchor, kaya diretso pababa ang pagbasa sa file. Naglalagay ang YAML ng kahulugan sa indentation nito, kaya ang halagang napupunta nang malalim ang nesting ay nagiging file na malalim ang indentation, nababasa ngunit hindi maikli. Binabalot ang mahahabang string sa mga isandaang column, na nagbabago kung saan nahuhulog ang mga line break nang hindi binabago ang halaga. Pinananatili ng mga key ang pagkakasunod nila ayon sa JSON.