تحويل ⁦JSON⁩ إلى ⁦YAML⁩:
المحوّل

من ⁦JSON⁩ إلى ⁦YAML:⁩ قبل وبعد

المُدخل: {"⁦service⁩": {"⁦name⁩": "⁦web⁩", "⁦ports⁩": [⁦80, 443⁩], "⁦env⁩": {"⁦DEBUG⁩": ⁦false⁩}}}. الناتج: سطر ⁦service:⁩، ثم ⁦name: web⁩، ثم ⁦ports:⁩ يليه - ⁦80⁩ و- ⁦443⁩ عنصرين في قائمة، ثم ⁦env:⁩ وتحته ⁦DEBUG: false⁩، وكل مستوى مُزاح بمسافتين.

تختفي الأقواس المعقوفة والمربعة والفواصل ومعظم علامات التنصيص. تصبح قائمة الكائنات قائمة يبدأ كل عنصر فيها بشرطة، فتتحول مصفوفة ⁦containers⁩ إلى - ⁦name: app⁩ يليها ⁦image: nginx⁩ مصطفًّا تحتها.

لماذا توضع بعض النصوص بين علامات تنصيص

بعض القيم نصوص في ⁦JSON⁩، لكنها ستعني شيئًا آخر لو كُتبت مجردة في ⁦YAML.⁩ لذا يضعها المحوّل بين علامتي تنصيص مفردتين حتى تُقرأ بعد ذلك على أنها النصوص نفسها:

• كلمات قد يعدّها قارئ ⁦YAML⁩ قيمًا منطقية: "⁦yes⁩" و"⁦no⁩" و"⁦on⁩" و"⁦off⁩" و"⁦true⁩"، وحتى المفاتيح المكونة من حرف واحد مثل ⁦y⁩ و⁦n⁩، التي تعاملها قارئات ⁦YAML 1.1⁩ القديمة على أنها قيم منطقية.
• النصوص التي تشبه الأرقام أو التواريخ، مثل "⁦123⁩" أو "⁦1.10⁩" أو "⁦2024-01-15⁩".
• النصوص التي تبدأ بـ # أو تحتوي على نقطتين رأسيتين تليهما مسافة، إذ كانت ستبدأ تعليقًا أو مفتاحًا جديدًا لولا ذلك.
• النصوص الفارغة، وتُكتب ''.

النصوص الطويلة ومتعددة الأسطر

تبقى النصوص الطويلة في سطر واحد. لا تُطوى عند عرض ثابت، فتخرج الروابط والمفاتيح والأوامر الطويلة كما كانت تمامًا.

النص الذي يحتوي على فواصل أسطر يصبح كتلة حرفية تبدأ بـ |، مع الإبقاء على كل فاصل سطر كما كان. هذا أسهل قراءة بكثير من رموز \⁦n⁩، وهو الطريقة المعتادة لتخزين السكربتات المضمّنة أو الشهادات أو الأوصاف الطويلة في ⁦YAML.⁩

ما الذي يبقى كما هو

• تحتفظ الأرقام و⁦true⁩ و⁦false⁩ و⁦null⁩ بأنواعها. وتُكتب ⁦null⁩ بالشكل ⁦null.⁩
• تحتفظ المفاتيح بالترتيب الذي كانت عليه في ⁦JSON⁩، باستثناء المفاتيح التي هي أرقام مجردة، إذ تضعها ⁦JavaScript⁩ دائمًا في البداية.
• تُكتب الكائنات والقوائم الفارغة بالشكل {} و[].
• لا تُضاف علامة مستند --- ولا تعليقات ولا مراسٍ. والإزاحة دائمًا مسافتان، وهو الأسلوب الأكثر شيوعًا في ملفات الإعدادات؛ وليس في الصفحة إعدادات لتغييرها.

المشكلات والأدوات ذات الصلة

يُرفض ⁦JSON⁩ غير الصالح مع ذكر السطر والعمود اللذين فيهما المشكلة، وغالبًا ما تكون فاصلة زائدة في النهاية أو علامة تنصيص ناقصة. وتمرير ⁦YAML⁩ عبر أداة ⁦YAML⁩ إلى ⁦JSON⁩ يعيد البيانات نفسها، وهي طريقة سريعة للتحقق من التحويل ذهابًا وإيابًا. للبيانات الموسومة بدلًا من ملفات الإعدادات، استخدم ⁦JSON⁩ إلى ⁦XML.⁩