ما هو عارض YAML؟

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

تدعم الأداة ملفات YAML متعددة المستندات (مفصولة بـ ---)، وتحافظ على المراجع المتداخلة (anchors)، وتعيد التنسيق وفق المسافة البادئة التي تختارها (2 أو 4). عرض الشجرة يسمح بطيّ القوائم والخرائط بنقرة واحدة، فيصبح ملف Helm أو Compose الطويل سهل القراءة، كما تُبرز خانة البحث المدمجة المفاتيح والقيم المطابقة في كامل المستند. والأخطاء تظهر مع رقم السطر والعمود بدقة لتصحيح الإزاحة دون تخمين.

كيفية الاستخدام

1. الصق محتوى YAML أو اسحب ملف .yml/.yaml وأفلته في منطقة المحرر.
2. يتحقق العارض من بناء الجملة فوراً ويبرز أي أخطاء مع أرقام الأسطر.
3. بدّل بين العرض الشجري والعرض النصي، واطوِ الأقسام المتداخلة، وقم بتنزيل المخرجات المنسّقة.

متى تستخدم

• التحقّق من ملف Kubernetes قبل kubectl apply لاكتشاف أخطاء apiVersion أو selectors.
• تصفّح ملف docker-compose.yml طويل دون النزول عبر ٣٠٠ سطر من نصّ مسطح.
• فحص playbook في Ansible أو workflow في GitHub Actions للتأكّد من سلامة البنية.

النتيجة

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

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

ما الفرق بين هذه الأداة وتشغيل yamllint محلياً؟

yamllint يفرض قواعد أسلوب (مسافات في النهاية، طول السطر) من سطر الأوامر. هذه الأداة تركّز على التحليل وعرض البنية: تلصق الملف، ترى الشجرة، ثم تنزّل نسخة بمسافات بادئة موحّدة.

هل تتعامل الأداة مع المراجع (anchors) والاختزالات (aliases)؟

نعم. محلّل js-yaml يحلّ المراجع، فيظهر في عرض الشجرة القيمة المُوسَّعة عند كل alias. النسخة المعاد تنسيقها تتخلّى عن المراجع وتكتب المحتوى مباشرة، وهو ما يلزم عادةً للمراجعة.

هل يمكن لصق أكثر من مستند YAML معاً؟

نعم. المستندات المفصولة بـ --- تُحلَّل كتدفّق ويظهر عددها في شريط الأدوات. عرض الشجرة يكدّسها مع فاصل، فتسهل مقارنة Deployment وService في ملف Kubernetes واحد.

لماذا لا يتطابق رقم السطر في الخطأ مع محرّري؟

محلّلات YAML تعدّ السطور بدءاً من ١ من أوّل سطر محتوى، بينما بعض المحرّرات تعدّ shebang أو التعليقات بشكل مختلف. رقم العمود غالباً أدقّ، فهو يشير إلى الحرف الذي عطّل التحليل بالضبط.

هل يُرسَل ما ألصقه من YAML إلى الخادم؟

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

أدوات ذات صلة