امتداد:CodeMirror

لا تخلط بينه وبين CodeEditor .

الدليل المرجعي لامتدادات ميدياويكي

CodeMirror حالة الإصدار مستقر
تنفيذ	واجهة مستخدم
بيان	يتولى تظليل الإعراب البرمجي في محرر نصوص الويكي
المؤلف/المؤلفون	Pavel Astakhov (pastakhovنقاش)
آخر إصدار	6.0.0
سياسة التوافق	تصدر اللقطات البرمجية مع ميدياويكي. الإصدار الرئيسي لا يتوافق مع الإصدارات السابقة.
MediaWiki	1.32+
PHP	5.3+
تغييرات قاعدة البيانات	لا
ترخيص	رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل	تنزيل الامتداد غت [?]: تنزيل ملف غت الرئيسي تصفح المستودع (Phabricator · GitHub) تاريخ الالتزام مساهمو المستودع (غت هب) مراجعة الكود البرمجي
المتغيرات $wgCodeMirrorConflictingGadgets $wgCodeMirrorV6 $wgCodeMirrorTemplateFoldingNamespaces $wgCodeMirrorLineNumberingNamespaces
الروابط المستخدمة EditPage::showEditForm:initial EditPage::showReadOnlyForm:initial GetPreferences ResourceLoaderGetConfigVars
تنزيلات ربع سنوية	278 (Ranked 17th)
استخدام مواقع الويكي العمومية	6,549 (Ranked 62nd)
ترجم الامتداد CodeMirror لو كان متوفرا على translatewiki.net
دور فاغرانت	codemirror
المسائل	المهام المفتوحة · الإبلاغ عن عطل تقني

CodeMirror is currently being upgraded to a new major version. See Extension:CodeMirror/6 for the new documentation.

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

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

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

السمات

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

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

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

ترقيم الأسطر

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

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

• 
  ترقيم الأسطر في محرر نصوص الويكي 2010
• 
  ترقيم الأسطر في محرر نصوص الويكي 2017

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

يقدم 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' );
  

• أعدّ الامتداد حسب ما هو مطلوب.
•  تم التنفيذ – اذهب إلى 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. See Extension:CodeMirror/6#Integration for documentation on CodeMirror 6.

متعقّب على فبريكاتور
المهمة T348684

لو كان امتداد ميدياويكي لديك يضيف وسم جديد وكنت ترغب في التأكد أن امتداد 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>)

انظر أيضا

• نظرة عامة على السمات الناقصة والأعطال البرمجية: MediaWiki-extensions-CodeMirror
• User:Remember the dot/Syntax highlighter
• Extension:VisualEditor
• امتداد:WikiEditor
• Extension:CodeEditor
• تقنية المجتمع/تظليل النحو البرمجي في محرر نصوص الويكي - تشتمل على معلومات تتعلق بكيفية تخصيص الألوان
• c:Category:MediaWiki extension CodeMirror