Zmieniaj ścisły JSON w YAML, który łatwo przeglądać
JSON jest precyzyjny, ale YAML jest często łatwiejszy do odczytania w przykładach konfiguracji, instrukcjach obsługi, dokumentacji API i przykładach infrastruktury. Ten konwerter najpierw parsuje poprawny JSON, a następnie zapisuje odpowiadającą strukturę YAML.
Wynik to czysty punkt wyjścia, a nie asystent do tworzenia YAML. JSON nie zawiera komentarzy, kotwic, aliasów ani niestandardowych znaczników YAML, więc te elementy nie są generowane podczas konwersji.
Jak JSON mapuje się na YAML
- Obiekty stają się mapami YAML.
- Tablice stają się sekwencjami YAML.
- Łańcuchy znaków, liczby, wartości logiczne i null zachowują swoje sparsowane wartości z JSON.
- Białe znaki w źródłowym JSON nie wpływają na strukturę danych.
Dobre zastosowania wygenerowanego wyniku
- Przenieś przykłady odpowiedzi API do dokumentacji opartej na YAML.
- Twórz przykłady konfiguracji z plików JSON.
- Porównuj zagnieżdżone obiekty w bardziej liniowym formacie.
- Przygotuj małe fragmenty YAML przed ręcznym dodaniem komentarzy.
FAQ: JSON na YAML
Dlaczego składnia obiektów JavaScript zawodzi?
Parser oczekuje JSON, a nie JavaScript. Klucze obiektów i stringi muszą być ujęte w cudzysłowy, komentarze nie są dozwolone, a przecinki na końcu są nieprawidłowe.
Czy konwerter doda komentarze lub kotwice YAML?
Nie. JSON nie zawiera komentarzy, kotwic ani aliasów, więc wygenerowany YAML odzwierciedla jedynie sparsowane dane JSON.
Czy powinienem użyć tego wyniku bezpośrednio jako konfiguracji produkcyjnej?
Najpierw to sprawdź. Składnia YAML może być poprawna, a mimo to wymagać komentarzy, wartości specyficznych dla środowiska lub kontroli schematu dla docelowego narzędzia.