Extension:CodeEditor

Nesmí se zaměňovat s CodeMirror .

Příručka k rozšířením MediaWiki

CodeEditor Stav rozšíření: stabilní
Popis	Poskytuje editor kódu se zvýrazněním syntaxe pro stránky JS, CSS a Lua webu a uživatele, integruje se s panelem nástrojů pro pokročilé úpravy
Autoři	Brooke Vibber Derk-Jan Hartman authors of Ace (ace.c9.io)
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
Změny v databázi	Ne
Parametry $wgCodeEditorEnableCore
Použité háčky (hooks) EditPage::showEditForm:initial EditPage::showReadOnlyForm:initial GetPreferences
Poskytované háčky (hooks) CodeEditorGetPageLanguage
Licence GNU General Public License 2.0 nebo novější Trojpodmínková „upravená“ licence BSD
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Přeložte rozšíření CodeEditor, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

 Poznámka:

Rozšíření CodeEditor rozšiřuje panel nástrojů pro pokročilé úpravy WikiEditoru o vložený widget editoru Ace, který poskytuje některé užitečné funkce pro uživatelské/webové stránky JavaScript, stránky CSS, stránky JSON a pokud je nainstalováno i rozšíření Scribunto , i pro stránky Lua, tj. stránky ve jmenném prostoru Module''. Editor kódu se nezobrazuje na běžných wiki stránkách, tj. na wiki stránkách s obsahovým modelem "wikitext". (Viz Extension:CodeMirror pro zvýrazňování syntaxe wikitextu při použití editoru zdrojového kódu.)

Nabízí následující funkce:

• Zvýrazňování syntaxe pro JavaScript, CSS a Lua
• Automatické odsazení
• Klávesa Tab vytváří odsazení tabulací (od verze 1.22), dříve měkké odsazení.
• Výběr odsazení/odsazení pomocí kláves Tab ↹/⇧ Shift+Tab ↹
• Kontrola platnosti syntaxe pro JavaScript
• Párové porovnávání závorek, složených závorek a hranatých závorek

Instalace

Toto rozšíření je součástí MediaWiki 1.31 a vyšší. Zbývající konfigurační pokyny je stále nutné dodržovat.

Pro fungování tohoto rozšíření je nutné nainstalovat rozšíření WikiEditor. Instalace rozšíření Scribunto je volitelná.

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného CodeEditor ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:

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

• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

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

• Vyžaduje nastavení v konfiguračním souboru.
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Instalace Vagrant:

• Pokud používáte Vagrant , instalujte s těmito parametry vagrant roles enable codeeditor --provision

Konfigurace

$wgCodeEditorEnableCore

Chcete-li zakázat editor na stránkách JavaScriptu a CSS v MediaWiki, User a dalších základních jmenných prostorech, nastavte $wgCodeEditorEnableCore = false; (výchozí hodnota je "true").

$wgCodeEditorContentModels

Dočasný tag funkce pro řízení konfliktů s Extension:CodeMirror .

$wgScribuntoUseCodeEditor

Chcete-li toto rozšíření pro Scribunto zakázat, tj. v jmenném prostoru modulu nastavte $wgScribuntoUseCodeEditor = false; (výchozí hodnota je "true")

Tento konfigurační parametr je poskytován rozšířením Scribunto a proto musí být přidán po spuštění CodeEditoru a také rozšíření Scribunto, které je také nutné nainstalovat, aby to fungovalo.

JavaScript

Konfiguraci editoru ACE je možné změnit navázáním na háček MediaWiki JS (tj. mw.hook( 'codeEditor.configure' ).add( ... )). Argument předaný vašemu háčku bude objekt ACE EditSession.

Pokud potřebujete interagovat s obsahem instance CodeEditoru, použijte module-jquery.textSelection.$.fn.textSelection().

Licence

Ačkoli je toto rozšíření licencováno pod GNU General Public License v2.0 nebo novější (GPL-2.0+), využívá editorový software Ace, který je licencován pod BSD 3-clause "New" nebo "Revised" License (BSD-3-Clause).

Související odkazy

• Kategorie:Rozšíření CodeEditorGetPageLanguage – rozšíření, která využívají CodeEditor prostřednictvím háčku CodeEditorGetPageLanguage .
• en:User:Nardog/CodeEditorAssist – uživatelský skript pro ukládání uživatelských preferencí při načítání stránek