Wikiquote

Modèle:Unité/Documentation

< Modèle:Unité
Ceci est la page de documentation de Modèle:Unité [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Ce modèle utilise le module Unité, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via une sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.

Utilisation

modifier

Le modèle {{unité}} permet d’écrire facilement et de typographier correctement un nombre écrit en chiffres arabes ou romains suivi d’une unité ou d’un nom[1]. Par rapport à une écriture directe, ses avantages sont :

  • empêcher le retour à la ligne entre le nombre et l’unité ou le nom correspondant, par l’insertion d’une espace insécable, comme dans « 30 km » ou « 250 habitants » ;
  • faciliter l’écriture des exposants et des unités multiples, comme dans « 10 m⋅s-1 » ;
  • faciliter les traductions d’articles lors d’import de valeurs (il suffit de modifier le nom du modèle) en affichant le nombre selon le format local ;
  • mettre en forme le nombre automatiquement en groupant les chiffres par groupes de trois, comme dans « 30 000 habitants ». Note : dans certains cas, la redirection {{nombre}} peut paraître préférable d’un point de vue sémantique, exemple : {{nombre|250000 déportés}}.

Dans le cas d’un nombre seul (et uniquement dans ce cas), utiliser le mot magique {{formatnum:}} demande moins de ressources au serveur, mais demande d'adopter la typographie anglo-saxonne (séparateurs décimal et de milliers). En particulier, le modèle {{unité}} est plus simple d’emploi dans le cas d’un nombre suivi d’une partie décimale car, alors que pour séparer les tranches de trois chiffres de la partie décimale (à droite de la virgule), il est nécessaire d’utiliser la virgule pour {{formatnum:}}, ce n’est pas utile pour {{unité}} (voir : « Wikipédia:Conventions typographiques#Nombres et espaces ») ; il permet également d’exprimer facilement une puissance de 10.

Dans le cas des écritures fractionnaires (barre de fraction en argument du modèle), le modèle ne respecte pas les conventions concernant les nombres sur Wikipédia.

Syntaxe

modifier

Paramètres

modifier

Le modèle peut prendre jusqu’à neuf paramètres numérotés et un paramètre nommé :

Paramètre Description Type note
1= Valeur à afficher Facultatif
à= Seconde valeur de la plage à afficher Facultatif
–= Seconde valeur de la plage à afficher Facultatif Demi-cadratin
et= Seconde valeur à afficher Facultatif
ou= Seconde valeur à afficher Facultatif
/= Seconde valeur à afficher Facultatif
×= Deuxième valeur de la dimension Facultatif
××= Troisième valeur de la dimension Facultatif
±= Incertitude Facultatif
+= Incertitude + si la plage n’est pas symétrique Facultatif
−= Incertitude − si la plage n’est pas symétrique Facultatif Signe moins
e= Puissance de 10 à afficher Facultatif
2= Premier symbole Facultatif
3= Exposant du premier symbole Facultatif
4= Deuxième symbole Facultatif
5= Exposant du deuxième symbole Facultatif
6= Troisième symbole Facultatif
7= Exposant du troisième symbole Facultatif
8= Quatrième symbole Facultatif
9= Exposant du quatrième symbole Facultatif
10= Cinquième symbole Facultatif
11= Exposant du cinquième symbole Facultatif
fraction= Fraction à afficher après le nombre Facultatif
arrondi= Arrondit la valeur après ce nombre de décimale Facultatif Peut être négatif
décimales Affiche exactement ce nombre de décimales Facultatif

Une unité complexe peut être spécifiée à l’aide d’un paramètre seul ou décomposée sous la forme d’une liste symbole|exposant. On peut omettre l’exposant (quand il vaut 1), en laissant simplement son champ vide. Le modèle accepte jusqu'à cinq symboles accompagnés chacun d'un exposant.

Le modèle reconnaît aussi bien le point que la virgule comme séparateur décimal, par exemple :

  • « {{Unité|2,3|g}} » affiche « 2,3 g » ;
  • « {{Unité|2.3|g}} » affiche « 2,3 g » ;
  • « {{Unité|1002,3|km}} » affiche « 1 002,3 km » ;
  • « {{Unité|1002.3|km}} » affiche « 1 002,3 km » ;
  • « {{Unité|1,002.3|km}} » affiche « 1,002,3 km » ;
  • « {{Unité|1 002.3|km}} » affiche « 1 002,3 km » ;
  • « {{Unité|1234567890.12345678|¤}} » affiche « 1 234 567 890,12345670 ¤ » ;
  • « {{Unité|1.002,3|km}} » affiche « 1,002,3 km » pour être compatible avec les limites précédentes du modèle, mais cette syntaxe est déconseillée car non conforme aux conventions typographiques.

Il est possible d’écrire l’ensemble nombre - unité dans le premier paramètre, ce qui simplifie la saisie :

  • {{Unité|1,23 ± 0,02 e-3 m/s2}} affiche « 1,23 ± 0,02 e−3 m/s2 ».

Cette possibilité ne permet pas de gérer certains cas complexes, souvent des détournements du modèle, tels que plusieurs nombres séparés par du texte dans un seul modèle, par exemple « 1,23 jusqu’à 2,32 m2 », ou des nombres ou exposants contenant des lettres (des variables mathématiques), par exemple « 2,5y e2i ».

Exemples d’utilisation

modifier
Syntaxe Résultat Commentaire
{{Unité|1234567}}
{{Unité|1234567,89}}
{{Unité|1,23456789|e=15}}
{{Unité|1,23456789e15}} 		1 234 567
1 234 567,89
1,23 456 789Modèle:X10
1,23 456 789 000 000 000 000 000 		Pour un nombre seul, la différence avec formatnum est qu’il est possible d’utiliser la virgule comme séparateur décimal, les décimales sont groupées par 3 (à partir de 5 décimales) et les puissances de 10 sont correctement affichées.
{{Unité|10000|km}}
{{Unité|10000|km/h}}
{{Unité|10000 km/h}} 		10 000 km
10 000 km/h
10 000 km/h 		Cas d’utilisation simple : une valeur suivie d’un symbole.
{{Unité|10000|km|2}}
{{Unité|10000|m|3}}
{{Unité|10000 m3}} 		10 000 km2
10 000 m3
10 000 m3 		Cas d’utilisation pour une unité avec un exposant.
{{Unité|10000|kilomètres par heure}}
{{Unité|10000 kilomètres par heure}} 		10 000 kilomètres par heure
10 000 kilomètres par heure 		Non conseillé. Il est possible d’écrire l’unité en toutes lettres. Dans ce cas il n’est cependant pas strictement nécessaire d’empêcher une rupture de ligne entre le nombre et l’unité complète, seul le premier terme doit être lié au nombre, ici « {{Unité|10000 kilomètres}} par heure ». Notez bien que le modèle {{Unité}} — tel {{nobr}} — empêche les ruptures de ligne dans toute l’expression « 10 000 kilomètres par heure ».
{{Unité|10000|km||h|-1}}
{{Unité|10000 km h-1}} 		10 000 km⋅h-1
10 000 km h−1 		Deux symboles successifs, le second avec un exposant.
{{Unité|10000|J|2|K|3|s|-1}}
{{Unité|10000 J2K3s-1}} 		10 000 J2⋅K3⋅s-1
10 000 J2K3s−1 		Trois symboles avec des exposants spécifiques.
{{Unité|10000|J||kg||m|-2}}
{{Unité|10000 J kg m-2}} 		10 000 J⋅kg⋅m-2
10 000 J kg m−2 		Trois symboles, les deux premiers ne possédant pas d’exposant. Dans la syntaxe en un seul paramètre, chaque unité doit être séparée par une espace.
{{Unité|−40.234|°C}} −40,234 °C Cas mettant en évidence l’utilisation de la notation anglo-saxonne dans le premier paramètre, lequel est affiché selon les conventions francophones.
{{Unité|1.23456|e=9|J|2|K|3|s|-1}}
{{Unité|1,23456 e9 J2 K3 s-1}} 		1,23456Modèle:X10 J2⋅K3⋅s-1
1,23 456 e9 J2 K3 s−1 		Trois symboles avec des exposants spécifiques, mettant en évidence l’utilisation de la notation anglo-saxonne, ainsi que l’usage de puissances de 10 (usage scientifique) dans le paramètre nommé e, formaté à l’aide du modèle {{x10}}.
{{Unité|1|[[mètre carré|m{{exp|2}}]]}}
{{Unité|1|[[mètre carré|m]]|2}}		 1 m2
1 m2		 Il est aussi possible de placer un lien vers les unités.
{{unité|e-1 m}}
{{unité|10{{exp|−1}}|m}}
{{unité|10{{-1}}|m}} 		e−1 m
10−1 m
10Modèle:−1 m 		Affichage d’une puissance de 10 suivie d’un symbole, au moyen du modèle {{exp}}. Pour cet exemple, le modèle {{-1}}, plus pratique, donne le même résultat.
{{Unité|1235 ±20 m}}
{{Unité|1235 +20 -10 m}}
{{Unité|1,235 ±0.02 e3 m}} 		1 235 ±20 m
1 235 +20 −10 m
1,235 ±0,02 e3 m 		Une incertitude peut-être ajoutée. Dans le cas de la notation avec des puissances de 10, des parenthèses sont ajoutées pour clarifier la portée de cette puissance, mais elles ne sont pas prises en charge dans le paramètre.
{{Unité|1200 à 1300 m}}
{{Unité|1200 – 1300 m}}
{{Unité|1200 et 1300 m}}
{{Unité|1200 / 1300 m}}
{{Unité|1200 × 600 m}}
{{Unité|12×6×2,3 cm}}
{{Unité|12|×=6|××=2,3|cm}} 		1 200 à 1 300 m
1 200 – 1 300 m
1 200 et 1 300 m
1 200 / 1 300 m
1 200 × 600 m
12×6×2,3 cm
12 cm 		Il est possible de relier plusieurs nombres avec quelques mots clé.
Pour les surfaces ou volumes, les « x » et les « * » sont acceptés dans la syntaxe en un paramètre, et toujours affichés par « × ». En cas d’utilisation avec des paramètres séparés, seul le « × » est accepté, et il faut le doubler pour la troisième dimension.
On peut aussi, plus simplement, recourir aux modèles {{dunité}} et {{tunité}}, respectivement pour deux et trois valeurs ayant une même unité.
{{Unité|16 2/3 Hz}}
{{Unité|1/2 lb}} 		16 2/3 Hz
1/2 lb 		Fraction pour éviter une approximation ou être plus proche de l’expression courante.
Notez qu’il ne faut pas mettre d’espace entre les chiffres et la barre de fraction, sinon c’est interprété comme deux nombres séparés par une barre oblique (paramètre /)
{{Unité|1.23456|m|arrondi=3}}
{{Unité|1.23456|m|arrondi=6}}
{{Unité|123456|m|arrondi=-2}}
{{Unité|1.23456 e5 m|arrondi=3}}
{{Unité|1.23456|m|décimales=3}}
{{Unité|1.23456|m|décimales=6}} 		1,23456 m
1,23456 m
123 456 m
1,23456 e5 m
1,23456 m
1,23456 m 		Les résultats d’un calcul automatique peuvent être arrondis ou affichés avec un nombre fixe de décimales.

Nombres seuls

modifier

Bien que ce modèle fonctionne aussi dans ce cas, pour typographier une quantité n’étant pas en notation scientifique et sans unité ou non suivie d’un nom, il n’est pas nécessaire de l’utiliser. Le mot magique « {{formatnum:nombre}} » est suffisant (notez la présence du deux-points plutôt que la barre verticale). Pour les nombres en notation scientifique sans unité, il est possible d’utiliser ce mot magique en combinaison avec le modèle {{x10}}.

Dans quel cas ne pas utiliser ce modèle ?

modifier
Résultat identique pour un code wiki beaucoup plus simple à éditer sans modèle
Code wiki Rendu HTML
{{Unité|20|%}} 20&#160;%
20&nbsp;% 20&#160;%
20 % 20&#160;%

Cas particuliers de %

modifier
Aide détaillée : Erreur de script : le module « Multiparamètres » n’existe pas..

Ce modèle est inutile et déconseillé lorsque l’unité est le « pour cent ». Cela complique l’édition et la lecture du code wiki pour un résultat identique. Il suffit d’insérer une espace simple car, dans ce cas particulier, l’espace insécable est automatiquement gérée par MediaWiki, voir les conventions typographiques.

Note : en revanche, ce modèle doit être utilisé lorsque l’unité est le « pour mille ». {{Unité|5|‰}} aura pour rendu : 5 ‰.

Unités sexagésimales d’angle et degré d’alcool

modifier
Article détaillé : Erreur de script : le module « Multiparamètres » n’existe pas..

Dans le cas des unités sexagésimales d’angle (mesure d’angle, latitude, longitude) et du degré d’alcool, le symbole d’unité ne doit pas être détaché du nombre. Il ne faut donc pas utiliser le modèle.

On écrira donc simplement : « un angle de 30° » , « un vin titrant 11° ».

Mais il est souhaitable d’écrire (en utilisant le modèle {{nobr}}) : {{nobr|35° 19′ 20″ de latitude N}} qui donne 35° 19′ 20″ de latitude N.

Notes et références

modifier
  1. ↑ Lexique des règles typographiques en usage à l'Imprimerie nationale, Imprimerie nationale (ISBN 978-2-7433-0482-9), p. 61-62 :
    Un nombre en chiffres arabes ou romains ne sera jamais séparé du nom qui le précède ou qui le suit
    .

TemplateData

modifier

Met en forme un nombre et son unité, en ajoutant automatiquement des séparateurs de milliers (espaces), une infobulle sur les éventuels symboles, et empêche tout retour à la ligne entre le nombre et son unité.

Paramètres du modèle[Modifier les données du modèle]

La mise en forme sur une seule ligne est préférée pour ce modèle.

ParamètreDescriptionTypeÉtat
Valeur1

Valeur à afficher. L'unité peut être saisie directement à la suite, ou alors être saisie dans le champ « Unité ».

Exemple
« 12,34 » ou « 12,34 kg »
Ligne de texteobligatoire
àà

Permet d'indiquer un intervalle avec la conjonction « à ».

Exemple
15,36
Nombrefacultatif
ouou

Permet d’indiquer un deuxième nombre avec la conjonction « ou ».

Exemple
15,36
Nombrefacultatif
etet

Permet d’indiquer un deuxième nombre avec la conjonction « et ».

Exemple
15,36
Nombrefacultatif
–– -

Permet d'indiquer un intervalle à l'aide d'un tiret demi‑cadratin.

Exemple
15,36
Nombrefacultatif
//

Permet d’indiquer un deuxième nombre clairement séparé par «&ensp;/&ensp;». Notamment utilisé dans les infobox pour séparer deux séries de nombres.

Exemple
15,36
Nombrefacultatif
×× x

Permet d’indiquer un deuxième nombre séparé par un signe multiplier, par exemple pour une surface.

Exemple
29,7
Nombrefacultatif
××××

Permet d’indiquer un troisième nombre séparé par un signe multiplier, par exemple pour un volume.

Exemple
3
Nombrefacultatif
Exposante

Puissance de 10 à afficher.

Exemple
9 pour la valeur « 4,5×10^9  ».
Nombrefacultatif
Unité2

Indiquer la première unité sous forme de symbole ou en toutes lettres. L'unité peut également être indiquée dans le champ « Valeur » au lieu de l'indiquer ici.

Exemple
« kg », « kilogrammes »
Ligne de textefacultatif
Premier exposant3

Exposant du premier symbole.

Exemple
2 pour l’unité « mètre carré ».
Nombrefacultatif
Deuxième symbole4

aucune description

Exemple
s pour l’unité « mètre par seconde carré ».
Ligne de textefacultatif
Deuxième exposant5

Exposant du deuxième symbole.

Exemple
-2 pour l’unité « mètre par seconde carré ».
Nombrefacultatif
Troisième symbole6

aucune description

Ligne de textefacultatif
Troisième Exposant7

Exposant du troisième symbole.

Nombrefacultatif
Quatrième symbole8

aucune description

Ligne de textefacultatif
Quatrième exposant9

Exposant du quatrième symbole.

Nombrefacultatif
Cinquième symbole10

aucune description

Ligne de textefacultatif
Cinquième exposant11

Exposant du cinquième symbole.

Nombrefacultatif
±± +- +/-

Incertitude.

Exemple
0,05
Nombrefacultatif
++

Incertitude positive, si la valeur est différente de l’incertitude négative.

Exemple
0,2
Nombrefacultatif
−−

Incertitude négative, si la valeur est différente de l’incertitude positive.

Exemple
0,1
Nombrefacultatif
arrondiarrondi

Nombre maximal de décimales affichées.

Exemple
2
Nombrefacultatif
décimalesdécimales

Nombre de décimales affichées.

Exemple
2
Nombrefacultatif
fractionfraction

fraction a afficher après l’éventuel nombre.

Exemple
2/3
Ligne de textefacultatif

Correspondance interwiki

modifier

La Wikipédia anglophone n’a pas de modèle identique, mais utilise un modèle similaire, « val », qui permet d’indiquer un intervalle approximatif et une unité de mesure.

Veuillez ne pas utiliser la version francophone {{val}}, mais plutôt ce modèle {{unité}}.

Voir aussi

modifier
Récupérée de « https://fr.wikiquote.org/w/index.php?title=Modèle:Unité/Documentation&oldid=309110 »