Extension:CharInsert

Manuel des extensions MediaWiki

CharInsert État de la version : stable
Implémentation	Balise , Action de page , MyWiki
Description	Permet de créer des zones JavaScript d'insertion de caractères.
Auteur(s)	Brion Vibber (Brooke Vibberdiscussion)
Dernière version	continuous updates
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
MediaWiki	>= 1.43
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (Phabricator · GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code
Balises ‎<charinsert>
Accroches utilisées BeforePageDisplay ParserFirstCallInit
Téléchargements trimestriels	70 (Ranked 73rd)
Utilisé par les wikis publics	9,224 (Ranked 15th)
Traduire l’extension CharInsert sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

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 ‎<charinsert> 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 ‎<nowiki> :

<charinsert><nowiki>== + ==</nowiki> <nowiki>{{stub}}</nowiki></charinsert>

Utilisation et exemple de sortie

Caractères individuels

Les caractères individuels sont simplement listés entre les balises <charinsert>.

<charinsert>Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź</charinsert>

donne la ligne :

Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź

Cliquer sur les liens n'a pas d'effet ici puisqu'il n'y a pas de champ d'entrée ou de modification associé.

Caractères appairés

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

<charinsert>“+” ‘+’ «+» ‹+› „+“ ‚+‘ [[+]] {{+}}</charinsert>

donne la ligne :

“” ‘’ «» ‹› „“ ‚‘ [[]] {{}}

Cliquer sur les liens n'a pas d'effet ici puisqu'il n'y a pas de champ d'entrée ou de modification associé.

Remplacer le texte à afficher

Version de MediaWiki :

≥ 1.38 Gerrit change 748823

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

<charinsert label="Latin A">A</charinsert> <charinsert label="Cyrillic А">А</charinsert> <charinsert label="Greek Alpha">Α</charinsert>

donne la ligne :

Latin A Cyrillic А Greek Alpha

Cliquer sur les liens n'a pas d'effet ici puisqu'il n'y a pas de champ d'entrée ou de modification associé.

Notes

• Les liens JavaScript générés fonctionnent également dans d'autres zones autour de la fenêtre d'édition, par exemple dans MediaWiki:Copyrightwarning ou MediaWiki:Newarticletext, sur la page préchargée avec Inputbox , et même avec l'aperçu du texte.
• Ils peuvent également être utilisés dans MediaWiki:Uploadtext pour insérer des modèles de description d'images.
• Contrairement aux boutons de la barre supérieure d'outils, cette extension ne permet pas de spécifier le "texte d'exemple" à insérer.
• Utilisez 
 pour ajouter de nouvelles lignes (\n).
• Encadrer les espaces avec des balises ‎<nowiki>...‎</nowiki> si nécessaire.
• Ajouter des balises ‎<charinsert>...‎</charinsert> dans MediaWiki:Edittools.

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé CharInsert 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/CharInsert
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'CharInsert' );
  

• Si vous utilisez le gadget Edittools , mettez à jour son code avec la dernière version (≥ 3 avril 2020)
•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration avancée

Important : Vous devez avoir Extension:Gadgets 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 <div class="mw-charinsert-buttons"> et ‎</div> et ajoutez le style correspondant dans votre MediaWiki:Common.css. 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 MediaWiki:Common.css pour appliquer le même style.

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]]
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	border: 1px solid #aaa;
	margin-top: 10px;
	padding: 1px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #cde !important;
	color: #000;
	border: thin #069 outset;
	padding: 0 1px 1px;
	font-weight: bold;
	font-size: 0.9em;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover,
.mw-charinsert-buttons a:active {
	background-color: #bcd;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	font-size: 0.9em;
	margin-left: 1px;
	padding-left: 1px;
	padding-right: 1px;
}

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 :

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]] in WikimediaUI inspired theme.
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	margin-top: 8px;
	border: 1px solid #c8ccd1;
	padding: 2px 4px 4px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #f8f9fa !important;
	color: #202122;
	border: thin #36c outset;
	padding: 0 1px 2px;
	font-size: 0.9em;
	font-weight: bold;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover {
	background-color: #fff;
    color: #404244;
}

.mw-charinsert-buttons a:active {
	background-color: #c8ccd1;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	background-color: #f8f9fa;
	color: #202122;
	margin-left: 1px;
    border-radius: 2px;
	padding: 1px 6px;
	font-size: 0.9em;
    /* Apply pointer cursor to all interactive elements. */
    cursor: pointer;
}

.client-js .mw-edittools-section input[type="button"]:hover {
	background-color: #fff;
    color: #404244;
}

.client-js .mw-edittools-section input[type="button"]:active {
	background-color: #c8ccd1;
    color: #000;
}

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 ‎<div> et donnez-lui un identifiant descriptif et unique (par exemple "mw-edittools-charinsert"):

<div id="mw-edittools-charinsert" class="mw-charinsert-buttons" title="Click on the wanted special character.">
...
</div>

2. Encadrez chaque bloc individuel charinsert de balises ‎<p> comme ceci :

<p class="mw-edittools-section" data-section-title="Wiki-Syntax" style="display: none;">
...
</p>

 Note :

• 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 'style="display: none;"' : 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 MediaWiki:Gadgets-definition:

* 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[ResourceLoader|default|peers=charinsert-styles]|charinsert.js
  * charinsert-core[ResourceLoader|hidden|dependencies=jquery.textSelection,user,mediawiki.storage]|charinsert-core.js
  * charinsert-styles[ResourceLoader|hidden|type=styles]|charinsert-styles.css
  

• 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.

 Note : 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.

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