Aide:CodeMirror

L'extension CodeMirror est utilisée pour permettre la coloration syntaxique du wikicode lors de la modification d'une page.
CodeMirror est disponible depuis août 2017 en tant qu'outil bêta à activer dans les préférences, puis rendu disponible pour tous les utilisateurs en mai 2018.
Activation
- La barre d'outils améliorée doit être activée dans vos préférences (notez que la barre d'outils améliorée peut être activée en même temps que l'ancienne). Consulter Aide:Barre d'outils d'édition pour plus d'informations.
- Cliquez sur le bouton
dans la barre d'outils pour activer ou désactiver la coloration syntaxique.
Fonctionnalités
Signalement des caractères indésirables
CodeMirror signale la présence de caractères indésirables comme les caractères de contrôle de la manière suivante : •.
Si ces caractères de contrôle ont parfois été insérés (surtout par le passé) volontairement (c'est parfois le cas des traits d'union conditionnels), leur mode d'insertion le plus fréquent reste une insertion accidentelle, notamment lors du copier-coller d'un nom d'article depuis une liste de contributions (où des marques gauche-à-droite sont présentes entre les différents éléments). Si la sélection est un peu trop large, on peut prendre involontairement un de ces caractères de contrôle lors du copier-coller, sans s'en apercevoir (c'est pourquoi ils se rencontrent généralement a proximité des liens internes et des catégories).
Il est possible de connaitre le type de caractère concerné en le survolant, exemple : •. Le caractère indésirable le plus fréquent est la marque gauche-à-droite (left-to-right mark, LRM). Son code Unicode est U+200E (indiqué \u200e dans CodeMirror).
Ces caractères sont inutiles — voire parfois nuisibles, en provoquant des bugs bizarres et difficiles à identifier dans les appels de modèles — et peuvent être supprimés sans hésitation quand il s'agit de marques gauche-à-droite (U+200E) ou marques droite-à-gauche (U+200F), à partir du moment où ils ne se trouvent pas dans ou à proximité d'un texte s'écrivant de droite à gauche (comme l'arabe ou l'hébreu).
Quant aux traits d'union conditionnels (U+00AD), ils peuvent généralement être supprimés sans problème, ou sinon il faudrait au moins les remplacer par l'entité HTML correspondante : ­, qui a strictement le même comportement à l'affichage, tout en indiquant de manière visible la présence d'un trait d'union conditionnel lors de l'édition du code.
Il est possible de modifier l'apparence de ces caractères dans CodeMirror en définissant une règle CSS personnalisée pour la classe .cm-invalidchar. Voir la section #Personnalisation pour cela.
Problèmes connus
Quelques problèmes connus :
- La présence de liens dans les légendes d'images casse la coloration jusqu'à la fin de la ligne. (phab:T108447)
- Les listes de définition ne sont pas colorées correctement. (phab:T170042)
- Les parties en gras et/ou italique ne sont pas mises en gras/italique à l'intérieur des modèles. (phab:T216210)
Voir sur Phabricator le projet CodeMirror pour la liste complète des bugs et fonctionnalités demandées.
Personnalisation
Les couleurs utilisées peuvent être personnalisées en ajoutant des règles CSS dans votre page CSS personnelle (Spécial:Ma_page/common.css).
L'aperçu des principales classes CSS utilisées par CodeMirror est disponible sur meta:Community_Tech/Wikitext_editor_syntax_highlighting#Color_and_style_customization. Une liste complémentaire est également disponible sur Phabricator.
Exemple
Pour changer la couleur des puces d'une liste à puces (*) pour qu'elles soient en rouge sur fond vert, ajoutez le code suivant à votre common.css :
.cm-mw-list
{
background-color: green;
color: red;
}
Une liste des codes couleurs est disponible sur Aide:Couleurs.
Thèmes personnalisés existants
- Utilisateur:Tractopelle-jaune/CodeMirror-dark : Thème sombre (arrière-plan noir), comprenant diverses améliorations pour faciliter le repérage visuel entre les différents éléments (intérieur des références, parties en gras et/ou italique, modèles imbriqués, différents éléments des tableaux, etc.). (aperçu 1, aperçu 2).
Voir aussi
Autres outils
D'autres outils de coloration syntaxique existent sous forme de gadgets, plus ou moins maintenus, activables dans les préférences :
- DotsSyntaxHighlighter (plus d'informations) ;
- WikEd - éditeur de wikicode comprenant une coloration syntaxique (plus d'informations).
Liens
Content Disclaimer
Informasi ini disarikan dari Wikipedia dan disajikan kembali untuk tujuan edukasi. Konten tersedia di bawah lisensi CC BY-SA 3.0. Kami tidak bertanggung jawab atas ketidakakuratan data yang bersumber dari kontribusi publik tersebut.
- The information displayed on this website is sourced in part or in whole from Wikipedia and has been adapted for the purpose of restating it. We strive to provide accurate and relevant information, however:
- There is no guarantee of absolute accuracy. Wikipedia is an open, collaborative project that can be edited by anyone, so information is subject to change.
- It is not intended to constitute professional advice. The content displayed is for informational and educational purposes only. For important decisions (e.g., medical, legal, or financial), please consult a professional.
- Content copyright. Wikipedia is licensed under the Creative Commons Attribution-ShareAlike License (CC BY-SA). This means that content may be reused with appropriate attribution and shared under a similar license.
- Responsible use. Any risk arising from the use of information from this website is entirely the responsibility of the user.