Extension:CodeMirror/5

This page documents CodeMirror 5, the older version of CodeMirror. It is due to be removed by MediaWiki version 1.44 (release timeline ). For the documentation about the current version, see Extension:CodeMirror .

Nesmí se zaměňovat s CodeEditor .

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

CodeMirror/5 Stav rozšíření: stabilní
Implementace	Uživatelské rozhraní
Popis	Poskytuje zvýraznění syntaxe v editoru wikitext
Autoři	Pavel Astakhov (pastakhovdiskuse)
Nejnovější verze	5.0.0
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 $wgCodeMirrorV6 $wgCodeMirrorPrimaryPreferences $wgCodeMirrorConflictingGadgets $wgCodeMirrorEnabledModes $wgCodeMirrorDefaultPreferences $wgCodeMirrorLineNumberingNamespaces
Použité háčky (hooks) EditPage::showEditForm:initial EditPage::showReadOnlyForm:initial GetBetaFeaturePreferences GetPreferences PreferencesFormPreSave SpecialPageBeforeExecute UploadForm:initial
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Přeložte rozšíření CodeMirror/5, používá-li lokalizaci z translatewiki.net
Vagrant role	codemirror
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření CodeMirror poskytuje zvýraznění syntaxe v wikitextovém editoru MediaWiki. Přidává tlačítko s ikonou na panel nástrojů pro úpravy, které umožňuje zapínat a vypínat zvýrazňování syntaxe. Podporuje Panel nástrojů WikiEditoru 2010 a také Panel nástrojů VisualEditoru.

Ve výchozím nastavení je vypnuto. Po zapnutí nahradí standardní textovou oblast editorem z knihovny CodeMirror. Po vypnutí se přepne zpět do standardního textového pole.

Barvy použité v tomto rozšíření byly optimalizovány pro vyšší kontrast, přístupnost a lepší čitelnost a nyní odpovídají Pokynům pro přístupnost webového obsahu (WCAG 1.4.3 AA). Barvy poskytují lepší přístup pro osoby s omezeným zrakem a také pro uživatele pracující za jasného denního světla. (další informace)

Funkce

Párování závorek

Tato funkce zvýrazní nejvnitřnější dvojici závorek, když se kurzor nachází mezi libovolnou dvojicí závorek, a když se kurzor nachází přímo vedle závorky, funkce zvýrazní odpovídající závorku. Porovnávání závorek je aktivní v obou editorech, pokud je v libovolném jmenném prostoru používajícím tyto editory zapnuto zvýrazňování syntaxe.

• 
  Párování závorek

Číslování řádků

V režimu úpravy wikitextu se čísla řádků automaticky zobrazují v obou editorech.

Tato funkce je na většině wikin povolena pouze pro jmenný prostor šablon a na některých wikinách pro všechny jmenné prostory (viz cestovní mapa a konfigurace).

• 
  Číslování řádků v editoru wikitextu 2010
• 
  Číslování řádků v editoru wikitextu z roku 2017

Režim pro barvoslepé

Pro uživatele, kteří mají potíže s rozlišováním barev, nabízí CodeMirror režim vhodný pro barvoslepé. Tuto funkci lze aktivovat na wikinách s povoleným CodeMirror přechodem na stránku Special:Preferences.

Je-li aktivní schéma vhodné pro barvoslepé, mění se barvy následujících prvků stránky:

Nadpisy, symboly, podpisy, názvy sekcí, magická slova	#E4A400
Šablony	#9C3A00
HTML značky, odkazy, matematické výrazy	#56B4E9
Proměnné	#009E73

Kromě toho se z veškerého textu a objektů odstraní zvýraznění a barvy pozadí. Chování tučného a podtrženého písma zůstává nedotčeno.

Podpora prohlížeče

Podporovány jsou všechny prohlížeče podporované MediaWiki.

Instalace

• Nainstalujte si buď rozšíření WikiEditor , nebo rozšíření VisualEditor podle pokynů na jejich stránkách. Pro fungování tohoto rozšíření je vyžadováno alespoň jedno z nich.
• Stáhněte soubor/y a vložte je do adresáře pojmenovaného CodeMirror 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/CodeMirror
  

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

  wfLoadExtension( 'CodeMirror' );
  

• 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 codemirror --provision

Konfigurace

Informace o přizpůsobení barev a stylu naleznete na stránce nápovědy Meta. Pro zvýraznění wikitextu můžete použít své vlastní styly. Použité styly jsou k dispozici zde. Měli byste umístit své vlastní styly na common.css .

Přidejte následující kód na konec svého LocalSettings.php .

# Ve výchozím nastavení povoluje používání CodeMirror, ale stále umožňuje uživatelům jej zakázat.
$wgDefaultUserOptions['usecodemirror'] = true;

Další konfigurace:

$wgCodeMirrorLineNumberingNamespaces

Omezuje číslování řádků na konkrétní jmenné prostory. Výchozí hodnota je null, což ji povoluje pro všechny jmenné prostory. Nastavením na [] zakážete číslování všude.

$wgCodeMirrorV6

Temporary feature flag to control the migration to CodeMirror 6 (phab:T259059).

$wgCodeMirrorConflictingGadgets

Pole názvů gadgetů, které v případě povolení zabrání načtení CodeMirror. Výchozí hodnota je wikEd.

Integrace rozšíření

This functionality is subject to change following the CodeMirror 6 upgrade. See Extension:CodeMirror/6#Integration for documentation on CodeMirror 6.

Řešeno přes Phabricator
Úkol T348684

Pokud vaše rozšíření MediaWiki přidá novou značku a chcete se ujistit, že CodeMirror správně zvýrazňuje jeho obsah, můžete do svého rozšíření přidat podporu CodeMirror. Zde jsou dva příklady: Cite extension a PhpTags extension.

Integrace JavaScriptu

V tomto rozšíření se používají následující front-endové háčky:

Háček	Parametry
	Typ	Popis
ext.CodeMirror.switch	boolean	Zda se nyní zobrazuje editor CodeMirror
	objekt jQuery	Aktuální "editor", což je buď normální element ‎<textarea />, nebo element .CodeMirror.

Pokud potřebujete interagovat s obsahem instance CodeMirror, použijte jQuery.plugin.textSelection.

Úkol

• Bohužel není podporován obsah zprava doleva. (TT170001)
• Automatické dokončení (TT95100)
• Skládání kódu (TT166098)
• Zvýraznění uvnitř značky galerie (<gallery> foo | bar </gallery>)

Související stránky

• Přehled chybějících funkcí a chyb: MediaWiki-extensions-CodeMirror
• Uživatel:Pamatujte na zvýrazňovač teček nebo syntaxe
• Extension:VisualEditor
• Extension:WikiEditor
• Extension:CodeEditor
• Zvýrazňování syntaxe editoru Community Tech/Wikitext - obsahuje informace o přizpůsobení barev
• c:Category:MediaWiki extension CodeMirror