این ابزار درست کار نمی‌کند؟

دربارهٔ ابزار «مرتب کردن YAML آنلاین»

این ابزار اسناد YAML را فرمت‌بندی، اعتبارسنجی و reflow می‌کند. یک پیکربندی YAML — Kubernetes manifest، فایل Docker Compose، خط لوله CI، playbook Ansible — را جای‌گذاری کنید و ابزار تورفتگی را عادی می‌کند، کلیدها را (به صورت اختیاری) مرتب می‌کند و اطمینان حاصل می‌کند که نتیجه از نظر نحوی معتبر است.

نحو مبتنی بر تورفتگی YAML به طور بدنامی به راحتی با یک فاصله نابه‌جا شکسته می‌شود. فرمت‌بند خطاهای ساختاری را می‌گیرد و خطی را که در آن پارسر شکست خورده گزارش می‌دهد — بسیار سریع‌تر از پیمایش در یک فایل ۵۰۰ خطی Kubernetes به دنبال تورفتگی بد.

از آن برای پاکسازی YAML قبل از commit در کنترل نسخه، رفع YAML جای‌گذاری شده از یک چت که در آن قالب‌بندی از دست رفته، یا استانداردسازی فایل‌ها در سراسر یک تیم که از ویرایشگرهای مختلف استفاده می‌کند، استفاده کنید.

چطور از این ابزار استفاده کنم؟

چطور یک سند YAML را فرمت کنم؟

  1. YAML را بچسبانید

    سند YAML را در فیلد «YAML» قرار دهید. هر سندی که کتابخانهٔ `yaml` بتواند parse کند — شامل anchorها، استریم‌های چندسنده‌ای (با `---`) و کلیدهای پیچیده — پذیرفته می‌شود.

  2. معنای «فرمت» اینجا

    ابزار با `YAML.parse` به مقدار JS تجزیه می‌کند، سپس با `YAML.stringify` و lineWidth ۱۰۰ دوباره stringify می‌کند. نظرات و ترتیب اصلی کلیدهای mapping حفظ نمی‌شوند — این یک re-emit است نه pretty-printer.

  3. «اجرا» را بزنید

    خروجی یک فیلد `formattedYaml` با سند نرمال‌شده است — تورفتگی یکدست، quoting و wrap خط در ستون ۱۰۰.

  4. خطاهای parse

    YAML نامعتبر خطایی به همراه شماره خط می‌دهد. مقصرین رایج: tab به‌عنوان indent، quoteهای نامتوازن یا `:` بی‌جا در رشتهٔ بدون quote. اصلاح کنید و دوباره اجرا کنید.