Loading…

حول منسق INI مزين INI عبر الإنترنت

هل تريد ملفات INI أنظف وأكثر قابلية للقراءة؟ تقوم هذه الأداة بتنسيق ملفات `.ini` و`.cfg` و`.conf` الخاصة بك باستخدام محرك Prettier المدعم لـ INI. وحدد المسافات حول `=`، احتفظ بالتعليقات، تحكم في المسافات البادئة، وفرض نهايات الأسطر بشكل متسق بحيث تبقى ملفات الإعدادات الخاصة بك مرتبة، جاهزة للإصدار وسهلة المراجعة.

الميزات الرئيسية لمنسق INI

  • توحيد المسافات حول `=` بحيث تكون المفاتيح والقيم قابلة للقراءة باستمرار داخل كل قسم
  • الحفاظ على الأقسام والمفاتيح والتعليقات في مكانها مع تقليم المسافات الزائدة غير الضرورية
  • تكوين حجم المسافة البادئة (مسافات) والاختيار بين المسافات أو علامات الجدولة لأسلوب المسافة البادئة
  • التحكم في نمط نهاية السطر (LF أو CRLF) لتجنب الاختلافات الصاخبة عبر المنصات
  • دعم السحب والإفلات لملفات `.ini` و `.cfg` و `.conf`، بالإضافة إلى اللصق المباشر في المحرر
  • تنسيق فوري مدعوم بمحرك Prettier المدرك لـ INI، مع نسخة احتياطية من الخادم عند الحاجة
  • يحافظ على التعليقات والأسطر الفارغة بحيث تظل وثائقك والتجميعات المرئية سليمة

🔧 كيفية استخدام منسق INI for ini-formatter

1

1. الصق أو ارفع التكوين الخاص بك

الصق محتوى INI في المحرر أو اسحب وأفلت ملف `.ini` أو `.cfg` أو `.conf`. يتم دعم الأقسام مثل `[core]` و `[user]` وأزواج `key = value` القياسية.

2

2. ضبط خيارات التنسيق

تخصيص حجم المسافة البادئة، واختيار المسافات أو علامات الجدولة للمسافة البادئة، واختيار نهاية سطر الإخراج (LF أو CRLF) لمطابقة مشروعك أو اتفاقيات المنصة.

3

3. انسخ أو نزل النتيجة

راجع الإخراج المنسق في لوحة المعاينة، ثم انسخه مرة أخرى إلى محررك أو حمل الملف النظيف وأضفه إلى التحكم في الإصدار.

المواصفات الفنية

أنواع الملفات المدعومة

يستهدف المنسق تنسيقات التكوين الكلاسيكية من نوع INI الشائعة الاستخدام في Windows وLinux وفي التطبيقات المختلفة.

الامتدادالوصف
.iniملفات INI كلاسيكية على نمط Windows مع رؤوس `[section]` وأزواج `key = value`
.cfgملفات التكوين العامة التي تستخدم بناء جملة مشابه لـ INI
.confملفات التكوين على نمط Unix/Linux التي تتبع اتفاقيات شبيهة بـ INI

الخيارات المتاحة (واجهة المستخدم)

تتعين الخيارات المعروضة في الواجهة مباشرة على إعدادات Prettier / المنسق الأساسية:

الخيارالوصف
نمط المسافة البادئةاختر بين المسافات أو علامات الجدولة للترويسة
حجم المسافة البادئةعدد المسافات لكل مستوى ترويسة عند استخدام المسافات
نهاية السطرتحكم في نهايات الأسطر (LF `\n` أو CRLF `\r\n`) لتحقيق الاتساق عبر المنصات

قواعد التنسيق (المدرك لـ INI)

يستخدم المُنسِّق ملحق Prettier المدرك لـ INI ومصمم للحفاظ على هيكل التكوين الخاص بك:

الجانبالسلوكملاحظات
الأقساميتم الاحتفاظ بعناوين [section] كما هييتم توحيد المسافات البيضاء حول أسماء الأقسام (مثال: `[ user ]` → `[user]`)
المفاتيح والقيميتم توحيد `key = value`يضمن اتساق المسافات حول `=` مع الحفاظ على نص المفتاح/القيمة الأصلي
التعليقاتيتم الحفاظ على الأسطر التي تبدأ بـ `;` أو `#`يتم الاحتفاظ بموضع التعليق حيثما أمكن للحفاظ على التوثيق
الأسطر الفارغةيتم الحفاظ عليها بين الأقساميساعد في الحفاظ على التجميع البصري مع إزالة المسافات الزائدة في النهاية
الترميزUTF-8 متوقعقد تحتاج الترميزات الغريبة إلى التحويل قبل التنسيق

الأخطاء والحالات الحدودية

مواصفات INI فضفاضة وأحيانًا تدفع الملفات الواقعية الحدود. عندما يواجه المُنسِّق صعوبة، فإنه عادةً ما يفشل بسرعة مع خطأ:

