مُولد .editorconfig

مُولد .editorconfig

بناء ملف صالح ومتبع للإرشادات .editorconfig لمشروعك دون تذكر أسماء الخصائص أو مراجعة القيم. اختر نموذجًا لغويًا لغتك، قم بتعديل الإعدادات العالمية، قم بتفعيل بعض التغييرات الخاصة باللغة، وانسخ النتيجة مباشرة إلى جذر مخزنك.

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

كيفية استخدام

1. اختر إعداد سريع الذي يتطابق مع لغتك الأساسية (JavaScript/TypeScript، Python، Go، PHP، Ruby، الويب (HTML/CSS/JS)، أو مختلطة). يملأ النموذج كل الإعدادات العالمية المذكورة أدناه.
2. تعديل الإعدادات العالمية — أسلوب التلميح، حجم التلميح، عرض التبويب، نهاية السطر، مجموعة الأحرف، أقصى طول سطر، حذف المسافات الخلفية، وإدراج سطر جديد في النهاية.
3. أي الإغلاق اللغوي تحتاج إليه. كل تفعيل يضيف قسمًا مناسبًا مُحددًا مثل [*.py] أو [{Makefile,makefile,GNUmakefile}] مع قواعد منطقية لكل لغة.
4. انسخ الملف المُنشأ أو احفظه كـ .editorconfig وأدخله إلى جذر مخزنك. تُستقبل ملحقات EditorConfig في VS Code، أدوات IDE من JetBrains، Vim، Sublime، ومعظم المحررات الأخرى تلقائيًا.

خصائص

• النماذج اللغوية – JavaScript/TypeScript، Python، Go، PHP، Ruby، الويب (HTML/CSS/JS)، ونماذج مختلطة تغطي المخازن المختلطة.
• كل خاصية عالمية معيارية 0–9 (top row) indent_style, indent_size, tab_width, end_of_line, charset, trim_trailing_whitespace, insert_final_newline، واختياري max_line_length.
• التعديلات المُحددة – تبديلات بسيطة لـ Markdown، YAML، JSON، JS/TS، CSS، HTML/XML، Python، Go، PHP، Ruby، Makefile (يُفرض تلميح بعلامة التبويب)، و .bat/.cmd (يُفرض أطراف سطر CRLF).
• العرض المباشر – الملف يُحدث تغييرًا عند كل تغيير، مع زر نسخ إلى الذاكرة والتنزيل بضغطة زر.
• من جانب العميل فقط – حالة النموذج لا تغادر متصفحك؛ لا يتم إرسال أي شيء، ولا يتم تسجيله أو تخزينه على الخادم.
• مُستقر دائمًا – كل خاصية مُصدرة محدودة إلى القيم المقبولة في مواصفات EditorConfig، لذا فإن ملفك لن يُتجاهل بشكل سري.

لماذا EditorConfig؟

بدون تكوين مشترك، يمكن أن ينتهي مخزن واحد بوجود تبويب في ملف، أربع مسافات في ملف آخر، وأطراف سطر CRLF تظهر من مساهم من نظام ويندوز. يحل EditorConfig هذا الأمر من خلال السماح لملف واحد في الجذر لتحديد اتفاقية التنسيق التي يجب أن يتبعها كل محرر قبل أن يبدأ أي مدقق أو مُعدّل تنسيق.