امتداد:CodeMirror

From mediawiki.org
This page is a translated version of the page Extension:CodeMirror and the translation is 100% complete.
لا تخلط بينه وبين CodeEditor .
الدليل المرجعي لامتدادات ميدياويكي
CodeMirror
حالة الإصدار مستقر
تنفيذ واجهة مستخدم
بيان يتولى تظليل الإعراب البرمجي في محرر نصوص الويكي
المؤلف/المؤلفون Pavel Astakhov (pastakhovنقاش)
آخر إصدار 5.0.0
سياسة التوافق تصدر اللقطات البرمجية مع ميدياويكي. الإصدار الرئيسي لا يتوافق مع الإصدارات السابقة.
MediaWiki 1.32+
PHP 5.3+
تغييرات قاعدة البيانات لا
ترخيص رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل
  • $wgCodeMirrorConflictingGadgets
  • $wgCodeMirrorV6
  • $wgCodeMirrorTemplateFoldingNamespaces
  • $wgCodeMirrorLineNumberingNamespaces
تنزيلات ربع سنوية 366 (Ranked 13th)
استخدام مواقع الويكي العمومية 6,549 (Ranked 62nd)
ترجم الامتداد CodeMirror لو كان متوفرا على translatewiki.net
دور فاغرانت codemirror
المسائل المهام المفتوحة · الإبلاغ عن عطل تقني

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

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

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


السمات

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

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

ترقيم الأسطر

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

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

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

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

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

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

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


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

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

التثبيت

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


تنصيب Vagrant:

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

الإعداد

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

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

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

لأجل تفعيل سمات إضافية:

$wgCodeMirrorLineNumberingNamespaces
حصر ترقيم الأسطر بنطاقات اسم معينة. القيمة الافتراضية هي null، التي تفعل هذا لكافة نطاقات الأسماء. اضبط القيمة على [] لتعطيلها في كل مكان.
$wgCodeMirrorV6
Temporary feature flag to control the migration to CodeMirror 6 (phab:T259059).
$wgCodeMirrorConflictingGadgets
مصفوفة من أسماء الإضافات التي لو جرى تمكينها سوف تمنع CodeMirror من التحميل. القيمة الافتراضية هي wikEd.

دمج الامتداد

This functionality is subject to change following the CodeMirror 6 upgrade.

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

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

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

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

لو كنت تحتاج للتفاعل مع محتوى واحد من مرات CodeMirror، استخدم jQuery.plugin.textSelection.

للعمل

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


انظر أيضا