إدخال YAML

نتيجة التحقق

ما هي أداة التحقق من YAML؟

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

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

أمثلة التحقق من YAML

يستخدم YAML الصحيح مسافات بادئة متسقة. يحتوي YAML الخاطئ غالباً على تداخل غير صحيح. أمثلة من قطاع الاتصالات:

مثال 1: YAML صحيح

صحيح

مثال 2: YAML غير صحيح (مسافة بادئة خاطئة)

غير صحيح

تُبلّغ الأداة عن خطأ. استخدم المثال الصحيح أو المثال غير الصحيح أعلاه لتحميل الأمثلة في المحرر.

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

الصق أو ارفع YAML

انسخ YAML الخاص بك والصقه في المحرر الأيسر. يمكنك أيضاً النقر على رفع الملف لتحميل ملف .yaml أو .yml من جهازك. استخدم المثال الصحيح للـYAML الصحيح أو المثال غير الصحيح لرؤية شكل الأخطاء.

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

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

صحح وأعد التحقق

صحح الأخطاء في الإدخال وأعد التحقق. للتنسيق والمسافة البادئة استخدم منسق YAML. للتحويل إلى JSON أو تنسيقات أخرى استخدم YAML إلى JSON أو YAML إلى XML.

متى يفيد التحقق من YAML

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

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

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

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

ما الذي يجعل YAML غير صحيح؟

المسافات البادئة الخاطئة (جداول بدلاً من مسافات)، التداخل غير المتسق، الأحرف الخاصة بدون علامات اقتباس مثل : أو # في القيم، السلاسل متعددة الأسطر الخاطئة، أو المفاتيح المكررة. تحدد الأداة المشكلة برقم السطر والموضع.

الجداول مقابل المسافات؟

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

هل يُرسل بياناتي إلى أي مكان؟

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

ماذا عن المراسي والأسماء المستعارة في YAML؟

المراسي (&name) والأسماء المستعارة (*name) مدعومة. تتحقق الأداة من استخدامها بشكل صحيح. المراجع الدائرية ستتسبب في فشل التحقق.

هل تتحقق من المخطط أم من الصياغة فقط؟

تتحقق هذه الأداة من الصياغة فقط — ما إذا كان YAML مُنشَّكلاً بشكل صحيح وقابلاً للتحليل. لا تتحقق من مخطط JSON أو Kubernetes. للتحقق من البنية، حوّل إلى JSON واستخدم مولد مخطط JSON.

التحقق من YAML