العَرَضالسبب المحتملما يجب فحصه
رسالة خطأ غير متوقعةهيكل غير مشابه لـ INI أو تنسيقات مختلطةتأكد من أن الملف غالبًا ما يكون بنمط `[section]` + `key = value`
مخرجات مقطوعة / غريبةبيانات ثنائية مضمنة أو أحاف تحكم غير عاديةقم بإزالة الكتل الثنائية أو تصديرها إلى تنسيق مختلف
حركة التعليقاتتوحيد عدواني في الحالات الحدوديةالتحقق من المواضع حول كتل التعليقات الكبيرة أو المحددات غير المعتادة

بدائل سطر الأوامر

تفضل أدوات CLI أو تريد إبقاء كل شيء محليًا؟ إليك بعض اللبنات الأساسية التي يمكنك تكييفها.

بايثون

تحليل وإعادة إصدار INI باستخدام configparser (أساسي)

python - << 'PY'
import configparser, sys
config = configparser.ConfigParser()
config.read('input.ini', encoding='utf-8')
with open('formatted.ini', 'w', encoding='utf-8') as f:
    config.write(f)
PY

يستخدم configparser المدمج في بايثون لقراءة وكتابة الأقسام والمفاتيح. ملاحظة: قد لا يتم الحفاظ على التعليقات والترتيب.

يونكس/لينكس

محاذاة تقريبية لعلامات التساوي باستخدام awk

awk -F '=' 'NF==2 { printf "%-24s = %s\n", $1, $2; next } { print }' input.ini > aligned.ini

محاذاة بسيطة على شكل أعمدة لأسطر `مفتاح = قيمة`؛ قد تحتاج التعليقات والقيم المعقدة إلى مراجعة يدوية.

حالات الاستخدام الشائعة

إدارة الأنظمة

  • تنظيف ملفات `.conf` في لينكس قبل إضافتها إلى مستودعات البنية التحتية
  • ترتيب ملفات `.ini` / `.cfg` لتطبيقات سطح المكتب لتسهيل استكشاف الأخطاء
[network]
ip = 192.168.0.1
mask = 255.255.255.0
gateway = 192.168.0.254

تطوير البرمجيات

  • الحفاظ على تكوينات INI خاصة بالبيئة للتطبيقات أو أدوات الاختبار
  • الحفاظ على إعدادات الميزات والإعدادات القائمة على INI قابلة للقراءة في نظام التحكم بالإصدار
[build]
target = production
optimize = true
log_level = info

التوثيق والدعم

  • إنشاء أمثلة INI نظيفة لملفات README والويكي
  • مشاركة تكوينات إعادة الإنتاج المصغرة والمنسقة جيدًا مع الدعم أو الزملاء

❓ Frequently Asked Questions

🔁هل سيغير المُنسِّق منطق المفاتيح/القيم؟

لا. المُنسِّق يعدل التخطيط فقط: المسافات، المسافات البادئة ونهايات الأسطر. يتم الحفاظ على المفاتيح، القيم، الأقسام وعلاقاتها كنص، بافتراض أن الإدخال صالح لـ INI.

🧵ماذا يحدث لعلامات التساوي؟

الأداة توحد المسافات حول `=` بحيث تصبح `key=value`، `key = value` و `key = value` جميعها `key = value` متسقة. هذا يجعل التكوين أسهل للمسح والمقارنة.

📦هل يمكنني استخدام هذا على ملفات التكوين الكبيرة؟

نعم، ضمن حدود معقولة. الواجهة تقبل ملفات تصل إلى حوالي 5 ميغابايت والمُنسِّق لديه حد داخلي يقارب 2 مليون حرف للبقاء سريع الاستجابة في المتصفحات العادية.

🔒هل تتم المعالجة بالكامل في متصفحي؟

المُنسِّق يعمل أساسًا بمحرك Prettier مدرك لـ INI يعمل في متصفحك. إذا كان هذا المحرك أو الإضافة غير متاحين، قد تنتقل الأداة إلى مُنسِّق خلفي آمن. للتكوينات شديدة الحساسية أو الخاصة، يجب أن تفضل أدوات CLI محلية أو قائمة على المحرر.

🧾هل يقوم بالتحقق من صحة بناء جملة INI؟

يركز على التنسيق بدلاً من التحقق الكامل. العديد من الملفات غير الصحيحة ستظل تُنسَّق، لكن الهيكل المعطوب بشدة أو المحتوى غير INI قد ينتج أخطاء أو مخرجات غير متوقعة.

Pro Tips

Best Practice

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

Best Practice

فضّل المسافات بدلاً من علامات الجدولة في ملفات INI ما لم تتطلب أداة محددة علامات الجدولة—المسافات أكثر اتساقاً عبر المنصات والمحررات.

Best Practice

احتفظ بنمط واحد معياري لجميع تكوينات INI في المستودع؛ خلط الأنماط عبر الخدمات يجعل المراجعة واستكشاف الأخطاء أصعب.

Best Practice

إذا كان مشروعك يستخدم كلًا من INI وYAML/JSON، فطبق منمقات مخصصة لكل منها بحيث يظل نمط التكوين متسقاً عبر التنسيقات.

Additional Resources

تنسيق ملف INI (ويكيبيديا)
Documentation
وثائق Python configparser
Documentation
GitHub: مجموعة محللات INI
Documentation
Prettier – منمّق الكود المحدد
Documentation

Other Tools