منسّق ومدقّق YAML

ما وظيفته

YAML شائع في ملفات الإعداد — ملفات Kubernetes ومسارات عمل GitHub Actions وGitLab CI وDocker Compose وأدلة Ansible ومستندات OpenAPI — لأنه سهل القراءة. لكنه سهل الكسر أيضًا: مسافة بادئة خاطئة، أو حرف جدولة، أو علامة اقتباس غير مغلقة، أو غياب مسافة بعد النقطتين، كلها قد تغيّر معنى الملف أو تمنع تحميله.

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

طريقة الاستخدام

1. الصق YAML في حقل الإدخال، أو ارفع ملف .yaml أو .yml، أو انقر مثال.
2. تظهر النتيجة أثناء الكتابة: شارة خضراء YAML صالح أو قائمة أخطاء مثل السطر 3، العمود 2.
3. أبقِ عرض YAML المنسَّق مفعّلًا للحصول على نسخة مرتبة، واختر مسافة بادئة من 2 أو 4. انسخها بالزر أعلى الكتلة.
4. لا توقف المفاتيح المكررة أخطاء إلا إذا كانت أدواتك تسمح بتكرار المفاتيح.

أخطاء شائعة

server:
  port: 8080
   host: localhost   # indented one space too far
tags: [web, api      # missing closing bracket

• مسافات بادئة غير متسقة: يجب أن تبدأ العناصر في المستوى نفسه من العمود نفسه. لا يسمح YAML بحرف الجدولة للمسافة البادئة.
• غياب مسافة بعد النقطتين: key:value سلسلة عادية وليست مفتاحًا وقيمة.
• أحرف خاصة بلا اقتباس: القيم التي تبدأ بـ * أو & أو ! أو % أو @ أو علامة backtick، أو التي تحتوي : أو #، تحتاج إلى علامات اقتباس.
• أنواع غير متوقعة: yes وno وon وoff سلاسل في YAML 1.2 لكنها قيم منطقية في محللات YAML 1.1 القديمة؛ ضعها بين علامتي اقتباس احتياطًا. وأرقام الإصدارات مثل 1.10 تصبح الرقم 1.1 دون اقتباس.

التحقق من البنية

تفحص هذه الأداة الصيغة، أي هل النص YAML سليم البنية. للتأكد من أن الملف يحتوي على المفاتيح وأنواع القيم الصحيحة، حوّله بأداة YAML إلى JSON ثم تحقّق من النتيجة بمدقّق JSON Schema.