# منسّق TOML

نسّق ملفات إعداد TOML مثل Cargo.toml وpyproject.toml وإعدادات التطبيقات الأخرى باستخدام إضافة TOML ‏Prettier. يوحّد المنسّق المسافات حول علامات المساواة والجداول المضمنة والمصفوفات، ويفصل الجداول بسطر فارغ، ويحافظ على كل التعليقات، ويعرض أخطاء الصياغة مع رقم السطر والعمود، ما يتيح للمطورين ترتيب الإعدادات بأمان قبل إيداعها.

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

### ما المحرك الذي ينسّق TOML؟

تستخدم الأداة Prettier 3 مع prettier-plugin-toml 4.1 على الخادم. تقرأ مستندات TOML 1.0 وتطبعها بنمط موحّد.

### ما الذي يتغير في المخرجات؟

تُضاف مسافة واحدة حول علامة المساواة بين المفاتيح والقيم، وتُنسّق الجداول المضمنة والمصفوفات بمسافات متساوية. تُدمج الأسطر الفارغة الزائدة، ويُفصل كل عنوان جدول عن القسم السابق بسطر فارغ.

### هل تُحفظ التعليقات؟

نعم. تبقى التعليقات التي تشغل سطرًا كاملًا والتعليقات اللاحقة للقيم في مواضعها، فتحافظ ملفات الإعداد المشروحة على ملاحظاتها.

### هل ستُرتب المفاتيح أو الجداول؟

لا. تحتفظ المفاتيح والجداول ومصفوفات الجداول بترتيبها الأصلي، وهو أمر مهم للملفات التي يقرأها الأشخاص من أولها إلى آخرها.

### هل يمكن أن تتغير علامات اقتباس السلاسل النصية؟

قد يُعاد كتابة السلاسل الحرفية ذات علامات الاقتباس المفردة بعلامات اقتباس مزدوجة عندما لا تحتوي القيمة على شرطة مائلة عكسية أو علامة اقتباس مزدوجة، مع الحفاظ على القيمة كما هي. أما السلاسل التي تتطلب اقتباسًا حرفيًا، فتحتفظ بعلامات الاقتباس المفردة.

### كيف تُعالج المصفوفات الطويلة؟

تبقى المصفوفات التي يتسع لها عرض الطباعة في سطر واحد. أما المصفوفات التي تنتهي بفاصلة أو تتجاوز العرض، فتُطبع بعنصر واحد في كل سطر.

### ماذا يحدث عند وجود TOML غير صالح؟

يتوقف التنسيق وتعرض الأداة رسالة المحلّل مع رقم السطر والعمود، مثل حالة غياب قيمة بعد علامة مساواة. وتُعرض المفاتيح المكررة وغيرها من أخطاء TOML بالطريقة نفسها.

### هل يمكنني تغيير المسافة البادئة؟

نعم. اختر مسافتين أو أربعًا أو علامات جدولة للمصفوفات المتداخلة، وعرض طباعة من 40 إلى 200 حرفًا، مع اعتماد 80 افتراضيًا.

### ما الحد الأقصى لحجم الملف؟

حتى 1 MB من النص لكل طلب، وهو حجم يفوق بكثير ملفات الإعداد المعتادة. يتوقف التنسيق بعد 10 ثوانٍ.

### هل تُخزَّن إعداداتي؟

لا. قد تحتوي ملفات الإعداد على أسرار، لذا تُعالَج محتوياتها في الذاكرة فقط ولا تُحفظ أو تُسجّل مطلقًا.

إعلانك هنا؟

[راسلنا عبر البريد الإلكتروني](mailto:hi@dennn.is?subject=%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%20%D8%B9%D9%84%D9%89%20OneClick%20Pro)

[إعلان مجموعة إضافات جاهزة للوكلاء من أجل WordPress.](https://sleekwp.com/?ref=oneclickpro)