Softonic

منسق YAML

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

مدخلات YAML

الصق YAML بما لا يتجاوز 1,000,000 حرف و100 مستند. يجري التنسيق داخل هذا المتصفح.

يتسامح YAML مع الصياغة ولا يتسامح مع المسافات البادئة. انزلاق مسافة واحدة قد يحول مفتاحًا بصمت إلى عنصر قائمة، والمسافات البادئة المختلطة تجعل مراجعات الكود مرهقة. يحلل هذا المنسق مدخلاتك بمحرك js-yaml (المخطط الأساسي core لـ YAML 1.2) داخل متصفحك مباشرة، ثم يعيد إخراجها بالمسافة البادئة ونمط المجموعات وعلامات الاقتباس وترتيب المفاتيح وعرض السطر التي تختارها، لتعطي ملفات الإعداد فروقات نظيفة في نظام التحكم بالإصدارات وتبقى سهلة القراءة لجميع المساهمين.

كيف تنسق YAML

  1. 1

    الصق YAML

    حتى 1,000,000 حرف وحتى 100 مستند في تدفق واحد. لا يُرفع أي شيء: يعمل التحليل داخل متصفحك.

  2. 2

    اختر الخيارات

    عرض المسافة البادئة، النمط الكتلي أو الانسيابي، علامات الاقتباس، ترتيب المفاتيح، وعرض السطر.

  3. 3

    نسق

    تعيد الأداة بناء كل مستند بمسافات قياسية وبالنمط الذي اخترته.

  4. 4

    انسخ واعتمد التغيير

    الناتج YAML مطابق بنيويًا، جاهز للصقه من جديد في ملف الإعداد.

قبل وبعد

مدخلات فوضوية:

server:
  port:   8080
  hosts: ["api.example.com",  "api2.example.com"]
  timeout:  30
  debug: true

بعد التنسيق (مسافتان، النمط الكتلي):

server:
  port: 8080
  hosts:
    - api.example.com
    - api2.example.com
  timeout: 30
  debug: true

خيارات التنسيق

الخيار القيم الافتراضي
عرض المسافة البادئة 2، 4 2
نمط المجموعات كتلي، انسيابي كتلي
علامات الاقتباس الحد الأدنى، مزدوج، مفرد الحد الأدنى
ترتيب المفاتيح الأصلي، أبجدي الأصلي
عرض السطر 80، 120، غير محدود 120

قواعد الاقتباس

الحد الأدنى من الاقتباس هو ما تريده غالبًا: تبقى السلاسل النصية دون علامات اقتباس ما لم يكن تركها مكشوفة غير آمن. يضيف المنسق علامات الاقتباس تلقائيًا في الحالات التالية:

  • القيم المنطقية القديمة المكتوبة كسلاسل: yes وno وon وoff وy وn. يقرؤها YAML 1.2 كسلاسل نصية أصلًا، لكن كثيرًا من المحللات ما زالت تتبع YAML 1.1 حيث تتحول no غير المقتبسة إلى false. يضعها المنسق دائمًا بين علامات اقتباس في الناتج، فلا تستطيع علة النرويج الشهيرة (قراءة NO على أنها false في قائمة دول) أن تصيب من يستهلك ملفك.
  • الأرقام المكتوبة كسلاسل: '007' و'3.14'. من دون اقتباس ستُحلل كأعداد صحيحة أو عشرية.
  • السلاسل التي تحتوي محارف مثل : أو # أو [ أو { أو تبدأ بمسافة، حيث سيغير الإخراج المكشوف البنية.

تنظيفات تحصل عليها في كل تشغيل

  • المسافات في نهاية الأسطر. تُحذف.
  • المسافات البادئة المختلطة أو غير المنتظمة. تُوحد على عرض المسافة البادئة الذي اخترته.
  • الأسطر الفارغة داخل المجموعات. تُحذف.
  • علامات الجدولة (Tab) في المسافة البادئة. يمنعها YAML؛ يرفض المحلل المدخلات برسالة خطأ واضحة تشير إلى السطر، لتصلحه بدلًا من نشر ملف سترفضه المحللات الأخرى.

التعليقات والمراسي ومفاتيح الدمج

التنسيق يوحد نموذج المستند، ولهذا حدود يجدر معرفتها قبل اعتماد التغيير:

  • التعليقات تُحذف. يحل المحلل المستند إلى بيانات، لذا لا تنجو تعليقات # من التنسيق. احتفظ بنسخة إن كانت تعليقاتك مهمة.
  • المراسي والأسماء البديلة تُحل. تبقى العقد المشتركة عبر اسم بديل مشتركة، لكنها تُخرج من جديد بأسماء مولدة مثل &ref_0؛ ولا تُحفظ أسماء المراسي الأصلية.
  • مفاتيح الدمج (<<:) تُحل إلى خرائط عادية تحمل القيم المدموجة في مكانها.

التدفقات متعددة المستندات

التدفقات التي تضم عدة مستندات مدعومة: يُنسق كل مستند على حدة ثم يعاد ضمها بالفاصل ---، حتى 100 مستند في التشغيل الواحد.

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

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

عندما تُقرأ السلسلة المكشوفة على أنها شيء آخر، يصبح الاقتباس ضروريًا للسلامة. حالات شائعة: مفاتيح أو قيم مكونة من أرقام فقط، وسلاسل تحتوي : أو #، وقيم منطقية قديمة مثل yes وno تقرؤها محللات YAML 1.1 على أنها true/false.

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

لا. يعمل التحليل والتنسيق في متصفحك بمحرك js-yaml المدمج. لا يمر YAML عبر الخادم، ولا يخزن، ولا يضاف أبدًا إلى عنوان الصفحة؛ إنما يبقى في جلسة المتصفح هذه فقط لكي تعرض الواجهة متعددة الخطوات نتيجتك.

أدوات ذات صلة

مرجع جدول ASCII

جدول ASCII كامل من 0 إلى 127 مع التمثيل العشري والست عشري والثماني والثنائي والمرجع الرقمي في HTML لكل محرف، بما في ذلك أكواد التحكم مثل NUL وLF وDEL.

مرجع أحرف HTML

قائمة قابلة للبحث بكيانات HTML، مع رموزها المسمّاة والرقمية، بالإضافة إلى خيار النسخ بنقرة واحدة للأحرف والرموز الخاصة.

منسق JSON

الصق JSON لتنسيقه بمسافتين أو أربع مسافات، أو تصغيره إلى ناتج مضغوط، أو فحص بنيته بسرعة قبل نسخ النتيجة.

مولد لوحة الألوان

أنشئ لوحات ألوان أحادية أو متجاورة أو مكملة أو ثلاثية أو رباعية من لون HEX أساسي، ثم صدّر متغيرات CSS جاهزة للنسخ.

محول ASCII إلى Hex

حوّل نص ASCII إلى قيم bytes بالنظام الست عشري. يستخدم الناتج رقمين hex لكل محرف، جاهزا لملفات memory dumps أو packet traces أو جداول firmware.

محول Base64 إلى Hex

حوّل سلسلة Base64 إلى بايتاتها الأساسية معروضة بالنظام الست عشري (hex). مفيد لفحص الرموز المميزة والمفاتيح والشهادات ورموز JWT.