Extension:CodeMirror
![]() État de la version : stable |
|
---|---|
![]() |
|
Implémentation | Interface utilisateur |
Description | Fournit la mise en évidence de la syntaxe dans l’éditeur de wikicode. |
Auteur(s) | Pavel Astakhov (pastakhovdiscussion) |
Dernière version | 4.0.0 |
Politique de compatibilité | Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière. |
MediaWiki | 1.32+ |
PHP | 5.3+ |
Modifie la base de données |
Non |
Licence | Licence publique générale GNU v2.0 ou supérieur |
Téléchargement | |
|
|
Téléchargements trimestriels | 353 (Ranked 31st) |
Utilisé par les wikis publics | 6,549 (Ranked 62nd) |
Traduire l’extension CodeMirror sur translatewiki.net si elle y est disponible | |
Rôle Vagrant | codemirror |
Problèmes | Tâches ouvertes · Signaler un bogue |
L’extension CodeMirror fournit la mise en évidence de la syntaxe dans l’éditeur de wikicode de MediaWiki.
Elle ajoute un bouton avec l’icône dans la barre d’outils de modification, ce qui permet d’activer ou de désactiver cette mise en évidence.
Elle prend en charge la barre d’outils de l’éditeur de wikicode 2010 ainsi que la barre d’outils de l’éditeur visuel.
Par défaut la fonctionnalité est désactivée. Lorsqu’elle est activée, elle remplacera la zone de texte standard gérée par le navigateur par l’éditeur fourni par la bibliothèque CodeMirror. Lorsqu’elle est désactivée, on réutilisera la zone de texte standard du navigateur.
Les couleurs utilisées dans cette extension ont été optimisées pour offrir un contraste plus élevé, une accessibilité et une lisibilité améliorée, pour se conformer maintenant aux Recommandations pour l’accessibilité du contenu sur le web (WCAG 1.4.3 AA). Les couleurs offrent une meilleure accessibilité aux personnes ayant une vision limitée et aux utilisateurs travaillant dans des conditions de forte luminosité du jour. (autres informations)
Fonctionnalités
Appariement des parenthèses, crochets et accolades
Cette fonctionnalité met en évidence la paire englobante la plus interne de parenthèses, crochets ou accolades, lorsque le curseur est placé à l’intérieur d’une paire de signes. Quand le curseur est placé juste avant un signe ouvrant ou juste après un signe fermant, la fonctionnalité met également en évidence le signe associé correspondant. L’appariement des parenthèses, crochets ou accolades est actif dans les deux éditeurs quand la mise en évidence de la syntaxe est activée dans tout espace de nom utilisant ces éditeurs.
-
Appariement des parenthèses, crochets ou accolades
Numérotation des lignes
Dans le mode de modification du wikicode, les numéros de ligne sont automatiquement affichés dans les deux éditeurs.
-
Numérotation des lignes dans l’éditeur de wikicode 2010.
-
Numérotation des lignes dans l’éditeur de wikicode 2017.
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.
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.
Tous les navigateurs pris en charge par MediaWiki sont également pris en charge dans CodeMirror.
Installation
- Installez l’extension WikiEditor ou l’extension VisualEditor , en suivant les instructions données sur leurs pages dédiées : au moins l'une des deux est nécessaire pour que cette extension fonctionne.
- Téléchargez et placez le(s) fichier(s) dans un répertoire appelé
CodeMirror
dans votre dossierextensions/
. - Ajoutez le code suivant à la fin de votre fichier
LocalSettings.php
:wfLoadExtension( 'CodeMirror' );
- Configurer si nécessaire.
- Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.
Installation Vagrant :
- Si vous utilisez Vagrant , installez avec
vagrant roles enable codemirror --provision
Configuration
Pour la personnalisation des couleurs et des styles, consultez la page d’aide sur Méta-Wiki. Vous pouvez utiliser vos propre styles pour la mise en évidence du wikicode. Les styles utilisés sont disponibles ici. Vous pouvez placer vos propres styles dans common.css .
Ajouter le code ci-dessus en bas de votre LocalSettings.php .
# Active l’utilisation de CodeMirror par défaut mais il est encore possible aux utilisateurs de le désactiver dans leurs préférences
$wgDefaultUserOptions['usecodemirror'] = 1;
To enable additional features:
# Activer la numérotation des lignes dans CodeMirror
# null l’active pour tous les espaces de noms
# [] pour le désactiver partout
$wgCodeMirrorLineNumberingNamespaces = [ NS_TEMPLATE ];
Intégration aux autres extensions
Si votre extension MediaWiki ajoute une nouvelle balise et si vous voulez vous assurer que CodeMirror met correctement en évidence le contenu qu’elle contient, vous pouvez ajouter la prise en charge de CodeMirror à votre extension. En voici deux exemples : extension Cite et extension PhpTags.
Intégration de JavaScript
Les crochets frontaux sont utilisés dans cette extension :
Accroche | Paramètres | |
---|---|---|
Type | Description | |
ext.CodeMirror.switch
|
booléen | Indique que l’éditeur CodeMirror est maintenant affiché |
objet jQuery | L’« éditeur » actuel, qui est soit l’<textarea /> normal ou l’élément .CodeMirror .
|
If you need to interact with the contents of a CodeMirror instance, use jQuery.plugin.textSelection.
À faire
- Unfortunately, right-to-left content is not supported. (tâche T170001)
- mise en évidence des listes de définitions ( ;foo :bar ) (tâche T170042)
- complétion automatique (tâche T95100)
- repli du code (tâche T166098)
- mise en évidence à l’intérieur de la balise de galerie (<gallery> foo | bar </gallery>)
Voir aussi
- Vue générale des fonctionnalités manquantes et des anomalies : MediaWiki-extensions-CodeMirror
- User:Remember the dot/Syntax highlighter
- Extension:VisualEditor
- Extension:WikiEditor
- Extension:CodeEditor
- Communauté technique/Mise en évidence de la syntaxe dans l’éditeur de wikicode - inclut des informations sur la façon de personnaliser les couleurs
- c:Category:MediaWiki extension CodeMirror
Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki. |
Cette extension est incluse dans les paquets et / ou les fermes de wikis suivants : Cette liste ne fait pas autorité. Certaine fermes de wikis ou d'hébergeurs peuvent contenir ce extension même s'ils ne figurent pas ici. Vérifiez toujours cela dans votre environement avant de confirmer. |