Rozszerzenie:CodeEditor

To rozszerzenie jest dodawane do pakietu MediaWiki od wersji 1.31 i wyższych. W związku z tym nie musi być ponownie pobierane. Niemniej jednak wciąż musisz wykonać inne podane instrukcje.

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)	Brion Vibber Derk-Jan Hartman authors of Ace (ace.c9.io)
Polityka zgodności	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.32+
Zmiany w bazie danych	Nie
Licencja	GPL-2.0-or-later AND BSD-3-Clause
Pobieranie	Download extension Git [?]: Pobierz Git master przeglądaj repozytorium (Phabricator · GitHub) historia wprowadzeń repository contributors (GitHub) ocena kodu
Parametry $wgCodeEditorEnableCore
Użyte haki EditPage::showEditForm:initial EditPage::showReadOnlyForm:initial GetPreferences
Dostarczane haki CodeEditorGetPageLanguage
Quarterly downloads	186 (Ranked 48th)
Public wikis using	8,385 (Ranked 17th)
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 JS oraz CSS, a gdy zainstalowane jest także Scribunto , to również 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

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/.
• 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”)

$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 MediaWiki mw.hook( 'codeEditor.configure' ).add( ... )). Argumentem podanym do twojego haka będzie [$ace-editor sesja edytora ACE].

If you need to interact with the contents of a CodeEditor instance, use jQuery.plugin.textSelection.

Licencja

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

See also

• CodeEditorGetPageLanguage extensions - extensions that make use of CodeEditor through the CodeEditorGetPageLanguage hook.