Extension:CodeMirror

From mediawiki.org
This page is a translated version of the page Extension:CodeMirror and the translation is 96% complete.
Ne pas confondre avec CodeEditor .
Manuel des extensions MediaWiki
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 5.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
  • $wgCodeMirrorConflictingGadgets
  • $wgCodeMirrorV6
  • $wgCodeMirrorTemplateFoldingNamespaces
  • $wgCodeMirrorLineNumberingNamespaces
Téléchargements trimestriels 366 (Ranked 13th)
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.

Numérotation des lignes

Dans le mode de modification du wikicode, les numéros de ligne sont automatiquement affichés dans les deux éditeurs.

Cette fonctionnalité est activée pour l’espace de noms des modèles sur la plupart des wikis et dans tous les espaces de noms de certains wikis (voir la feuille de route et la configuration).

Mode du contenu

Pour les utilisateurs qui ont du mal à distinguer les couleurs, CodeMirror offre un mode particulier. Cette fonctionnalité peut être activée sur les wikis avec CodeMirror activé en naviguant vers la page Special:Preferences.

Avec le mode actif, les couleurs des éléments de page suivants changent :

Titres, symboles, signatures, noms de sections, mots magiques #E4A400
Modèles #9C3A00
Étiquettes HTML, références, expressions mathématiques #56B4E9
Les variables #009E73

De plus, les surbrillances et les couleurs d’arrière-plan sont supprimées de tous les textes et objets. La mise en gras et le soulignement restent inchangés.


Navigateurs pris en charge

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 dossier extensions/.
    Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CodeMirror
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( 'CodeMirror' );
    
  • Configurer si nécessaire.
  • Yes 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'] = true;

configuration supplémentaire

$wgCodeMirrorLineNumberingNamespaces
Activer la numérotation des lignes dans CodeMirror null l’active pour tous les espaces de noms [] pour le désactiver partout
$wgCodeMirrorV6
Temporary feature flag to control the migration to CodeMirror 6 (phab:T259059).
$wgCodeMirrorConflictingGadgets
An array of gadget names that, if enabled, will prevent CodeMirror from loading. Valeur par défaut : wikEd.

Intégration aux autres extensions

This functionality is subject to change following the CodeMirror 6 upgrade.

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