Extension:CharInsert

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:CharInsert and the translation is 85% complete.
Manuel des extensions MediaWiki
OOjs UI icon advanced-invert.svg
CharInsert
État de la version : stable
Implémentation Balise , Action de page , MyWiki
Description Permet de créer des zones d'insertion de caractères JavaScript.
Auteur(s) Brion Vibber (Brion 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.25+
PHP 5.4+
Licence Licence publique générale GNU v2.0 ou supérieur
Téléchargement
‎<charinsert>
Traduire l’extension CharInsert sur translatewiki.net si elle y est disponible

Vérifier la matrice des utilisations et des versions.

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 du texte prédéfini dans la text box.

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

Syntaxe

Utilisez les balises ‎<charinsert> avec une liste séparée par des espaces de caractères ou de balises pour lesquelles vous souhaitez autoriser l'insertion.

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

  • insérer le texte sélectionné ou
  • placez le curseur si aucun texte n'est sélectionné.

Vous devez inclure des modèles et des espaces dans ‎<nowiki> :

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

Utilisation et sortie d'échantillon

Caractères individuels

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

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

résultats

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

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

Caractères combinés

Les caractères combinés sont listés entre les balises "charinsert" et reliés par le signe "+".

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

Résultats

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

Cliquer sur les liens n'aura aucun effet car il n'y a pas de champ de saisie ou d'édition.

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 depuis l'aperçu de texte.
  • ls peuvent également être utilisés dans MediaWiki:Uploadtext pour insérer des modèles de description d'image.
  • Contrairement aux boutons de la barre d'outils en haut, cette extension ne permet pas de spécifier le "texte exemple" inséré.
  • Utilisez &#10; pour ajouter de nouvelles lignes (/n).
  • Enfermer les espaces blancs dans les balises ‎<nowiki>...‎</nowiki> au besoin.
  • Ajouter ‎<charinsert>...‎</charinsert> tags dans MediaWiki:Edittools.

Installation

En raison du bug T88922, la barre d'outils fournie par CharInsert ne fonctionne pas sur la page spéciale "Télécharger" lorsqu'elle est utilisée sur MediaWiki 1.27.x. Utilisez la version fournie pour MediaWiki 1.28+ mais notez que certains Gadgets peuvent ne pas fonctionner comme prévu sans mise à jour supplémentaire.
  • Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé CharInsert dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
    wfLoadExtension( 'CharInsert' );
    
  • Si vous utilisez le gadget Edittools , mettez à jour son code vers la dernière version (≥ 27 mai 2016)
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Pour les utilisateurs de MediaWiki 1.24 ou précédents :

Les instructions ci-dessus décrivent la nouvelle procédure pour installer cette extension en utilisant wfLoadExtension(). Si vous avez besoin d'installer cette extension sur les précédentes versions de MediaWiki (1.24 ou antérieur), à la place de wfLoadExtension( 'CharInsert' );, vous devez utiliser :

require_once "$IP/extensions/CharInsert/CharInsert.php";

Configuration avancée

Important : Vous devez avoir Extension : Gadgets pour que cela fonctionne.

Mise en forme

Charinsert-sample-edittools-box.png

Pour donner aux listes de charinsert un style supplémentaire, enveloppez le contenu de vos outils d'édition entre <div class="mw-charinsert-buttons"> et ‎</div> et ajoutez un style pour eux à 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 Wikimedia Design Style Guide et du WikimediaUI thème:

 
/**
 * 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 wikisyntax 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. Documenté ci-dessous est la façon dont il est fait sur mediawiki.org :

1. Enveloppez 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. Envelopper chaque bloc de graphiques dans des balises ‎<p> comme ceci :
<p class="mw-edittools-section" data-section-title="Wiki-Syntax" style="display: none;">
...
</p>
Note:
  • Don't change the word 'mw-edittools-section'
  • The text behind "data-section-title=" will identify this group in the dropdown menu.
  • Make sure there is one group without the 'style="display: none;"' directive: That will be the default choice in the dropdown menu. On this site, it is called 'Standard' while the other groups are named by the language for which the characters are significant.
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

English Wikipedia CharInsert menu

For implementing CharInsert menu like the one used on the English Wikipedia, either export gadgets: Charinsert-core, Charinsert-styles, and Charinsert and then import them on your own wiki through Special:Import or if you want to do it manually, copy the following four interface pages to your wiki:

* 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) - Only for users with JavaScript turned off or unsupported (which disables the WikiEditor extension too), therefore not really necessary or useful either. It only shows symbols/characters as simple text below the editor window, which can then be copy-pasted and thus be of some help to editors. Apparently, it does not get activated in English Wikipedia for disabled JavaScript.

Note: This particular English Wikipedia character set also contains templates, which will need to be defined separately, if they are to be used on your Wiki.

English Wikipedia Solution checked on: November 6, 2018