منسّق YAML

ما هو منسّق YAML؟

يوحّد منسّق YAML المسافات البادئة والتباعد في ملفات YAML مثل بيانات Kubernetes وسير عمل GitHub Actions وملفات Docker Compose. وخلافًا للمحوّلات التي تحمّل البيانات ثم تُفرغها، يُبقي التعليقات وفواصل المستندات (---) وترتيب المفاتيح.

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

1. الصق YAML في مربع الإدخال أو اضغط تحميل مثال.
2. اختر المسافة البادئة (مسافتان شائعتان في YAML).
3. اضغط التنسيق (يتحدّث الناتج أيضًا أثناء الكتابة).
4. انسخ YAML المنسّق أو نزّله.

مثال

a:   1
b:
      - x  # note

a: 1
b:
  - x # note

متى تستخدم منسّق YAML

استخدمه لإصلاح المسافات البادئة غير المتسقة وترتيب ملفات CI/CD وKubernetes أو فحص YAML قبل الإيداع. لا يُسمح بعلامات Tab في المسافة البادئة لـ YAML، لذا لا يُنصح بخيار Tab. وللتحقق من الصياغة فقط استخدم مدقّق YAML.

كيف يعمل منسّق YAML

يُحمَّل المدخل أولًا بـ js-yaml لاكتشاف الأخطاء (ومنها المفاتيح المكررة) بسطر وعمود دقيقين. ثم يُطبع بإضافة YAML في Prettier التي تعمل على شجرة الصياغة الفعلية، فتبقى التعليقات والمراسي (anchors) والنصوص متعددة الأسطر والمجموعات المضمّنة بينما تُوحَّد المسافات البادئة والتباعد.

حالات الاستخدام الشائعة

• ✓ توحيد ملفات قيم Kubernetes أو Helm
• ✓ ترتيب سير عمل GitHub Actions
• ✓ إصلاح المسافات البادئة المختلطة في docker-compose.yml
• ✓ تنسيق أمثلة YAML للتوثيق

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

استكشف المزيد من الفئات