امتداد: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 أو ما بعدها
التنزيل
  • $wgCodeMirrorEnableBracketMatching
  • $wgCodeMirrorAccessibilityColors
  • $wgCodeMirrorLineNumberingNamespaces
ترجم الامتداد CodeMirror لو كان متوفرا على translatewiki.net

طالع مصفوفة الاستخدام والإصدارات.

دور فاغرانت codemirror
المسائل المهام المفتوحة · الإبلاغ عن عطل تقني

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

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

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

Please note though, that the updated color scheme is currently only enabled by default for some wikis (see roadmap and configuration).

السمات

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

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

Please note that bracket matching is only enabled by default in some wikis (see roadmap and configuration).

ترقيم الأسطر

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

Please note that this feature is only enabled for the template namespace on most wikis (see roadmap and configuration).

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

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

التثبيت

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

الإعداد

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

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

# Enables use of CodeMirror by default but still allow users to disable it
$wgDefaultUserOptions['usecodemirror'] = 1;

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

# Enable bracket matching in CodeMirror
$wgCodeMirrorEnableBracketMatching = true;

# Enable accessible colors in CodeMirror
$wgCodeMirrorAccessibilityColors = true;

# Enable line numbering in CodeMirror
# defaults to the template namespace `[ NS_TEMPLATE ]`
# `null` enables it for all namespace
# [] for disabling everywhere
$wgCodeMirrorLineNumberingNamespaces = null;

دمج الامتداد

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

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

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

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

للعمل

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

انظر أيضا