Modification de Gadget-specialchars

''Cette documentation a été importée du Wiktionnaire.''

[[Fichier:Clavier-Azerty-France.svg|thumb|300px|Disposition AZERTY en usage en [[France]].]]
[[Fichier:Belgian pc keyboard.svg|thumb|300px|Disposition AZERTY en usage en [[Belgique]].]]
Le gadget '''specialchars''' («&nbsp;caractères spéciaux&nbsp;») est un code javascript, activable par tout utilisateur (enregistré) dans ses [[Spécial:Préférences#mw-prefsection-gadgets|préférences]], qui permet d’utiliser lors de l’édition des séquences particulières de caractères pour obtenir des caractères courants mais absents des claviers utilisés par la plupart des francophones.

Le principe général est que certaines séquences de caractères, normalement très improbables mais facilement réalisables sur un clavier AZERTY, sont automatiquement remplacées par un caractère prédéfini, lors de la frappe en mode édition. Par exemple taper «&nbsp;<code>$é</code>&nbsp;» donnera «&nbsp;<code>É</code>&nbsp;».

Ce gadget permet de pallier les dispositions défectueuses comme l’AZERTY (France) de Windows, sur lequel il manque les majuscules accentuées, les digrammes soudés, ainsi que la touche morte ''accent aigu'' et la touche morte ''cédille'' (mais non les touches mortes ''accent grave'' et ''tilde'', cf. l’illustration).

==Activer cette fonction==
Si vous êtes connecté sous un compte utilisateur, allez dans [[Spécial:Préférences#mw-prefsection-gadgets|vos préférences]], et cochez
*{{MediaWiki:Gadget-specialchars}}

Pour l’utiliser sur un autre wiki, ajoutez dans votre common.js :
<pre>mw.loader.load('//fr.wiktionary.org/w/index.php?title=MediaWiki:Gadget-specialchars.js&action=raw&ctype=text/javascript');</pre>

==Table de substitution==
Sauf pour les apostrophes et quelques autres, les codes commencent par le caractère «&nbsp;$&nbsp;», qui est facilement accessible sur les claviers AZERTY (juste à côté de la touche ''entrée'').
{|class="wikitable"
|+Apostrophes
|-
!scope="col"| Taper…
!scope="col"| …donne
!scope="col"| (justification)
|-
| une apostrophe droite isolée
| une apostrophe typographique
|c’est ce pourquoi ce gadget a été conçu !
|-
| une apostrophe droite précédée d’une autre, droite ou non
| deux apostrophes droites
|c’est pour la wiki-syntaxe de l’italique et du gras
|-
| une apostrophe typographique
| une apostrophe typographique
|pas de substitution
|-
| deux apostrophes droites suivies d’un « backspace »
| une apostrophe droite
|c’est pour la wikisyntaxe dans les modèles
|}

{|class="wikitable"
|+Tous les autres
|-
!scope="col"| Taper…
!scope="col"| …donne
!scope="col"|-
!scope="col"|&nbsp;
!scope="col"| Taper…
!scope="col"| …donne
!scope="col"|-
|-
| <code>$à</code>|| <code>À</code>|| a majuscule avec l’accent grave ||&nbsp;|| <code>$–</code>|| <code>–</code>|| tiret demi-cadratin
|-
| <code>$é</code>|| <code>É</code>|| e majuscule avec l’accent aïgue ||&nbsp;|| <code>$_</code>|| <code>—</code>|| tiret cadratin
|-
| <code>$è</code>|| <code>È</code>|| e majuscule avec l’accent grave ||&nbsp;|| <code>&lt;&lt;</code>|| <code>« </code>|| guillemet ouvrant avec espace
|-
| <code>$ç</code>|| <code>Ç</code>|| c cédille majuscule ||&nbsp;|| <code>&gt;&gt;</code>|| <code> »</code>|| guillemet fermant avec espace
|-
| <code>$ù</code>|| <code>Ù</code>|| u majuscule avec accent grave ||&nbsp;|| <code>...</code>|| <code>…</code>|| points de suspension
|-
| <code>$s</code>|| <code>ſ</code>|| s long, pour l’ancien français ||&nbsp;|| <code>$,</code>|| <code>ʻ</code>|| okina, pour l’hawaïen et le tahitien
|-
| <code>$AE</code>|| <code>Æ</code>|| e dans l’a majuscule||&nbsp;|| <code>$ae</code>|| <code>æ</code>|| e dans l’a minuscule
|-
| <code>$OE</code>|| <code>Œ</code>|| e dans l’o majuscule ||&nbsp;|| <code>$oe</code>|| <code>œ</code>|| e dans l’o minuscule
|-
| <code>$AA</code>|| <code>Ā</code>|| a majuscule avec macron ||&nbsp;|| <code>$aa</code>|| <code>ā</code>|| a minuscule avec macron
|-
| <code>$EE</code>|| <code>Ē</code>|| e majuscule avec macron ||&nbsp;|| <code>$ee</code>|| <code>ē</code>|| e minuscule avec macron
|-
| <code>$II</code>|| <code>Ī</code>|| i majuscule avec macron ||&nbsp;|| <code>$ii</code>|| <code>ī</code>||i minuscule avec macron
|-
| <code>$OO</code>|| <code>Ō</code>|| o majuscule avec macron||&nbsp;|| <code>$oo</code>|| <code>ō</code>|| o minuscule avec macron
|-
| <code>$UU</code>|| <code>Ū</code>|| u majuscule avec macron||&nbsp;|| <code>$uu</code>|| <code>ū</code>|| u minuscule avec macron
|}

==Pages ignorées==
Sur les pages dont le nom se termine par <code>.js</code> (qui contiennent en principe du JavaScript) ou par <code>.css</code> (qui contiennent en principe du CSS), ce gadget n’a aucun effet.

==Limitations et astuces==
Actuellement, la substitution est faite lorsque le curseur sort par la droite du groupe de caractères concernés. Cela a plusieurs conséquences, qui nécessitent d’être apprivoisées.
#Lorsqu’on tape un texte en séquence, la substitution a lieu dès que le dernier caractère tapé fait correspondre les précédents à un des "codes" prévus (ce qui est généralement ce qui est attendu).
#Lorsqu’on déplace le curseur dans le texte sans faire de modification, la substitution est faite dès que les caractères à gauche du curseur correspondent à un des "codes" prévus (ce peut être utile, mais il faut être vigilant).
#Il n’est pas possible d’annuler facilement la substitution.
#Pour que la substitution ne soit pas faite (comme pour obtenir « <code>$à</code> ») il faut «&nbsp;taper à l’envers&nbsp;», càd taper le premier caractère en dernier, afin de contourner le point 1 (voire le 2).
#La transformation des apostrophes est gérée à part, et est plus pointilleuse, même si les principes ci-dessus (et en particulier le 4) s’appliquent.
#*Pour obtenir une simple apostrophe droite (chose qui est rare dans un texte en français, c’est pourquoi le gadget ne prévoit pas de raccourci pour le faire), une solution est de taper deux apostrophes droites (ce qui donne « <nowiki>''</nowiki> ») puis d’effacer la deuxième avec la touche « backspace » (comme il s’agit d’un déplacement vers l’arrière, le « ' » restant n’est pas réévalué).
# L’[[okina]] s’obtient par la combinaison $, (dollar + virgule) par souci pratique et non pas $’ ou $' (dollar + apostrophe courbe ou droite) comme on pourrait s’y attendre.
Le gadget est incompatible avec [[Spécial:Préférences#mw-prefsection-editing|l’aperçu rapide (nécessitant JavaScript)]] de même qu’avec le [[Spécial:Préférences#mw-prefsection-gadgets|gadget WikEd]] ''activé'', il ne marche pas.


==Autres pages utiles==
*[[MediaWiki:Gadget-specialchars]] (la description dans la page des préférences).
*[[MediaWiki:Gadget-specialchars.js]] (la page contenant le code javascript).