Tillägg:CodeMirror

From mediawiki.org
This page is a translated version of the page Extension:CodeMirror and the translation is 57% complete.
Outdated translations are marked like this.
Manual för MediaWikitillägg
OOjs UI icon advanced-invert.svg
CodeMirror
Utgivningsstatus: stabil
Pride and codemirror.png
Genomförande Användargränssnitt
Beskrivning Erbjuder syntaxmarkering vid wikitextredigering
Författare Pavel Astakhov (pastakhovdiskussion)
Senaste versionen 4.0.0
Kompatibilitetsregler Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.32+
PHP 5.3+
Förändringar i databasen Nej
Licenser GNU General Public License 2.0 eller senare
Ladda ner
  • $wgCodeMirrorLineNumberingNamespaces
Översätt tillägget CodeMirror om det finns tillgängligt på translatewiki.net
Vagrant-roll codemirror
Ärenden Öppna ärenden · Rapportera en bugg

Tillägget CodeMirror erbjuder syntaxmarkering i MediaWikis wikitextredigerare. Den lägger till en knapp med ikonen Codemirror-icon.png bland redigeringsverktygen som låter en sätta på och stänga av syntaxmarkering. Det stöds av 2010 års wikitextredigerare samt VisualEditor-verktyget.

Den är som standard avstängd. När det är påslaget kommer den byta ut den vanliga textrutan med redigeraren som erbjuds av CodeMirror-biblioteket. När den är avstängd kommer den ha motsatt effekt.

Färgerna som används i det här tillägget har optimerats för att erbjuda högre kontrast, tillgänglighet och bättre läsbarhet. The colors provide better access for people with limited vision as well as for users working in bright daylight conditions. (more information)

Funktioner

Bracket matching

This feature highlights the innermost pair of brackets when the cursor lies between any bracket pair, and when the cursor lies directly next to a bracket, the feature highlights the corresponding matching bracket. Bracket matching is active in both editors when syntax highlighting is turned on in any namespace using these editors.

Line numbering

In the wikitext edit mode line numbers are automatically displayed in both editors.

This feature is enabled for the template namespace on most wiki, and on all namespaces on some wikis (see the roadmap and the configuration).

Colorblind mode

For users who have difficulty distinguishing between colors, CodeMirror offers a colorblind-friendly mode. This feature can be activated on wikis with CodeMirror enabled by navigating to the Special:Preferences page.

New preference colorblind syntax highlighting.png


With the colorblind-friendly scheme active, the colors of the following page elements change:

Headings, symbols, signatures, section names, magic words #E4A400
Templates #9C3A00
HTML tags, references, mathematical expressions #56B4E9
Variables #009E73

In addition, background highlights and colors are removed from all text and objects. Bolding and underlining behavior remains unaffected.


Webbläsarstöd

Alla webbläsare med stöd för MediaWiki stöds.

Installation

  • Installera antingen tillägget Tillägg:WikiEditor eller tillägget VisualEditor , som det står beskrivet på deras sidor; åtminstone en av dessa krävs för att det här tillägget ska fungera.
  • Ladda ner och placera filen/filerna i en katalog som heter CodeMirror i din extensions/-mapp.
  • Lägg till följande kod längst ner i dina LocalSettings.php :
    wfLoadExtension( 'CodeMirror' );
    
  • Konfigurera efter behov.
  • Yes Klart – Ta dig till Special:Version på din wiki för att bekräfta att tillägget har installerats ordentligt.


Vagrant-installering:

  • Om du använder Vagrant ska du installera med vagrant roles enable codemirror --provision

Konfigurering

För färg och stilanpassning, läs hjälpsidan på Meta. Du kan använda dina egna stilar för syntaxmarkering. Använda stilar tillgängliga här. Du borde lägga dina egna stilar i common.css .

Lägg till följande kod längst ner i din LocalSettings.php .

# Enables use of CodeMirror by default but still allow users to disable it
$wgDefaultUserOptions['usecodemirror'] = 1;

För att testa nya funktioner som nämnts ovan i din lokala installation, lägg också till följande rad. Notera dock att dessa funktioner är tänkta att bli standardfunktioner. Inställningarna kanske inte längre har någon inverkan då.

# Enable bracket matching in CodeMirror
$wgCodeMirrorEnableBracketMatching = true;

# Enable accessible colors in CodeMirror
$wgCodeMirrorAccessibilityColors = true;

# Enable line numbering in CodeMirror
# defaults to the template namespace [ NS_TEMPLATE ]
# null enables it for all namespace
# [] for disabling everywhere
$wgCodeMirrorLineNumberingNamespaces = null;

Tilläggsintegrering

Om du har ett MediaWiki-tillägg som lägger till nya taggar och du vill säkerställa att CodeMirror markerar innehållet ordentligt inuti det, kan du lägga till CodeMirror-stöd till tillägget. Här följer två exempel: [$first tillägget Cite] och [$second tillägget PhpTags].

JavaScript-integrering

Följande front-end-hakar används i det här tillägget:

Hake Parametrar
Typ Beskrivning
ext.CodeMirror.switch boolesk Om CodeMirrot-redigeraren visas eller inte
jQuery-objekt Den nuvarande "redigeraren", som antingen är det vanliga ‎<textarea /> eller .CodeMirror-elementet.

Att göra

Se även