YAML وJSON

كيفية الاستخدام YAML وJSON

1. الصق YAML أو JSON؛ يُتعرَّف على الصيغة.
2. اقرأ الناتج أو رسالة الخطأ مع رقم السطر.
3. انسخ المخرجات.

المسافات لا الجدولة

أهمّ قاعدة في YAML وأكثر الأخطاء وقوعًا.

لا يقبل YAML مسافات الجدولة للإزاحة. المسافات العادية فقط. والمحرّر الذي يدرج جدولة بصمت ينتج ملفًا يبدو سليمًا ولا يعمل.

ورسالة الخطأ مضلّلة غالبًا: تشير إلى سطر أبعد، حيث تنهار البنية فعليًا.

فعّل في محرّرك «تحويل الجدولة إلى مسافات»، وأظهر المسافات إن كنت تعمل مع YAML كثيرًا.

ومسافتان لكل مستوى هو المتعارف عليه. والأهم من العدد الاتساق داخل الملف الواحد.

قيم لم تقصدها

يخمّن YAML نوع القيمة، وذلك ينقلب عليك في مواضع.

القيم yes وno وon وoff تُقرأ في الإصدارات الأقدم قيمًا منطقية. فرمز دولة «NO» للنرويج يصير القيمة «خطأ». ضع مثل هذه القيم بين علامتَي اقتباس.

والأرقام ذات الأصفار البادئة قد تُقرأ ثمانية. ورقم الإصدار أو الرمز البريدي مكانه بين علامتَي اقتباس.

والوقت مثل 12:30 قد يُفهم شيئًا غير النص. وهنا أيضًا: اقتباس.

والقاعدة العملية: كل ما هو معرّف لا قيمة قابلة للحساب يوضع بين علامتَي اقتباس.

والنص العربي داخل YAML لا يحتاج معاملة خاصة، بشرط حفظ الملف بترميز UTF-8. وإن ظهرت الحروف تالفة فالمشكلة في ترميز الملف لا في YAML.

أي صيغة لأي غرض

YAML أيسر في الكتابة والقراءة يدويًا: أقواس أقل، وتعليقات ممكنة، ونص متعدّد الأسطر بلا هروب.

وJSON أشدّ صرامة وأوثق في التبادل بين الأنظمة. لا تعليقات، ولا اعتماد على الإزاحة، ووجوه أقلّ لسوء الفهم.

وعمليًا: الإعدادات التي يحرّرها البشر بـYAML، والبيانات التي تسير بين الأنظمة بـJSON.

ونقطة تُذكَر عند التحويل: تعليقات YAML تضيع عند الانتقال إلى JSON، الذي لا يعرف التعليقات. وذلك لا يُستعاد.

كل شيء يجري في هذه الصفحة.

الأسئلة الشائعة