امتداد:CodeMirror

This page is a translated version of the page Extension:CodeMirror and the translation is 100% complete.
الدليل المرجعي لامتدادات ميدياويكي
OOjs UI icon advanced-invert.svg
CodeMirror
حالة الإصدار مستقر
Pride and codemirror.png
تنفيذ واجهة مستخدم
بيان يتولى تظليل الإعراب البرمجي في محرر نصوص الويكي
المؤلف/المؤلفون Pavel Astakhov (pastakhovنقاش)
آخر إصدار 4.0.0
سياسة التوافق تصدر اللقطات البرمجية مع ميدياويكي. الإصدار الرئيسي لا يتوافق مع الإصدارات السابقة.
MediaWiki 1.32+
PHP 5.3+
تغييرات قاعدة البيانات لا
ترخيص رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل
  • $wgCodeMirrorLineNumberingNamespaces
ترجم الامتداد CodeMirror لو كان متوفرا على translatewiki.net
دور فاغرانت codemirror
المسائل المهام المفتوحة · الإبلاغ عن عطل تقني

يتولى امتداد CodeMirror تظليل الإعراب البرمجي في محرر نصوص الويكي في برمجيات ميدياويكي. يضيف هذا الأمر زر يستخدم الأيقونة Codemirror-icon.png إلى شريط التحرير يسمح بالتغيير إلى تظليل الإعراب البرمجي أو عدم تظليل الإعراب البرمجي. يدعم هذا الامتداد شريط أدوات محرر الويكي 2010 وكذلك شريط أدوات المحرر المرئي.

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

اختيرت الألوان المستخدمة في هذا الامتداد خصيصًا كي تكون ذات تباين عالٍ، وبالتالي تيسر الاستخدام لذوي الاحتياجات الخاصة ولأغراض سهولة القراءة. تقدم الألوان إمكانية وصول أفضل للأفراد الذين يعانون من ضعف البصر وكذلك المستخدمين الذين يعملون في ضوء النهار الباهر. (المزيد من المعلومات)

السمات

مطابقة الأقواس

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

ترقيم الأسطر

تعرض أرقام السطور آليًا في وضع تحرير نصوص الويكي في كلا المحررين.

هذه السمة متاحة في نطاق اسم القوالب على أغلب مواقع الويكي وفي كافة نطاقات الاسم على بعض مواقع الويكي (طالع خارطة الطريق و الضبط).

وضع عمى الألوان

يقدم CodeMirror للمستخدمين الذين يعانون صعوبة في التمييز بين الألوان وضع ملائم لهم. يمكن تفعيل السمة على مواقع الويكي التي يوجد عليها CodeMirror عن طريق الذهاب إلى صفحة Special:Preferences.

 


حينما يكون المخطط الملائم لمن يعانون من عمى الألوان، سوف تتغير ألوان العناصر التالية داخل الصفحة:

العناوين والرموز والتوقيعات وأسماء الأقسام والكلمات السحرية #E4A400
القوالب #9C3A00
وسوم إتش تي إم إل والمراجع والصيغ الرياضية #56B4E9
المتغيرات #009E73

كما أن تظليلات الخلفية وألوانها سوف تزال عن كافة النصوص والعناصر. تظل أمور الخط العريض والكلمات التي تحتها خط كما هي.


دعم متصفحات الإنترنت

كافة متصفحات الإنترنت التي تدعم برمجيات ميدياويكي تحظى بدعم.

التثبيت

  • ثبت واحد مما يلي: امتداد امتداد:WikiEditor أو VisualEditor ، كما هو مبين في صفحات كلا منهما؛ يتطلب الأمر وجود واحد من الاثنين على الأقل حتى يمكن استخدام هذا الامتداد.
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎CodeMirror داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من ملف "LocalSettings.php ":
    wfLoadExtension( 'CodeMirror' );
    
  • أعدّ الامتداد حسب ما هو مطلوب.
  •   تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.


تنصيب Vagrant:

  • لو كنت تستخدم Vagrant ، ثبته مستخدما vagrant roles enable codemirror --provision

الإعداد

لأغراض تخصيص الألوان والأساليب، طالع صفحة المساعدة على ميتا. يمكنك استخدام أساليبك الخاصة في تظليل نصوص الويكي. الأساليب المستخدمة متاحة على هنا. يجب عليك أن تضع أساليبك الخاصة في common.css .

أضف الكود البرمجي التالي في الجزء الأسفل من LocalSettings.php .

# يسمح باستخدام CodeMirror افتراضيًا إلا أنه لا يزال يسمح للمستخدمين بتعطيله
$wgDefaultUserOptions['usecodemirror'] = 1;

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

# تفعيل خاصية مطابقة الأقواس في CodeMirror
$wgCodeMirrorEnableBracketMatching = true;

# تفعيل الألوان المخصصة لذوي الاحتياجات الخاصة في CodeMirror
$wgCodeMirrorAccessibilityColors = true;

# تفعيل ترقيم الأسطر في CodeMirror
# افتراضيًا في نطاق الاسم المخصص للقوالب [ NS_TEMPLATE ]
# null ينشط هذا لكافة نطاقات الأسماء
# [] يعطل هذا في أي مكان آخر
$wgCodeMirrorLineNumberingNamespaces = null;

دمج الامتداد

لو كان امتداد ميدياويكي لديك يضيف وسم جديد وكنت ترغب في التأكد أن امتداد CodeMirror يظلل المحتوى داخله كما يرام، يمكنك إضافة دعم CodeMirror إلى امتدادك. إليك مثالين اثنين: امتداد Cite وامتداد PhpTags.

دمج جافا سكريبت

تستخدم الوصلات المباشرة التالية في هذا الامتداد:

وصلة المتغيرات
النوع وصف
ext.CodeMirror.switch منطقية/بوليانية هل محرر CodeMirror معروض الآن أم لا
عنصر jQuery «المحرر» الحالي، الذي إما هو ‎‎<textarea />‎ المعتاد أو عنصر ‎.CodeMirror.

للعمل

  • قوائم تعريف التظليل ( ;foo :bar ) ‏ (مهمة T170042)
  • الإكمال الآلي (phab:T95100)
  • طي الكود البرمجي (مهمة T166098)
  • التظليل داخل وسم غاليري (<gallery> foo | bar </gallery>)

انظر أيضا