إعدادات المحرر

EditorConfig عبارة عن مواصفة مفتوحة وتنسيق ملف لتلوين بناء الجملة ، ومحررات النصوص ، وبيئات التطوير المتكاملة (IDEs)، ويهدف إلى الحفاظ على أسلوب برمجة متسق، خاصةً للمجموعات التي تعمل معًا. ^{[ 1 ] [ 2 ]} يساعد هذا التنسيق في توحيد اصطلاحات التنسيق بين عدة محررات، وكذلك بين الأفراد. يخزن الإعدادات في ملف يمكن مشاركته بين عدة أشخاص أو استخدامه في عدة محررات (من قِبل الشخص نفسه أو من قِبل عدة أشخاص). ^{[ 3 ] [ 4 ]} يحدد هذا التنسيق قواعد تنسيق لغات البرمجة المختلفة أو ملفات النصوص المهيكلة الأخرى، مع اصطلاحات مثل الحرف الذي يُنهي به السطر وكيفية إدارة المسافة البادئة. ^{[ 5 ]}

يذكر موقع المشروع الإلكتروني أن "EditorConfig يساعد في الحفاظ على أنماط برمجة متسقة للعديد من المطورين الذين يعملون على نفس المشروع عبر مختلف المحررات وبيئات التطوير المتكاملة. يتكون مشروع EditorConfig من تنسيق ملف لتحديد أنماط البرمجة ومجموعة من إضافات محررات النصوص التي تُمكّن المحررات من قراءة تنسيق الملف والالتزام بالأنماط المحددة. تتميز ملفات EditorConfig بسهولة قراءتها وتوافقها التام مع أنظمة التحكم في الإصدارات." ^{[ 6 ]}

المصدر: ^{[ 7 ]}

عادةً ما يتم تخزين الإعدادات في ملف نصي مُشفّر بنظام UTF-8 : .editorconfig . تسمح بعض الأدوات بحفظ تفضيلات التنسيق كملف EditorConfig. ^{[ 8 ]} كل سطر:

• قد يكون فارغًا (يحتوي فقط على أحرف المسافات البيضاء )
• تعليق يبدأ بـ أو;#
• عنوان القسم، الذي يبدأ بقوس مربع [، وينتهي بقوس مربع ].
  • لا يجوز أن يحتوي عنوان القسم على أي أحرف غير المسافات البيضاء خارج الأقواس.
  • قد يحتوي على أي أحرف بين الأقواس بما في ذلك المسافات البيضاء/علامات الجدولة
  • يستخدم أحرف الشرطة المائلة /كفواصل للمسارات
    • \يُحظر استخدام علامات الخط المائل العكسي ، حتى في نظام التشغيل ويندوز.
• زوج المفتاح والقيمة= ، مع وجود فاصل يفصل المفتاح عن القيمة

أي تنسيق سطر آخر غير صالح. لا يدعم هذا التنسيق التعليقات المضمنة. إذا وُجد حرف "a" ;أو #"b" في أي مكان آخر غير بداية السطر، فإنه يُعتبر جزءًا من نص السطر. لا يدعم هذا التنسيق أي عملية تهريب للأحرف.

تعبيرات عامة

أسماء الأقسام عبارة عن أنماط مسار الملفات، باستخدام تنسيق مشابه لـ .gitignore ، وتستند إلى اصطلاحات يونكس.

أنماط أسماء الملفات

الشخصيات	الملفات المطابقة
*	أي سلسلة نصية (بأي طول) باستثناء فواصل المسار (/
**	أي سلسلة من الأحرف
?	أي حرف واحد
[seq]	أي حرف واحد في التسلسل
[!seq]	أي حرف منفرد غير موجود في التسلسل
{s1,s2,..sn}	أي سلسلة نصية مفصولة بفواصل. يمكن أن تكون هذه القائمة متداخلة. يجب أن تحتوي القائمة على أكثر من سلسلة نصية واحدة، لأن {somestring} ستطابق القيمة الحرفية ' {somestring}' (وهو على الأرجح ليس ما كان مقصودًا).
{n1..n2}	يطابق عددًا صحيحًا بين n1 و n2 ( أي يطابق${\displaystyle i\in \mathbb {Z} |n_{1}\leq i\leq n_{2}}$)

اعتمدت العديد من المحررات الشائعة دعم هذه المواصفات. ^{[ 9 ]} تحتوي صفحة المشروع على GitHub على مكتبات مكتوبة بلغة البرمجة Go ، ^{[ 10 ]} ولغة البرمجة C ، ^{[ 11 ]} ولغة البرمجة Python ، ^{[ 12 ]} بالإضافة إلى مكتبة Node.js. ^{[ 13 ]} يوجد على موقع المشروع قائمة شاملة بالمحررات المتاحة. ^{[ 14 ]}