منسّق YAML
الإعدادات
المسافة البادئة
تصغير
إزالة جميع المسافات البيضاء
الإدخال
الإخراج
التفاصيل التقنية
كيف يعمل مُنسِّق YAML
ما الذي تفعله الأداة
يقوم مُنسِّق YAML بتجميل وتنسيق ملفات YAML (YAML Ain't Markup Language)، مما يجعلها أكثر قابلية للقراءة وأكثر اتساقًا. يستخدم مُنسِّق yaml هذا مكتبة js-yaml لضمان التنسيق الصحيح وفقًا لمعايير YAML. عندما تحتاج إلى تنسيق ملفات yaml، أو تنظيف ملفات الإعدادات، أو ضمان اتساق المسافات البادئة والبنية، توفر هذه الأداة قدرات تنسيق موثوقة. يتعامل مُحسِّن yaml مع بُنى YAML المعقدة بما في ذلك القوائم والقواميس والكائنات المتداخلة والسلاسل متعددة الأسطر مع الحفاظ على صياغة YAML صالحة.
حالات استخدام شائعة للمطورين
يستخدم المطورون مُنسِّقات YAML عند العمل على ملفات الإعدادات لمشاريع مثل Docker Compose وبيانات Kubernetes manifests وخطوط CI/CD (GitHub Actions وGitLab CI) أو إعدادات تطبيقات متنوعة. تُعد وظيفة مُنسِّق yaml عبر الإنترنت ضرورية عند تنظيف ملفات إعدادات تم تعديلها يدويًا، أو ضمان تنسيق متسق بين أعضاء الفريق، أو تجهيز ملفات الإعدادات للتحكم بالإصدارات. يحتاج كثير من المطورين إلى تنسيق yaml عند الترحيل من صيغ إعدادات أخرى، أو توحيد إعدادات المشروع، أو تصحيح مشكلات صياغة YAML. يساعد مُجمِّل yaml عند العمل على البنية التحتية ككود، أو إعدادات النشر، أو أي نظام يستخدم YAML للإعدادات. يُعد تنسيق YAML ذا قيمة للحفاظ على ملفات إعدادات مقروءة وسهلة الصيانة ضمن سير عمل التطوير الحديث.
تنسيقات البيانات أو أنواعها أو متغيراتها
يدعم مُنسِّق YAML هذا مواصفة YAML 1.2، بما في ذلك القيم scalar والتسلسلات sequences والتعيينات mappings والمراسي anchors والأسماء المستعارة aliases والسلاسل متعددة الأسطر. تتعامل الأداة مع مستندات YAML، والمستندات المتعددة ضمن ملف واحد، وجميع ميزات YAML القياسية. كما تدعم أنماط مسافات بادئة متعددة (مسافتان، 4 مسافات، علامات تبويب) ويمكنها تصغير YAML للاستخدام في الإنتاج. يحافظ المُنسِّق على البنية الدلالية لـ YAML مع تحسين قابلية القراءة. على سبيل المثال، سيقوم بتنسيق YAML مثل:
name:DevToys Web Pro
version:1.0.0
features:-JSON Formatter
-Base64 Encoderإلى YAML مُنسَّق بمسافات بادئة صحيحة:
name: DevToys Web Pro
version: 1.0.0
features:
- JSON Formatter
- Base64 Encoderالميزات الرئيسية
- تكامل js-yaml:يستخدم مكتبة js-yaml لتحليل YAML وتنسيقه وفقًا لمعايير الصناعة
- مسافات بادئة قابلة للتهيئة:اختر بين مسافتين أو 4 مسافات أو علامات تبويب للمسافة البادئة
- تنسيق في الوقت الحقيقي:شاهد المخرجات المُنسَّقة أثناء الكتابة مع تحديثات تلقائية
- التصغير:خيار لتصغير YAML عبر إزالة المسافات البيضاء غير الضرورية
- التحقق من الصياغة:يحدد أخطاء صياغة YAML ويبلّغ عنها أثناء التنسيق
المزالق الشائعة والحالات الطرفية
أحد القيود هو أن المُنسِّق قد لا يحافظ على جميع خيارات التنسيق الأصلية، مثل تفضيلات التباعد أو فواصل الأسطر المحددة. قد تتطلب YAML ذات البُنى المتداخلة المعقدة أو تنسيقات السلاسل الخاصة تعديلات يدوية بعد التنسيق. قد تزيل بعض مُصغِّرات YAML مسافات بيضاء تؤثر على المعنى في سياقات معينة. قد تحتاج YAML التي تحتوي على مراسٍ أو أسماء مستعارة أو وسوم إلى معالجة خاصة. يتعامل المُنسِّق مع صياغة YAML القياسية، لكن الحالات الحدّية مثل الوسوم المخصصة أو أنماط التدفق (flow styles) قد لا تُنسَّق بشكل صحيح. قد لا تُنسَّق YAML التي تحتوي على أحرف خاصة أو مشكلات ترميز بشكل صحيح.
متى تستخدم هذه الأداة بدلًا من الكود
استخدم مُنسِّق YAML هذا لمهام التنسيق السريعة، أو لتنظيف YAML لمرة واحدة، أو عند العمل خارج بيئة التطوير لديك. وهو مثالي لتنسيق YAML من واجهات API أو القوالب أو الشيفرة القديمة. لتطوير الإنتاج، ادمج تنسيق YAML في عملية البناء باستخدام أدوات مثل Prettier مع إضافة yaml أو yamlfmt. تتفوق أدوات المتصفح في التنسيق السريع والتعلّم، بينما توفر أدوات البناء الأتمتة والاتساق والتكامل مع خطوط CI/CD.