Rozszerzenie:CodeEditor

Not to be confused with CodeMirror .

Podręcznik rozszerzeń MediaWiki

CodeEditor Status wydania: stabilne
Opis	Dostarcza podświetlający składnię zintegrowany z zaawansowanym edytorem wikitekstu edytor kodu dla stron JS, CSS oraz modułów Lua.
Autor(zy)	Brooke Vibber Derk-Jan Hartman authors of Ace (ace.c9.io)
Polityka zgodności	Snapshots releases along with MediaWiki. Master nie jest kompatybilny wstecznie.
Zmiany w bazie danych	Nie
Licencja	GPL-2.0-or-later AND BSD-3-Clause
Pobieranie	Pobierz rozszerzenie Git [?]: przeglądaj repozytorium (Phabricator · GitHub) ocena kodu historia wprowadzeń Download source tarball
Parametry $wgCodeEditorEnableCore
Użyte haki EditPage::showEditForm:initial EditPage::showReadOnlyForm:initial GetPreferences
Dostarczane haki CodeEditorGetPageLanguage
Przetłumacz rozszerzenie CodeEditor jeżeli jest dostępne na translatewiki.net
Problemy	Otwarte zadania · Zgłoś błąd

Rozszerzenie CodeEditor poszerza zakres możliwości WikiEditora poprzez osadzenie widżetu edytora Ace, dostarczającego pewne funkcje przydatne na stronach JavaScript, CSS oraz JSON, a gdy zainstalowane jest także rozszerzenie Scribunto , to również na stronach z kodem Lua, czyli w przestrzeni nazw Moduł. The code editor does not show on regular wiki pages, i.e. wiki pages with the "wikitext" content model. (See Extension:CodeMirror for syntax highlighting of wikitext when using the source editor.)

It provides the following features:

• podświetlanie składni JavaScriptu, CSS oraz Lua
• automatyczne dodawanie wcięć
• klawisz tab tworzy wcięcia przy użyciu tabulacji (od 1.22), wcześniej miękkie wcięcia
• dodanie/usunięcie wcięcia z sekcji przy użyciu klawiszy Tab ↹/⇧ Shift+Tab ↹

sprawdzanie poprawności składni dla JavaScriptu

• parowanie nawiasów, nawiasów klamrowych oraz kwadratowych

Instalacja

This extension comes with MediaWiki 1.31 and later, so you do not need to download it. The remaining configuration instructions must still be followed.

Aby uruchomić to rozszerzenie, konieczna jest także instalacja rozszerzenia WikiEditor. Instalacja rozszerzenia Scribunto nie jest wymagana.

• Pobierz i umieść plik(i) w katalogu o nazwie CodeEditor w folderze extensions/.
  Developers and code contributors should install the extension from Git instead, using:

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

• Dodaj poniższy kod na dole twojego pliku LocalSettings.php :

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

• Skonfiguruj zgodnie z wymaganiami.
• Zrobione – Przejdź do Special:Version na twojej wiki, aby sprawdzić czy rozszerzenie zostało pomyślnie zainstalowane.

Instalacja Vagranta:

• Jeżeli korzystasz z Vagrant a, zainstaluj poprzez vagrant roles enable codeeditor --provision

Konfiguracja

$wgCodeEditorEnableCore

Aby wyłączyć edytor na stronach JavaScript i CSS w przestrzeniach nazw takich jak MediaWiki, użytkownik i inne, ustaw $wgCodeEditorEnableCore = false; (domyślna wartość to „true”)

$wgCodeEditorContentModels

Temporary feature flag to control conflicts with Extension:CodeMirror .

$wgScribuntoUseCodeEditor

Aby wyłączyć rozszerzenie dla Scribunto, tj. na stronach w przestrzeni Moduł, ustaw $wgScribuntoUseCodeEditor = false; (domyślna wartość to „true”)

Ta zmienna konfiguracyjna pochodzi z rozszerzenia Scribunto, co oznacza, że musi zostać dodana po przywołaniu zarówno rozszerzenia CodeEditor jak i Scribunto, które także jest wymagane do jej obsługi.

JavaScript

Możliwa jest zmiana konfiguracji edytora ACE poprzez użycie haka JS MediaWiki (mw.hook( 'codeEditor.configure' ).add( ... )). Argumentem podanym do twojego haka będzie obiekt ACE EditSession.

If you need to interact with the contents of a CodeEditor instance, use module-jquery.textSelection.$.fn.textSelection().

Licencja

Choć rozszerzenie dostępne na zasadach licencji GNU General Public License v2.0 or later (GPL-2.0+), to wykorzystuje ono oprogramowanie edytora Ace, które dostępne jest na licencji BSD 3-clause "New" or "Revised" License (BSD-3-Clause).

Zobacz też

• 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