تبدیل JSON به YAML JavaScript Object Notation ↔ YAML Ain't Markup Language رایگان آنلاین امن
فایل JSON خود را رها کنید و YAML تحویل بگیرید. خواندن و نوشتن فایل همین‌جا، در مرورگر شما انجام می‌شود، پس فایل هرگز از دستگاهتان خارج نمی‌شود — و اینکه این تبدیل چه چیزی را حفظ می‌کند و چه چیزی را نمی‌تواند، در ادامه نوشته شده است تا مجبور نباشید خودتان کشفش کنید.
فایل خود را تبدیل کنید
فایل JSON خود را اینجا رها کنید یا یکی را انتخاب کنید.
فایل شما هرگز از این دستگاه بیرون نمی‌رود. همه‌چیز در مرورگر شما اجرا می‌شود.
بدون بارگذاری
تبدیل از JSON
تبدیل به JSON
این قالب‌ها از کجا آمده‌اند
CSV قدیمی‌ترین و کم‌استانداردترین آن‌هاست: جدولی که به شکل خطوط متن نوشته می‌شود، از دههٔ 1970 در کار بوده و تنها در سال 2005 به‌صورت مکتوب توصیف شد، یعنی زمانی که هر برنامه‌ای از قبل خودش تصمیم گرفته بود جداکننده چیست و چه زمانی باید گیومه گذاشت. XML در سال 1998 از SGML برآمد، برای اسنادی که باید ساختاری سخت‌گیرانه داشته باشند و در برابر یک طرح‌واره (schema) بررسی شوند. JSON را داگلاس کراکفورد حدود سال 2001 از دل جاوااسکریپت بیرون کشید و عمداً به اشیاء، آرایه‌ها، اعداد و رشته‌ها تقلیلش داد — و همین حداقل‌گرایی دلیل آن است که وب را در دست گرفت. YAML پسرعموی خواناتر آن است که در آن تورفتگی کاری را می‌کند که در جاهای دیگر کروشه و آکولاد می‌کنند. تنها نکته‌ای که هنگام تبدیل میان آن‌ها اهمیت دارد: CSV تخت است، شبکه‌ای از سطر و ستون، درحالی‌که JSON، XML و YAML درخت هستند.
کجا با آن‌ها روبه‌رو می‌شوید
CSV همان چیزی است که صفحه‌گسترده خروجی می‌دهد و حسابدار، پلتفرم فروشگاهی یا صورت‌حساب بانکی به شما تحویل می‌دهد. JSON زبانی است که سرویس‌های وب با آن حرف می‌زنند و فایل‌های پیکربندی روزبه‌روز بیشتر به آن نوشته می‌شوند. XML در سیستم‌های سازمانی قدیمی‌تر، در استانداردهای صدور فاکتور و درون خود قالب‌های اداری باقی مانده است. YAML جایی است که انسان‌ها تنظیمات را با دست می‌نویسند. تبدیل میان آن‌ها کار روزمرهٔ انتقال داده از جایی است که تولید شده به جایی که لازم است.
پرسش‌های متداول
فایل CSV من در Excel به‌صورت یک ستون باز شد. چرا؟
چون صفحه‌گستردهٔ شما جداکنندهٔ دیگری انتظار داشت. Excel از جداکنندهٔ فهرست در تنظیمات منطقه‌ای رایانه پیروی می‌کند، که در هر جایی که ویرگول پیش‌تر علامت اعشار است — یعنی بیشتر اروپای قاره‌ای — نقطه‌ویرگول است. فایلی که با ویرگول جدا شده باشد آن‌گاه مانند یک ستون واحد از متن دیده می‌شود. به‌جای دوبار کلیک کردن روی فایل، از پنجرهٔ درون‌ریزی (import) استفاده کنید و جداکننده را صریحاً مشخص کنید. همین تنظیم منطقه‌ای دلیل آن است که گاهی 3.5 به‌صورت یک تاریخ وارد می‌شود.
چرا JSON تودرتوی من نمی‌تواند به یک صفحه‌گستردهٔ مرتب تبدیل شود؟
چون صفحه‌گسترده تخت است و JSON درخت. یک سطر در هر ستون فقط یک مقدار می‌تواند داشته باشد؛ اما یک شیء JSON می‌تواند فهرستی درون یک فیلد درون فهرستی دیگر داشته باشد. تبدیل یعنی انتخاب شیوهٔ تخت کردن آن: یا به هم چسباندن نام‌های تودرتو در یک عنوان ستون بلند، یا تکرار سطر والد به‌ازای هر فرزند. هر دو سازش هستند و هیچ‌کدام به‌طور خودکار قابل بازگشت نیست — به همین دلیل بازگشت از صفحه‌گسترده به شکل اصلی معمولاً به تصمیم یک انسان نیاز دارد.
آیا فایل کیفیتش را از دست می‌دهد؟
بستگی دارد که دو قالب چه چیزی را می‌توانند نگه دارند. تبدیل میان قالب‌هایی که همان چیز را ذخیره می‌کنند — مثلاً PNG به BMP یا WAV به FLAC — هیچ چیزی را از دست نمی‌دهد. تبدیل به قالبی که برای صرفه‌جویی در فضا اطلاعات را دور می‌ریزد، مانند JPEG یا MP3، هر بار کمی کیفیت از دست می‌دهد و تبدیل دوباره آن را برنمی‌گرداند. هر جا انتخابی وجود داشته باشد، این صفحه به‌جای ساخت کوچک‌ترین فایل، به حفظ کیفیت اصلی گرایش دارد.
آیا فایل من جایی بارگذاری می‌شود؟
نه. تبدیل درون مرورگر شما و روی دستگاه خودتان انجام می‌شود؛ فایل هرگز از آن خارج نمی‌شود و اینجا سروری نیست که بتواند آن را دریافت کند. به همین دلیل است که محدودیت یک فایل بزرگ حافظه خودِ شماست، نه بارگذاری، و به همین دلیل است که هیچ چیزی که تبدیل می‌کنید نمی‌تواند در لاگ‌های کسی ظاهر شود — از جمله لاگ‌های ما. ابزارهای صوت و ویدیو، اولین باری که از آن‌ها استفاده می‌کنید، موتور تبدیل خود را از همین سایت دریافت می‌کنند، حدود سی مگابایت و فقط یک بار؛ پس از آن کار باز هم کاملاً روی دستگاه شما انجام می‌شود.
چرا مردم JSON را به YAML تبدیل می‌کنند
JSON نمادگذاری‌ای است که برنامه‌ها دوستش دارند: سخت‌گیر، فشرده و قابل فهم برای هر زبان. اما با آدم‌ها مهربان نیست. فایل JSON بلند انبوهی از آکولاد، کروشه، گیومه و ویرگول است، بدون جا برای توضیح و با ویرگول انتهایی‌ای که می‌تواند همه‌چیز را خراب کند. YAML نمادگذاری‌ای است که آدم‌ها وقتی باید داده را با دست بخوانند و ویرایش کنند برمی‌گزینند. به جای آکولاد از تورفتگی استفاده می‌کند، توضیح را مجاز می‌داند و تقریباً مثل یک طرح کلی خوانده می‌شود، و به همین دلیل محبوب پیکربندی شد: خط لولهٔ ساخت، تعریف کانتینر، فایل‌های استقرار، تنظیمات سایت‌های ایستا و ابزارهای مستندسازی. وقتی داده به شکل JSON می‌رسد و می‌خواهید با آن به شکلی خوشایند برای خواندن کار کنید، تبدیل لازم است. به همین دلیل مردم JSON را به YAML تبدیل می‌کنند.
موقعیت‌ها روزمره‌اند. توسعه‌دهنده‌ای که خروجی ابزاری را به شکل JSON دارد و می‌خواهد آن را به فایل پیکربندی تبدیل کند. تیمی که تنظیمات را از سیستمی به سیستم دیگر می‌برد و قالب خوانا را ترجیح می‌دهد. نویسنده‌ای که می‌خواهد ساختار پاسخ یک API را بدون شلوغی بخواند. دانشجویی که می‌خواهد ببیند آکولادها چگونه به تورفتگی نگاشت می‌شوند. در هر مورد داده یکی است و فقط نمادگذاری عوض می‌شود.
این صفحه JSON را در مرورگر شما به YAML تبدیل می‌کند. فایل شما همین‌جا خوانده و نوشته می‌شود و هرگز دستگاه شما را ترک نمی‌کند، که برای فایل‌های پیکربندی اهمیت دارد، چون اغلب نشانی‌ها، نام سیستم‌های داخلی و گاهی رمزها را در خود دارند. و صفحه از پیش به شما می‌گوید این گذار چه چیزی را نگه می‌دارد و چه چیزی را نمی‌تواند، به جای آنکه خودتان بعداً کشفش کنید. در ادامه می‌خوانید تبدیل چگونه کار می‌کند، با تودرتویی عمیق و رشته‌های بلند چه می‌شود و چگونه نتیجه‌ای مرتب بگیرید.
تبدیل چگونه کار می‌کند
همان شکل‌ها در هر دو نمادگذاری
JSON شما داخل مرورگرتان خوانده می‌شود و ساختارش به صورت YAML نوشته می‌شود. این دو شکل‌های یکسانی دارند و همه‌چیز در هر دو جهت حفظ می‌شود: نگاشت‌ها، فهرست‌ها، رشته‌ها، عددها، بولی‌ها و null. شیء در JSON به نگاشت در YAML تبدیل می‌شود، آرایه به دنباله، و مقدارهای ساده نوعشان را نگه می‌دارند. کلید port با عدد 8080 می‌شود port: 8080 و کلید enabled با true می‌شود enabled: true.
ساختارهای تکراری به طور کامل نوشته می‌شوند
YAML راهی برای پرهیز از تکرار دارد، با لنگرها و نام‌های مستعار. مبدل از آن استفاده نمی‌کند. ساختارهای تکراری به جای لنگر به طور کامل نوشته می‌شوند، پس فایل مستقیم از بالا به پایین خوانده می‌شود. این YAML را کمی بلندتر می‌کند، اما هیچ چیز در آن نیاز ندارد جای دیگری جست‌وجو شود و هر خواننده‌ای هر بلوک را به تنهایی می‌فهمد.
کلیدها ترتیبشان را نگه می‌دارند
کلیدها ترتیبی را که در JSON داشتند نگه می‌دارند. YAML با همان توالی منبع خوانده می‌شود، پس کسی که JSON را می‌شناسد فوراً راهش را پیدا می‌کند.
چه چیزی حفظ می‌شود
هر چیزی که داده است
همه‌چیز در هر دو جهت حفظ می‌شود: نگاشت‌ها، فهرست‌ها، رشته‌ها، عددها، بولی‌ها و null. اگر در JSON شما مقدار بود، در YAML هم مقدار است، با همان نوع.
رشته‌هایی که به حفاظت نیاز دارند
بعضی رشته‌ها اگر بدون گیومه در YAML نوشته شوند اشتباه خوانده می‌شوند: کلمهٔ true، عددی داخل گیومه، متنی که دونقطه دارد. مبدل چنین رشته‌هایی را داخل گیومه می‌گذارد تا به صورت رشته برگردند و به بولی یا عدد تبدیل نشوند. رشتهٔ JSON که «true» می‌گوید در YAML رشته می‌ماند.
یونی‌کد
حروف دارای نشانه، نمادها و نویسه‌های الفباهای دیگر همان‌طور که هستند حفظ می‌شوند، پس فایلی به چند زبان خوانا می‌ماند.
آنچه پیش از تبدیل JSON به YAML باید بدانید
تودرتویی عمیق یعنی تورفتگی عمیق
YAML معنا را در تورفتگی‌اش می‌گذارد، پس مقداری که عمیقاً تودرتو شده به فایلی با تورفتگی عمیق تبدیل می‌شود: خوانا، اما نه کوتاه. درخت JSON هشت‌سطحی خط‌هایی می‌دهد که از حاشیهٔ چپ فاصلهٔ زیادی شروع می‌شوند. اگر این دست‌وپاگیر شد، مسطح کردن ساختار را در منبعش در نظر بگیرید.
رشته‌های بلند شکسته می‌شوند
رشته‌های بلند در حدود صد ستون شکسته می‌شوند، که جای شکست خط را عوض می‌کند بی‌آنکه مقدار را تغییر دهد. پاراگرافی که در JSON یک خط بلند بود در YAML در چند خط ظاهر می‌شود، اما همان متن است. برنامه‌ای که YAML را می‌خواند رشتهٔ اصلی را دریافت می‌کند.
توضیح را نمی‌شود اختراع کرد
YAML توضیح را مجاز می‌داند، اما JSON هیچ توضیحی ندارد، پس نتیجه هم ندارد. می‌توانید بعداً با دست توضیح اضافه کنید، که یکی از دلایل اصلی داشتن فایل به شکل YAML از اول است.
چگونه اینجا JSON را به YAML تبدیل کنیم
فایل خود را اضافه کنید
فایل JSON را روی صفحه رها کنید یا از دستگاه خود انتخاب کنید. داخل مرورگر شما خوانده می‌شود و بارگذاری نمی‌شود.
تبدیل کنید
دکمه را فشار دهید. فایلی با اندازهٔ معمولی لحظه‌ای طول می‌کشد. صفحه را تا پایان کار باز نگه دارید.
دانلود کنید و بررسی کنید
YAML را دانلود کنید و در ویرایشگر متن باز کنید. به ابتدا و انتها نگاه کنید و بررسی کنید ساختار و نوع‌ها همان است که انتظار دارید.
نگاهی دقیق‌تر به JSON و YAML
دو نمادگذاری برای یک داده
JSON طراحی شد تا خواندن و نوشتنش برای برنامه‌ها آسان باشد. YAML طراحی شد تا برای آدم‌ها آسان باشد. تا آن حد همپوشانی دارند که JSON تقریباً زیرمجموعهٔ YAML است و خوانندهٔ YAML معمولاً می‌تواند JSON را بخواند. بنابراین تبدیل JSON به YAML تغییر داده نیست، بلکه پوشاندن دوبارهٔ آن است، در شکلی که جا برای یادداشت دارد و شلوغی علائم نگارشی ندارد.
چرا تورفتگی مراقبت می‌خواهد
چون YAML بر تورفتگی تکیه می‌کند، خط ناهم‌تراز معنا را عوض می‌کند. مبدل تورفتگی را یکدست می‌نویسد، با فاصله و با همان پهنا در هر سطح، پس فایل همان‌طور که تولید شده درست است. وقتی بعداً ویرایشش می‌کنید همان پهنا را نگه دارید و از تب پرهیز کنید که YAML برای تورفتگی اجازه نمی‌دهد.
خوانا اما نه همیشه کوتاه‌تر
اغلب گفته می‌شود YAML از JSON فشرده‌تر است، چون آکولادها و گیومهٔ دور کلیدها را حذف می‌کند. برای داده‌های مسطح این درست است. برای داده‌های عمیقاً تودرتو، تورفتگی می‌تواند آن را از نظر نویسه بلندتر کند. سود در خوانایی است، نه در اندازه.
موقعیت‌های رایج با جزئیات
تبدیل خروجی ابزار به پیکربندی
ابزارها اغلب تنظیمات یا نتایجشان را به صورت JSON چاپ می‌کنند. JSON را به YAML تبدیل کنید، توضیح اضافه کنید و آن را به عنوان فایل پیکربندی‌ای که آدم‌ها نگهداری می‌کنند نگه دارید.
جابه‌جایی تنظیمات میان سیستم‌ها
بردن پیکربندی از سیستمی که JSON به کار می‌برد به سیستمی که YAML به کار می‌برد یک تبدیل است، و پس از آن بررسی اینکه مقصد کلیدها را می‌پذیرد.
خواندن پاسخ API
پاسخ یک API می‌تواند به صدها خط آکولاد برسد. در YAML همان داده مثل یک طرح کلی خوانده می‌شود و ساختار را با یک نگاه می‌بینید.
آموزش و مستندسازی
نشان دادن همان داده در هر دو نمادگذاری راه خوبی برای آموزش نحوهٔ کار دادهٔ ساخت‌یافته است. مستنداتی که مثال‌های YAML دارند اغلب خواناترند.
توصیه‌های عملی پیش از تبدیل JSON به YAML
بررسی کنید JSON معتبر است
ویرگولی اضافه یا گیومه‌ای غایب تبدیل را متوقف می‌کند. اگر صفحه خطا گزارش داد، فایل را در ویرایشگری که مشکلات JSON را برجسته می‌کند باز کنید و خطی را که نشان می‌دهد اصلاح کنید.
هر جا می‌توانید مسطح کنید
اگر ساختار عمیق‌تر از لازم است، اول ساده‌اش کنید. ساختار مسطح‌تر YAMLای می‌دهد که خواندن و ویرایشش آسان‌تر است.
به مصرف‌کننده فکر کنید
ببینید چه چیزی YAML را خواهد خواند. بعضی ابزارها نام کلیدها و نوع‌های معینی انتظار دارند و تنظیم JSON از پیش آسان‌تر از ویرایش YAML بعداً است.
فایل‌های بزرگ
همه‌چیز روی دستگاه شما اجرا می‌شود، پس فایلی بسیار بزرگ حافظه می‌خواهد. برای فایل‌های چند مگابایتی از رایانه استفاده کنید و اگر صفحه به زحمت افتاد داده را تقسیم کنید.
پرسش‌هایی که مردم پیش از تبدیل می‌پرسند
آیا داده‌ام تغییر می‌کند؟
خیر. همه‌چیز در هر دو جهت حفظ می‌شود: نگاشت‌ها، فهرست‌ها، رشته‌ها، عددها، بولی‌ها و null.
چرا رشته‌های بلندم در چند خط تقسیم شده‌اند؟
رشته‌های بلند در حدود صد ستون شکسته می‌شوند. این جای شکست خط را عوض می‌کند بی‌آنکه مقدار را تغییر دهد.
چرا فایل من این‌قدر تورفتگی دارد؟
چون داده عمیقاً تودرتو است و YAML تودرتویی را با تورفتگی بیان می‌کند.
لنگرها کجا هستند؟
ساختارهای تکراری به جای لنگر به طور کامل نوشته می‌شوند، پس فایل مستقیم از بالا به پایین خوانده می‌شود.
آیا فایل من بارگذاری می‌شود؟
خیر. تبدیل در مرورگر شما اجرا می‌شود و فایل هرگز دستگاه شما را ترک نمی‌کند.
می‌توانم به JSON برگردم؟
بله. تبدیل YAML به JSON فایل را دوباره می‌خواند، هرچند هر توضیحی که اضافه کرده باشید باقی نمی‌ماند.
انتخاب هوشمندانه هنگام تبدیل JSON به YAML
آیا واقعاً YAML لازم است؟
اگر ابزار دریافت‌کننده JSON می‌خواند، JSON را نگه دارید. وقتی تبدیل کنید که آدم‌ها باید فایل را بخوانند و ویرایش کنند، یا ابزار YAML می‌طلبد.
مقصدهای دیگر
اگر مقصد فایل نشانه‌گذاری است، تبدیل JSON به XML می‌تواند ادامه دهد. برای جدول‌ها، تبدیل JSON به CSV و تبدیل JSON به XLSX به صفحه‌گسترده‌ها خدمت می‌کنند.
JSON را نگه دارید
اگر JSON از یک برنامه می‌آید، نسخهٔ اصلی است. آن را نگه دارید و وقتی تغییر کرد YAML را دوباره تولید کنید.
گرفتن نتیجهٔ خوب پس از تبدیل
توضیح اضافه کنید
نتیجه هیچ‌کدام را ندارد و اینجاست که YAML می‌درخشد. بالای هر بلوک یادداشتی کوتاه بنویسید که بگوید چه می‌کند و چه مقدارهایی مجازند.
نوع‌ها را بررسی کنید
به مقدارهایی مانند نسخه‌ها، کدها و پرچم‌ها نگاه کنید. مطمئن شوید جایی که رشته مقصودتان بود رشته‌اند و جایی که عدد مقصودتان بود عددند.
تورفتگی را یکدست نگه دارید
هنگام ویرایش از فاصله استفاده کنید و همان پهنا را در هر سطح نگه دارید. ویرایشگری که فضای خالی را نشان می‌دهد و YAML را بررسی می‌کند شما را از خطا نجات می‌دهد.
آماده کردن JSON برای تبدیل خوب
منظم نگهش دارید
وقتی JSON را به YAML تبدیل می‌کنید، داده‌های منظم بهتر تبدیل می‌شوند: کلیدهای یکدست و نوع‌های روشن. داده‌های نامنظم نتیجه‌ای درست اما نامرتب می‌دهند.
کلیدها را روشن نام‌گذاری کنید
آدم‌ها YAML را خواهند خواند، پس کلیدهایی انتخاب کنید که معنایشان را بگویند. پیکربندی وقتی نام‌هایش ساده باشد نگهداری‌اش آسان‌تر است.
اول با یک تکهٔ کوچک آزمایش کنید
اگر فایلتان بزرگ است، بخشی را در فایل آزمایشی ببرید و آن را تبدیل کنید. نگاهی سریع به نتیجه نشان می‌دهد ساختار همان است که انتظار دارید.
کار با YAML پس از تبدیل JSON به YAML
یادداشت‌هایی را اضافه کنید که JSON نمی‌توانست در خود نگه دارد
نخستین کار با فایل تازه‌تبدیل‌شده این است که از بالا بخوانیدش و جاهایی که غریبه گیج می‌شود توضیح اضافه کنید. یک خط کوتاه بالای بخش که بگوید چه چیزی را کنترل می‌کند بیش از صفحه‌ای مستندات که جای دیگری نگه داشته شده ارزش دارد، چون کنار چیزی است که توصیف می‌کند. این مهم‌ترین سودی است که هنگام تبدیل JSON به YAML به دست می‌آورید.
تنظیمات مرتبط را گروه‌بندی کنید
کلیدها ترتیبی را که در JSON داشتند نگه می‌دارند، که ممکن است ترتیبی باشد که برنامه اتفاقی منتشر کرده. در YAML آزادید آن‌ها را جابه‌جا کنید تا تنظیمات مرتبط کنار هم بنشینند، با یک خط خالی میان گروه‌ها. چون ترتیب کلیدها در نگاشت برای بیشتر خوانندگان معنایی ندارد، این کار بی‌خطر است، اما ابزاری را که به کار می‌برید بررسی کنید که مبادا ترتیب برایش مهم باشد.
بررسی کنید ابزار دریافت‌کننده چه انتظار دارد
فایل YAML معتبر لزوماً پیکربندی معتبر نیست. ابزارها کلیدها و نوع‌های معینی انتظار دارند و بعضی دربارهٔ کلیدهای ناشناخته سخت‌گیرند. پس از تبدیل، فایل را با مستندات ابزار مقایسه کنید و اگر بررسی‌کنندهٔ خودش را دارد اجرا کنید.
از کنترل نسخه استفاده کنید
پیکربندی در YAML را می‌توان به آسانی خط به خط مقایسه کرد، که آن را برای کنترل نسخه مناسب می‌کند. فایل تبدیل‌شده را ثبت کنید و بگذارید همکاران هر تغییر را به صورت تفاوتی روشن ببینند، که با یک خط JSON فشرده بسیار سخت‌تر بود.
مراقب رمزها باشید
JSON خروجی ابزارها گاهی توکن و گذرواژه دارد. چون تبدیل در مرورگر شما انجام می‌شود، چیزی دستگاهتان را ترک نمی‌کند، اما فایل YAML همان رمزها را خواهد داشت. پیش از ثبت یا اشتراک فایل آن‌ها را حذف کنید یا به جای امن‌تری ببرید.
هنگام ویرایش مراقب تورفتگی باشید
وقتی ویرایش دستی را شروع کردید، خطر اصلی خطی است که یک فاصله جابه‌جاست. از ویرایشگری استفاده کنید که فضای خالی را نشان می‌دهد و هنگام تایپ YAML را بررسی می‌کند، و همان پهنا را در هر سطح نگه دارید، همان‌طور که مبدل کرد.
وقتی منبع تغییر کرد دوباره تبدیل کنید
اگر JSON را برنامه‌ای تولید می‌کند و هر از چندی تغییر می‌کند، برای هر نسخهٔ جدید دوباره JSON را به YAML تبدیل کنید و توضیح‌هایتان را از فایل قدیمی در فایل جدید ادغام کنید. ابزار مقایسه این کار را به چند دقیقه تبدیل می‌کند.
حریم خصوصی و نحوهٔ برخورد
چرا تبدیل محلی برای پیکربندی مهم است
فایل‌های پیکربندی اغلب نشانی‌ها، نام سیستم‌های داخلی و گاهی کلیدها و گذرواژه‌ها را در خود دارند. بسیاری از مبدل‌های آنلاین فایل شما را روی یک سرور بارگذاری می‌کنند، پردازش می‌کنند و نتیجه را پس می‌فرستند، و مدتی نسخه‌ای روی ماشینی می‌ماند که شما کنترلی بر آن ندارید. اینجا مرورگر خودتان کار را انجام می‌دهد، پس فایل روی دستگاه شما می‌ماند.
وقتی می‌روید چه می‌شود
وقتی صفحه را می‌بندید، فایل تبدیل‌شده از مرورگر ناپدید می‌شود، پس اول آن را دانلود کنید. هیچ چیز دربارهٔ فایلتان نگه داشته نمی‌شود.
اگر چیزی اشتباه پیش رفت
صفحه می‌گوید فایل JSON معتبر نیست
ممکن است ویرگولی اضافه، گیومه‌ای غایب یا کروشه‌ای که بسته نمی‌شود وجود داشته باشد. فایل را در ویرایشگری که خطاهای JSON را برجسته می‌کند باز کنید و خطی را که نشان می‌دهد اصلاح کنید.
ابزار YAML را رد می‌کند
نام کلیدها و نوع‌هایی را که انتظار دارد بررسی کنید. YAML معتبر است، اما ممکن است ابزار نام‌های دیگر یا ساختار دیگری بخواهد.
صفحه با فایل بزرگ قفل می‌کند
همه‌چیز روی دستگاه شما اجرا می‌شود و فایل بزرگ حافظه می‌خواهد. دوباره روی رایانه امتحان کنید یا داده را تقسیم کنید.
ابزارهای مرتبط
همین خانوادهٔ ابزارها کارهای همسایه را پوشش می‌دهد. برای بازگشت از تبدیل YAML به JSON استفاده کنید. برای نشانه‌گذاری، تبدیل JSON به XML و تبدیل XML به JSON میان آن دو تبدیل می‌کنند. برای جدول‌ها تبدیل JSON به CSV، تبدیل CSV به JSON، تبدیل JSON به XLSX و تبدیل XLSX به JSON هست.
یک مثال عملی
فرض کنید ابزاری تنظیماتش را به صورت فایل JSON با 150 خط چاپ می‌کند و می‌خواهید آن‌ها را در مخزنتان به عنوان پیکربندی‌ای نگه دارید که همکاران بتوانند بخوانند و روی آن توضیح بنویسند. فایل را اینجا رها می‌کنید و دکمه را می‌فشارید. لحظه‌ای بعد YAMLای حدود 90 خطی دانلود می‌کنید که ساختارش مثل یک طرح کلی خوانده می‌شود. بالای هر بخش توضیحی اضافه می‌کنید، ثبتش می‌کنید و به تیم می‌گویید کجا ویرایش کنند. JSON به عنوان خروجی ابزار می‌ماند.
یک فهرست کنترل کوتاه
پیش از تبدیل
بررسی کنید JSON معتبر است. اگر می‌توانید تودرتویی عمیق را ساده کنید. JSON را نگه دارید.
هنگام تبدیل
تا آماده شدن فایل روی صفحه بمانید.
پس از تبدیل
YAML را باز کنید، ساختار و نوع‌ها را بررسی کنید، توضیح اضافه کنید و با ابزاری که آن را خواهد خواند آزمایش کنید.
اشتباه‌های رایج
انتظار فایلی کوتاه‌تر
تودرتویی عمیق تورفتگی عمیق می‌سازد. YAML خواناتر است، نه همیشه کوچک‌تر.
ویرایش با تب
YAML برای تورفتگی تب را مجاز نمی‌داند. از فاصله استفاده کنید.
از دست دادن منبع
اگر JSON از یک برنامه می‌آید، آن را نگه دارید و وقتی تغییر کرد YAML را دوباره تولید کنید.
فایلتان روی دستگاهتان می‌ماند
تبدیل به صورت محلی انجام می‌شود. فایل شما توسط مرورگر خودتان خوانده، همان‌جا بازنویسی و به شکل YAML تحویل داده می‌شود. چیزی بارگذاری نمی‌شود، پس هیچ نسخه‌ای روی سرور نمی‌ماند و هیچ‌کس دیگر نمی‌تواند آن را بخواند. برای پیکربندی با محتوای خصوصی، این راه ایمن برای تبدیل JSON به YAML است.
خلاصه
برای تبدیل JSON به YAML در اینجا، فایل را رها کنید و دکمه را بفشارید. در مرورگر شما خوانده و نوشته می‌شود، پس فایل هرگز دستگاه شما را ترک نمی‌کند. همه‌چیز در هر دو جهت حفظ می‌شود: نگاشت‌ها، فهرست‌ها، رشته‌ها، عددها، بولی‌ها و null. ساختارهای تکراری به جای لنگر به طور کامل نوشته می‌شوند، پس فایل مستقیم از بالا به پایین خوانده می‌شود. YAML معنا را در تورفتگی‌اش می‌گذارد، پس مقداری که عمیقاً تودرتو شده به فایلی با تورفتگی عمیق تبدیل می‌شود، خوانا اما نه کوتاه. رشته‌های بلند در حدود صد ستون شکسته می‌شوند، که جای شکست خط را عوض می‌کند بی‌آنکه مقدار را تغییر دهد. کلیدها ترتیبی را که در JSON داشتند نگه می‌دارند.