Extension:CharInsert/fr

L'extension CharInsert permet de créer des liens JavaScript qui, une fois cliqués, insèrent un texte prédéfini dans la zone de texte.

Ces liens sont généralement utilisés dans le message système MediaWiki:Edittools (exemple sur ce wiki).

Syntaxe
Utilisez les balises avec une liste  de caractères séparés par des espaces, ou les balises que vous souhaitez insérer.

Vous pouvez utiliser le signe '+' dans une balise pour définir un emplacement pour :


 * insérer le texte sélectionné ou
 * placer le curseur si aucun texte n'est sélectionné.

Vous devez encadrer les modèles et les espaces avec :



Utilisation et exemple de sortie


Caractères individuels
Les caractères individuels sont simplement listés entre les balises.

donne la ligne :



Caractères appairés
Les caractères combinés sont listés entre les balises ; ils sont appairé avec le signe "+".

donne la ligne :



Remplacer le texte à afficher
Vous pouvez choisir un texte différent à afficher dans l'attribut  (si vous le faites, utilisez des balises séparées pour chaque caractère de sorte à pouvoir spécifier les textes respectifs).

donne la ligne :

Installation


Configuration avancée
Important : Vous devez avoir pour que cela fonctionne.

Mise en forme


Pour donner aux listes de charinsert un style supplémentaire, encadrez le contenu de vos outils d'édition avec  et  et ajoutez le style correspondant dans votre. Ce site (www.mediawiki.org) fait cela pour faire apparaître les liens comme des boutons (comme le montre la capture d'écran sur le côté). La feuille de style ci-dessous a été utilisée pour cela, copiez-la dans votre pour appliquer le même style.

Vous pouvez également choisir un style plus proche du Guide de style de présentation Wikimedia ou du Thème de l'interface utilisateur Wikimedia :

Programmation
Si vous avez beaucoup de liens CharInsert, vous pouvez utiliser JavaScript pour les mettre dans des groupes séparés et permettre une commutation dynamique avec un menu déroulant. Par exemple pour séparer les caractères diacritiques de la syntaxe wiki, etc. Plusieurs sites (tels que mediawiki.org, de.wikipedia.org et en.wikipedia.org) l'ont fait. Ils l'ont tous implémenté de différentes manières. La documentation ci-dessous concerne la manière adoptée par mediawiki.org :


 * 1. Encadrer toutes les balises charinsert sur MediaWiki:Edittools dans un conteneur et donnez-lui un identifiant descriptif et unique (par exemple "mw-edittools-charinsert"):
 * 2. Encadrez chaque bloc individuel charinsert de balises comme ceci :
 * Ne modifiez pas le mot 'mw-edittools-section'
 * Le texte derrière "data-section-title=" va identifier ce groupe dans le menu déroulant.
 * Vérifiez qu'il existe un groupe sans la directive ' ' : ce sera le choix par défaut dans le menu déroulant. Sur ce site, il s'appelle 'Standard' et les autres groupes sont nommés en fonction de la langue pour laquelle les caractères sont significatifs.
 * 3. Copiez le contenu de MediaWiki:Gadget-Edittools.js sur une page portant le même nom, sur votre propre wiki
 * 4. Ajoutez le code suivant à votre :
 * Edittools[ResourceLoader|default]|Edittools.js
 * 3. Copiez le contenu de MediaWiki:Gadget-Edittools.js sur une page portant le même nom, sur votre propre wiki
 * 4. Ajoutez le code suivant à votre :
 * Edittools[ResourceLoader|default]|Edittools.js



Menu charInsert sur la Wikipedia anglophone
Pour implémenter un menu CharInsert tel que celui utilisé sur la Wikipedia anglophone, vous pouvez soit exporter les gadgets : Charinsert-core, Charinsert-styles, et Charinsert puis les importer dans votre propre wiki avec Special:Import, ou bien si vous souhaitez le faire manuellement, copiez les quatre pages d'interface suivantes dans votre wiki :


 * MediaWiki:Gadget-charinsert-core.js (Wikipedia) - Fichier JavaScript principal.
 * MediaWiki:Gadget-charinsert-styles.css (Wikipedia) - Encadre les symboles et les caractères pour leur donner l'apparence de boutons.
 * MediaWiki:Gadget-charinsert.js (Wikipedia) - Chargeur CharInsert.
 * MediaWiki:Gadget-charinsert (Wikipedia) - Pour le texte affiché dans la section gadgets des préférences utilisateur.


 * Dans votre MediaWiki:Gadgets-definition, ajoutez les définitions suivantes :

charinsert-core[ResourceLoader|hidden|dependencies=jquery.textSelection,user,mediawiki.storage]|charinsert-core.js charinsert-styles[ResourceLoader|hidden|type=styles]|charinsert-styles.css Ce caractère spécial de la Wikipedia anglophone définit également des modèles qui doivent exister par ailleurs, si vous les utilisez dans votre Wiki.
 * charinsert[ResourceLoader|default|peers=charinsert-styles]|charinsert.js
 * }
 * MediaWiki:Edittools (Wikipedia) - Uniquement pour les utilisateurs où le JavaScript est désactivé ou non pris en charge (se qui désactive aussi l'extension WikiEditor), donc pas réellement nécessaire ou utile en conséquence. N'affiche que les symboles ou caractères en tant que texte simple sous la fenêtre de l'éditeur, pouvant ainsi être recopiés et faciliter l'édition. Apparemment, il n'est pas activé sur la Wikipedia anglophone quand JavaScript n'est pas pris en charge.

Solution de la Wikipedia anglophone vérifiée le : 6 novembre 2018