اطبع بشكل جميل وتحقق من وافحص مستندات YAML مع فرز مفاتيح اختياري والتحكم في توسيع المراسي/الأسماء المستعارة.
اطبع بشكل جميل وتحقق من وافحص مستندات YAML مع فرز مفاتيح اختياري والتحكم في توسيع المراسي/الأسماء المستعارة. اطبع بشكل جميل وتحقق من وافحص مستندات YAML مع فرز مفاتيح اختياري والتحكم في توسيع المراسي/الأسماء المستعارة.
Array
خلفية
ما هو YAML وما الذي يجعل العارض مفيدًا
YAML ("YAML Ain't Markup Language") هي صيغة تسلسل بيانات
صديقة للإنسان تستخدم على نطاق واسع لملفات الإعدادات
(docker-compose.yml, وبيانات Kubernetes، وسير عمل GitHub Actions
، ودفاتر Ansible، إلخ). تستبدل صرامة
JSON بهيكل قائم على الإزاحة ونظام أنواع أغنى
يتضمن التواريخ والسلاسل متعددة الأسطر والمراجع.
ولأن YAML يعتمد على الإزاحة للتعبير عن التداخل، فمسافة
مفقودة واحدة يمكن أن تغير معنى مستند كامل، ومعظم المحررات
لا تبرز التسلسل الهرمي بصريًا. يحلل العارض
المستند ويعيد إصداره بإزاحة متناسقة، ويكشف
أخطاء الإزاحة في الوقت الذي يكشف فيه البنية.
ميزات جديرة بالمعرفة
تتيح معظم العارضات تبديل بعض السلوكيات: فرز المفاتيح
أبجديًا لاختلافات مستقرة، وتوسيع أو إزالة مراسي
YAML وأسمائه المستعارة (صيغة & / *)، واختيار عرض الإزاحة.
خيار الفرز ذو قيمة خاصة عند مقارنة
لقطتين لنفس الإعداد -- بدونه، يمكن لإعادة ترتيب المفاتيح
بين الإصدارات إخفاء تغييرات حقيقية.
تساعدك إحصائيات عدد البايتات ومفاتيح المستوى الأعلى على رؤية مدى ثقل
المستند وأين يتركز الحجم الأكبر. إذا كنت بحاجة إلى معرفة ما إذا كان
YAML الخاص بك يلائم حد متغير بيئة أو ميزانية حجم
ConfigMap في Kubernetes، فهذا الرقم أمامك مباشرة.
نصائح سير العمل
عند تصحيح خطأ تحليل، انسخ المستند إلى تبويب عارض جديد
وبدّل الخيارات واحدًا تلو الآخر: قد تبدو صيغة &anchor
كخطأ كتابي حتى تراها موسعة. للخطوط الطويلة جدًا،
استخدم إزاحة 4 مسافات لمطابقة أدلة الأنماط الشائعة؛ للتدقيق
السطري أو لصق الدردشة، تكون مسافتان أكثر تراصًا. حافظ دائمًا على
بنية المستند الأصلية عند إيداع الإعدادات: العارض
للفحص، وليس للتطبيع.
الأسئلة الشائعة
لماذا يبدو YAML كـ JSON مع خطوات إضافية؟
JSON هو مجموعة فرعية صارمة من YAML 1.2: كل مستند JSON هو مستند YAML صالح. يضيف YAML تعليقات وسلاسل متعددة الأسطر ومراجع ونظام أنواع أغنى فوق ذلك.
ما الفرق بين المراسي (&) والأسماء المستعارة (*)؟
المرساة (`&name value`) تسمي قيمة باسم؛ الاسم المستعار (`*name`) يعيد استخدام تلك القيمة في مكان آخر. يمكن للعارض توسيع الأسماء المستعارة سطريًا (`*name` يصبح القيمة الأصلية) أو إزالتها، وهو مفيد لتطبيع الناتج قبل الإيداع.
هل يحافظ العارض على التعليقات عند إعادة الإصدار؟
لا. معظم مكتبات YAML (بما فيها js-yaml) تجرد التعليقات أثناء دورة تحميل/تفريغ لأن نموذج بيانات YAML لا يتضمنها. إذا كانت التعليقات مهمة، عدّل الملف الأصلي مباشرة.
لماذا يقول العارض إنه لا يستطيع العثور على حرف tab؟
لا يسمح YAML بعلامات التبويب للإزاحة -- المسافات فقط. حتى تبويب واحد داخل قيمة عددية كتلية يمكن أن يربك بعض المحللات. استبدل علامات التبويب بالمسافات وحاول مجددًا.
هل سيدمج العارض ملفات YAML متعددة المستندات؟
يحلل كل مستند ويعيد إصداره بشكل منفصل، لكن العارض الحالي يصدر مستندًا واحدًا في كل مرة. استخدم محررًا متعدد المستندات لتلك الملفات.
هل يُرفع YAML الخاص بي؟
لا. يحدث التحليل وإعادة التنسيق محليًا عبر مكتبة js-yaml المدمجة؛ لا يغادر شيء المتصفح.