Розширення:CodeMirror

This page is a translated version of the page Extension:CodeMirror and the translation is 39% complete.
Outdated translations are marked like this.
Довідка про розширення MediaWiki
OOjs UI icon advanced-invert.svg
CodeMirror
Статус релізу: стабільний
Pride and codemirror.png
Реалізація Інтерфейс користувача
Опис Надає підсвічування синтаксису в редакторі вікітексту.
Автор(и) Pavel Astakhov (pastakhovобговорення)
Найновіша версія 4.0.0
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.32+
PHP 5.3+
Зміни в БД No
Ліцензія GNU General Public License 2.0 or later
Завантажити
  • $wgCodeMirrorLineNumberingNamespaces
Translate the CodeMirror extension if it is available at translatewiki.net
Vagrant role codemirror
Issues Open tasks · Report a bug

Розширення CodeMirror надає підсвічування синтаксису в редакторі вікітексту MediaWiki. Воно додає кнопку з піктограмою Codemirror-icon.png до панелі засобів редагування, що дозволяє ввімкнення та вимкнення підсвічування синтаксису. Воно підтримує панель засобів Вікіредактора 2010 року, так само, як і панель засобів Візуального редактора.

За замовчуванням воно вимкнене. Коли ввімкнене, воно замінить стандартний textarea редактором, наданим бібліотекою CodeMirror. Коли вимкнене, ефект буде протилежним.

Кольори, використані в цьому розширенні, було оптимізовано для забезпечення високої контрастності, доступності та кращої читабельності. The colors provide better access for people with limited vision as well as for users working in bright daylight conditions. (more information)

Bracket matching

This feature highlights the innermost pair of brackets when the cursor lies between any bracket pair, and when the cursor lies directly next to a bracket, the feature highlights the corresponding matching bracket. Bracket matching is active in both editors when syntax highlighting is turned on in any namespace using these editors.

Line numbering

In the wikitext edit mode line numbers are automatically displayed in both editors.

This feature is enabled for the template namespace on most wiki, and on all namespaces on some wikis (see the roadmap and the configuration).

Colorblind mode

For users who have difficulty distinguishing between colors, CodeMirror offers a colorblind-friendly mode. This feature can be activated on wikis with CodeMirror enabled by navigating to the Special:Preferences page.

New preference colorblind syntax highlighting.png


With the colorblind-friendly scheme active, the colors of the following page elements change:

Headings, symbols, signatures, section names, magic words #E4A400
Templates #9C3A00
HTML tags, references, mathematical expressions #56B4E9
Variables #009E73

In addition, background highlights and colors are removed from all text and objects. Bolding and underlining behavior remains unaffected.


Підтримка браузерів

Підтримуються Всі браузери, що підтримуються MediaWiki.

Встановлення

  • Інсталюйте розширення Розширення:WikiEditor або VisualEditor як зазначено на їхніх сторінках; щонайменше одне з них вимагається для роботи цього розширення.
  • Завантажте і розмістіть файли в каталозі з назвою CodeMirror у вашій extensions/ папці.
  • Додайте такий код унизу вашого $LocalSettings:
    wfLoadExtension( 'CodeMirror' );
    
  • Налаштуйте як вимагається.
  •   Готово – Перейдіть до Special:Version вашої вікі, щоб переконатися, що розширення встановлено успішно.


Vagrant installation:

  • Якщо використовується 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;

To try out the new features mentioned above in your local installation, add the following lines as well. Note: these features are intended to become default features. Once made default, these settings may no longer have an effect.

# 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;

Інтеграція розширень

Якщо Ваше розширення MediaWiki додає новий тег і Ви хочете впевнитися, що CodeMirror як слід підсвічує вміст усередині нього, то Ви можете додати підтримку CodeMirror до свого розширення. Тут два приклади: [$first Розширення цитування] та [$second розширення PhpTags].

JavaScript integration

The following front-end hooks are used in this extension:

Hook Parameters
Type Description
ext.CodeMirror.switch boolean Whether the CodeMirror editor is now shown
jQuery object The current "editor", which is either the normal ‎<textarea /> or the .CodeMirror element.

Зробити

  • списки визначення підсвічування ( ;foo :bar ) (task T170042)
  • автоматичне завершення (phab:T95100)
  • згортання коду (task T166098)
  • підсвічування всередині тегу галереї (<gallery> foo | bar </gallery>)

Див. також