Jump to content

Rozszerzenie:CodeEditor

From mediawiki.org
This page is a translated version of the page Extension:CodeEditor and the translation is 60% complete.
Outdated translations are marked like this.
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.
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
  • $wgCodeEditorEnableCore
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/.
    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.
  • Yes 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 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 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 Ace oprogramowanie edytora Ace, które dostępne jest na licencji BSD 3-clause "New" or "Revised" License (BSD-3-Clause).

Zobacz też