Modèle:Unité/Documentation

Documentation du modèle

Ceci est la page de documentation de Modèle:Unité. [rafraîchir] · [modifier] · [historique]

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

Dans le cas d’un nombre seul (et uniquement dans ce cas), il peut sembler préférable d’utiliser le mot magique {{formatnum:}}. Cependant, 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

{{Unité|nombre|unité₁|exposant₁|unité₂|exposant₂|unité₃|exposant₃|unité₄|exposant₄}}
{{Unité|nombre|e=puissance de 10|unité₁|exposant₁|unité₂|exposant₂|unité₃|exposant₃|unité₄|exposant₄}}

Paramètres modifier

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

Paramètre	Description	Type
`1=`	Valeur à afficher	Facultatif
`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

Il est possible de spécifier une unité complexe à l’aide d’un paramètre seul ou de la décomposer sous la forme d’une liste symbole|exposant. Il est aussi possible de ne pas mettre d’exposant (quand il vaut 0) ; pour cela, il suffit de laisser celui-ci vide. Au maximum, il est possible d’afficher quatre symboles possédant chacun un exposant.

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

« {{Unité|2,3|g}} » affiche « 2,3 g » (et catégorise dans Catégorie:Pages avec des arguments non numériques dans formatnum);
« {{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 ».

Exemples d’utilisation modifier

Syntaxe	Résultat	Commentaire
`{{Unité\|1234567}}` `{{Unité\|1234567.89}}` `{{Unité\|1,23456789\|e=15}}`	1 234 567 1 234 567,89 1,23 456 789×10¹⁵	Pour un nombre seul, 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}}`	10 000 km 10 000 km/h	Cas d’utilisation simple : une valeur suivie d’un symbole.
`{{Unité\|10000\|km\|2}}` `{{Unité\|10000\|m\|3}}`	10 000 km² 10 000 m³	Cas d’utilisation pour une unité avec un exposant.
`{{Unité\|10000\|kilomètres par heure}}`	10 000 kilomètres par heure	Non conseillé. Il est possible d’écrire l’unité en toutes lettres.
`{{Unité\|10000\|km\|\|h\|-1}}`	10 000 km⋅h^-1	Deux symboles successifs, le second avec un exposant.
`{{Unité\|10000\|J\|2\|K\|3\|s\|-1}}`	10 000 J²⋅K³⋅s^-1	Trois symboles avec des exposants spécifiques.
`{{Unité\|10000\|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}}`	1,23456×10⁹ J²⋅K³⋅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 m² 1 m²	Il est aussi possible de placer un lien vers les unités.

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 %`
`20 %`	`20 %`
`20 %`	`20 %`

Cas particuliers de % modifier

Voir aussi : Aide sur l’espace insécable

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

Voir aussi : Conventions concernant les nombres – Pour un comptage ou une mesure

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

↑ Lexique des règles typographiques en usage à l’Imprimerie nationale, Imprimerie nationale ISBN 978-2-7433-0482-9, pages 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

Ce modèle permet d’écrire facilement et de typographier correctement un nombre suivi d’une unité ou d’un nom.

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ètre		Description	Type	État
Valeur	`1`	Valeur à afficher. Exemple 12,34	Nombre	obligatoire
Exposant	`e`	Puissance de 10 à afficher. Exemple 9 pour la valeur « 4,5×10^9 ».	Nombre	facultatif
Premier symbole	`2`	aucune description Exemple m pour l’unité de « mètre ».	Ligne de texte	suggéré
Premier exposant	`3`	Exposant du premier symbole. Exemple 2 pour l’unité « mètre carré ».	Nombre	facultatif
Deuxième symbole	`4`	aucune description Exemple s pour l’unité « mètre par seconde carré ».	Ligne de texte	facultatif
Deuxième exposant	`5`	Exposant du deuxième symbole. Exemple -2 pour l’unité « mètre par seconde carré ».	Nombre	facultatif
Troisième symbole	`6`	aucune description	Ligne de texte	facultatif
Troisième Exposant	`7`	Exposant du troisième symbole.	Nombre	facultatif
Quatrième symbole	`8`	aucune description	Ligne de texte	facultatif
Quatrième exposant	`9`	Exposant du quatrième symbole.	Nombre	facultatif

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.

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

Voir aussi modifier

Aide:Syntaxe#Les nombres
Wikipédia:Conventions concernant les nombres
Espace insécable, obtenue par «   » dans MediaWiki — éviter la rupture de ligne sur une espace.
{{x10}} — notation scientifique avec puissance de 10.
{{nobr}} — éviter une rupture d’une ligne dans une expression.
Aide de « formatnum », sur Meta.

[1] Lexique des règles typographiques en usage à l’Imprimerie nationale, Imprimerie nationale ISBN 978-2-7433-0482-9, pages 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 ».

[1]