Issue tracker: #MediaWiki-extensions-CodeMirror

Extension:CodeMirror/fr

From Linux Web Expert

Ne pas confondre avec CodeEditor .
Manuel des extensions MediaWiki
File:OOjs UI icon advanced-invert.svg
CodeMirror
État de la version : stable
File:Pride and codemirror.png
Implémentation Interface utilisateur
Description Fournit la mise en évidence de la syntaxe dans l’éditeur de wikicode.
Auteur(s) Pavel Astakhov (pastakhovtalk)
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 Aucune licence spécifiée
Téléchargement
<translate> Download extension</translate>
<translate> Git</translate> [?]:
Téléchargements trimestriels Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Utilisé par les wikis publics Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
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 File:Codemirror-icon.png 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.

  • Bracket matching new styling EN.gif

    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.

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).
  • Technical Wishes – Line numbering - 2010 wikitext editor.png

    Numérotation des lignes dans l’éditeur de wikicode 2010.

  • Zeilennummerierung im 2017 Wikitext Editor.png

    Numérotation des lignes dans l’éditeur de wikicode 2017.

Mode pour les mal voyants

Pour les utilisateurs qui ont du mal à distinguer les couleurs, CodeMirror offre un mode particulier. Cette fonctionnalité est disponible sur les wikis avec où CodeMirror est activé en allant sur la page Special:Preferences.

File:New preference colorblind syntax highlighting.png

Avec le ce mode d'affichage actif, les couleurs des éléments suivants de la page changent :

les titres, symboles, signatures, noms de sections, mots magiques #E4A400
Modèles #9C3A00
Balises 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.
  • <translate> [[<tvar name=2>Special:ExtensionDistributor/CodeMirror/fr</tvar>|Download]] and move the extracted <tvar name=name>CodeMirror/fr</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
    <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CodeMirror%2Ffr
  • <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate> 
    wfLoadExtension( 'CodeMirror/fr' );
  • Configurer si nécessaire.
  • File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>


<translate> Vagrant installation:</translate>

  • <translate> If using <tvar name=vagrant>Vagrant </tvar>, install with <tvar name=code>vagrant roles enable codemirror --provision</tvar></translate>

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
une série de noms de gadgets qui, s'ils sont activés, empêcheront CodeMirror de se charger. Valeur par défaut : wikEd.

Intégration aux autres extensions

This functionality is subject to change following the CodeMirror 6 upgrade.
<translate> Tracked in [[<tvar name=1>phabricator:</tvar>|Phabricator]]</translate>
<translate> Task <tvar name=1>T348684</tvar></translate>

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.

Si vous avez besoin d'interagir avec le contenu d'une instance CodeMirror, utilisez jQuery.plugin.textSelection.

À faire


Voir aussi

Retrieved from "https://www.linuxwebexpert.com/wiki/index.php?title=Extension:CodeMirror/fr&oldid=17938"