منسّق YAML

كيف يعمل

يقوم تصميم YAML كله على المسافات البادئة، وهذا يجعله ممتعًا في القراءة وسهل الكسر على نحو غير معتاد. مسافة شاردة واحدة تنتج رسالة خطأ من خط CI بعد عشرين دقيقة. أما هنا فيُحلَّل ويُخبرك فورًا.

التحقق مع رقم السطر

إذا تعذر تحليل المستند، تحصل على السطر والعمود اللذين فشل عندهما وسبب المحلل نفسه. وهذا في الغالب أنفع من المخرجات المنسّقة، وهو سبب فتح معظم الناس لأداة كهذه.

إعادة التنسيق

يُحلَّل YAML الصالح إلى بنية بيانات ويُكتب من جديد من الصفر، فتصبح المسافات البادئة موحدة ويُوحَّد استخدام علامات الاقتباس وتختفي المسافات البيضاء الزائدة في نهاية الأسطر. ولأنه يمر عبر البيانات بدلًا من تعديل النص، فالنتيجة مضمونة الصلاحية.

ما تكلفه الدورة الكاملة عبر البيانات

تضيع التعليقات. فهي ليست جزءًا من البيانات، ولذلك يتجاهلها المحلل. وتُوسَّع المراسي (anchors) والأسماء المستعارة (aliases) إلى قيمها الكاملة بدلًا من الاحتفاظ بها. وإذا كانت تعليقات ملفك مهمة، فنسّق نسخة وطبّق تصحيحات المسافات البادئة يدويًا.

ترتيب المفاتيح

الترتيب الأبجدي يجعل ملفي إعدادات قابلين للمقارنة فعلًا في diff. وهو أيضًا الخيار الخاطئ لملف يحمل فيه الترتيب معنى للقارئ البشري، فخط CI يُقرأ أفضل بترتيب التنفيذ منه بالترتيب الأبجدي.

مستندات متعددة

يُتعامل مع الملف الذي يحتوي على عدة مستندات مفصولة بـ ---، ويُنسَّق كل منها بالتتابع.