منسق YAML

تنسيق وضغط والتحقق من YAML مع تمييز صيغة الكود

إدخال YAML

المخرجات المنسقة

المسافة البادئة:

ما هو منسق YAML؟

يُستخدم YAML (YAML Ain't Markup Language) على نطاق واسع في ملفات تهيئة Kubernetes وDocker Compose وGitHub Actions والعديد من الأدوات الأخرى. بخلاف JSON، يستخدم YAML المسافات البادئة للبنية بدلاً من الأقواس المتعرجة — مما يجعله مقروءاً لكنه هشّ أيضاً: المسافات الخاطئة أو الجداول بدلاً من المسافات أو التداخل غير المتسق يؤدي إلى أخطاء التحليل. تحدد مواصفات YAML 1.2 القواعد.

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

أمثلة تنسيق YAML

نسّق YAML للحصول على مسافات بادئة متسقة. أمثلة من قطاع الاتصالات:

مثال 1: سجل مشترك

الإدخال

المخرجات المنسقة:

المخرجات

مثال 2: قائمة المشتركين

الإدخال

المخرجات المنسقة:

المخرجات

انقر فوق زر تحميل مثال أعلاه لتحميل المزيد من الأمثلة في المحرر.

كيفية استخدام هذه الأداة

1

الصق أو ارفع

انسخ YAML الخاص بك والصقه في المحرر الأيسر. يمكنك أيضاً النقر على <strong>رفع الملف</strong> لتحميل ملف <code>.yaml</code> أو <code>.yml</code>. يقوم زر <strong>تحميل مثال</strong> بتحميل بيانات نموذجية. سيُظهر YAML غير الصحيح خطأ — استخدم أداة التحقق من YAML لتشخيص المشكلة.

2

ضبط المخرجات ومراجعتها

يتحدث اللوحة اليمنى تلقائياً. استخدم أزرار المسافة البادئة (2 أو 4 مسافات) لاختيار النمط المفضل. ترتيب المفاتيح يرتب المفاتيح أبجدياً للحصول على مخرجات متسقة. تتطلب مواصفات YAML مسافات (لا جداول) للمسافة البادئة.

3

نسخ أو تنزيل

استخدم <strong>نسخ</strong> لوضع النتيجة في الحافظة، أو <strong>تنزيل</strong> لحفظها كملف. للتحويل إلى JSON، استخدم YAML إلى JSON. للعملية العكسية استخدم JSON إلى YAML. للمخرجات المضغوطة استخدم ضاغط YAML.

متى يفيد تنسيق YAML

يحتاج معظم المطورين إلى منسق عند العمل مع بيانات Kubernetes أو ملفات Docker Compose أو تهيئات CI/CD مثل GitHub Actions. غالباً ما يحتوي YAML المحرر يدوياً على أخطاء في المسافة البادئة — مسافة إضافية واحدة أو جدول يمكن أن يوقف النشر. يمنحك التنسيق هنا مخرجات صحيحة ومتسقة يمكنك لصقها مباشرةً في مشروعك.

غالباً ما تحتوي ملفات التهيئة مثل <code>application.yml</code> (Spring Boot) أو <code>.gitlab-ci.yml</code> على تداخل عميق. يصعب قراءة المسافة البادئة غير المتسقة ومراجعتها في طلبات السحب. معالجتها هنا يوحّد البنية. للتحويل إلى JSON أو XML استخدم YAML إلى JSON أو YAML إلى XML.

إنها مفيدة أيضاً قبل مشاركة YAML مع الزملاء. التهيئة المنسقة في رسالة Slack أو طلب دعم أسهل بكثير في القراءة. تمريرها عبر أداة التحقق من YAML أولاً يمكن أن يكتشف مشاكل الصياغة قبل أن يراها أي شخص آخر.

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

هل بياناتي خاصة؟

نعم. يتم التنسيق في المتصفح باستخدام JavaScript. لا يُرسل أي بيانات إلى الخادم. يمكنك التحقق من ذلك بفتح علامة تبويب الشبكة في أدوات المطور بالمتصفح أثناء استخدام الأداة.

لماذا يستخدم YAML مسافات بدلاً من جداول؟

تتطلب مواصفات YAML مسافات للمسافة البادئة. الجداول غير مسموح بها. يؤدي خلط الجداول والمسافات إلى أخطاء تحليل. استخدم 2 أو 4 مسافات بشكل متسق في جميع أنحاء الملف.

هل يمكنني تحويل YAML إلى JSON؟

نعم. استخدم أداة YAML إلى JSON.

ماذا أفعل إذا كانت المسافة البادئة في YAML غير صحيحة؟

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

هل يتم الاحتفاظ بالتعليقات؟

يعتمد ذلك على المحلل. بعض التطبيقات تحذف التعليقات أثناء التحليل وإعادة الإصدار. تحقق من المخرجات.

أدوات ذات صلة

YAML إلى JSON أداة التحقق من YAML JSON إلى YAML منسق JSON منسق XML ضاغط YAML

لمزيد من المعلومات حول YAML، تعتبر مواصفات YAML 1.2 المرجع الرسمي. راجع أيضاً yaml.org وتهيئة Kubernetes وDocker Compose.