Расширение:CodeEditor

Not to be confused with CodeMirror .

Справка по расширениям MediaWiki

CodeEditor Статус релиза: стабильно
Описание	Предоставляет редактор кода с подсветкой синтаксиса для сайта и пользовательских страниц JS, CSS и Lua, интегрированный с расширенной панелью инструментов редактирования
Автор(ы)	Brooke Vibber Derk-Jan Hartman authors of Ace (ace.c9.io)
Политика совместимости	Снэпшоты выходят вместе с MediaWiki. Мастер не имеет обратной совместимости.
Изменения в БД	Нет
Параметры $wgCodeEditorEnableCore
Используемые хуки EditPage::showEditForm:initial EditPage::showReadOnlyForm:initial GetPreferences
Предоставляемые хуки CodeEditorGetPageLanguage
Лицензия GNU General Public License 2.0 or later BSD 3-clause "Modified" License
Скачать	Скачать расширение Git [?]: репозиторий (Phabricator · GitHub) Обзор кода Gerrit журнал Git-коммитов Download source tarball
Переведите расширение CodeEditor, если оно доступно на translatewiki.net
Проблемы	Открытые задачи · Сообщить об ошибке

In MediaWiki 1.46, Расширение:CodeMirror became the default syntax aware editor of MediaWiki for all content types, replacing CodeEditor.

Расширение CodeEditor расширяет панель инструментов расширенного редактирования WikiEditor встроенным виджетом редактора Ace, предоставляя некоторые удобные функции для страниц JavaScript пользователя/сайта, страниц CSS, страниц JSON, а также, если установлено расширение Scribunto, для страниц Lua, т.е. страниц в пространстве имен Модуль. Редактор кода не отображается на обычных вики-страницах, т.е. вики-страницах с моделью содержимого "вики-текст". (См. Расширение:CodeMirror для подсветки синтаксиса вики-текста при использовании редактора исходного текста.)

Оно предоставляет следующие возможности:

• подсветка синтаксиса для JavaScript, CSS и Lua
• автоматический отступ
• клавиша табуляции создает отступы табуляции (с версии 1.22), до этого были мягкие отступы.

• выделение отступа/неотступа с помощью клавиш Tab/Shift-Tab

• проверка достоверности синтаксиса для JavaScript
• Попарное сопоставление для круглых и квадратных скобок

Установка

Это расширение поставляется с MediaWiki 1.31 и выше, так что вам не нужно загружать его. Остальные инструкции по настройке всё равно необходимо соблюдать.

Для работы этого расширения необходимо установить расширение WikiEditor. Установка расширения Scribunto необязательна.

• Скачайте и распакуйте файл(ы) в папку с названием CodeEditor в вашей папке extensions/.
  Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CodeEditor
  

• Добавьте следующий код в конце вашего файла LocalSettings.php :

  wfLoadExtension( 'CodeEditor' );
  $wgDefaultUserOptions['usebetatoolbar'] = 1; // user option provided by WikiEditor extension
  

• Настройте по необходимости.
• Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Установка Vagrant:

• Если вы используете Vagrant , установите с помощью vagrant roles enable codeeditor --provision

Настройка

$wgCodeEditorEnabledModes

Temporary feature flag to control conflicts with Расширение:CodeMirror .

$wgScribuntoUseCodeEditor

Чтобы отключить это расширение для Scribunto, то есть в пространстве имен модулей, установите $wgScribuntoUseCodeEditor = false; (по умолчанию "true").

Этот параметр конфигурации предоставляется расширением Scribunto и поэтому должен быть добавлен после вызова CodeEditor, а также расширения Scribunto, которое также должно быть установлено для работы.

JavaScript

Можно изменить конфигурацию редактора ACE, подключившись к MediaWiki JS hook (например mw.hook( 'codeEditor.configure' ).add( ... )). Аргументом, передаваемым вашему хуку, будет ACE EditSession объект.

Если вам нужно взаимодействовать с содержимым экземпляра CodeEditor, используйте module-jquery.textSelection.$.fn.textSelection().

Лицензия

Хотя это расширение лицензировано GNU General Public License v2.0 или более поздней версии (GPL-2.0+), оно использует программное обеспечение редактора Ace, которое лицензировано BSD 3-clause "New" или "Revised" License (BSD-3-Clause).

См. также

• Category:CodeEditorGetPageLanguage extensions – extensions that make use of CodeEditor through the CodeEditorGetPageLanguage hook.
• en:User:Nardog/CodeEditorAssist – a user script to save user preferences across page loads