منسّق YAML

كيفية استخدام منسّق YAML

1. الصق YAML.
2. اختر المسافة البادئة ونمط المجموعات وعلامات الاقتباس.
3. أصلح أي خطأ يُبلَّغ عنه وانسخ المستند النظيف.

مزايا منسّق YAML

• تحليل YAML 1.2 والإبلاغ عن أخطاء الصياغة مع رقم السطر والعمود ومقتطف
• إعادة الإخراج بمسافة بادئة من مسافتين أو 4 مسافات وعلامات اقتباس متسقة
• النمط الكتلي (block) أو الانسيابي (flow) للمجموعات، وترتيب اختياري للمفاتيح
• دعم التدفقات متعددة المستندات (---)
• اكتشاف المفاتيح المكررة وقنابل الأسماء المستعارة (alias bombs)
• مثالي لملفات Kubernetes وDocker Compose وGitHub Actions وOpenAPI

مثال على منسّق YAML

services:
    web:
        image: nginx
        ports: [ "80:80" ]

services:
  web:
    image: nginx
    ports:
      - "80:80"

الأسئلة الشائعة حول منسّق YAML

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

التنسيق هو تحليل ثم إعادة إخراج عبر حزمة yaml: تعمل parseAllDocuments في الوضع الصارم مع تفعيل uniqueKeys وmerge، ثم يُطبَّع كل مستند إلى قيم آمنة في JSON ويُطبع من جديد بقيمة lineWidth تساوي 0. ونتيجة لذلك تُوسَّع المراسي والأسماء المستعارة ومفاتيح الدمج << إلى نسخ عادية، ويتحوّل !!timestamp و!!binary إلى سلاسل ISO 8601 وbase64، وتُحذف الوسوم الصريحة، وتُقرَّب الأعداد الصحيحة التي تتجاوز 2^53 − 1. وفي مخطط 1.2 الأساسي تبقى yes/no/on/off سلاسل نصية.

ولأن كل مستند يصبح كائن JavaScript بين التحليل والطباعة، تُحاط المفاتيح الشبيهة بالأعداد الصحيحة (0 و1 و42) بعلامات اقتباس وتُقدَّم إلى المقدمة بترتيب تصاعدي حتى مع تعطيل الفرز؛ أما «فرز المفاتيح» فيرتّب وفق وحدات ترميز UTF-16، فتسبق الأحرف الكبيرة الصغيرة. وتُزاح التسلسلات الكتلية تحت مفتاحها الأب، وتتحوّل السلاسل متعددة الأسطر إلى كتل حرفية |، ويطوي «نمط التدفق» المستند كله في سطر واحد، ويُعاد وصل المستندات المتعددة بـ --- (ويُطبع المستند الفارغ كـ null).