Tipapitcikesinihikan:Unité

Documentation

Ce modèle utilise le module Tipapitcikesinihikan:Modèle utilisant les modules Lua/lien module, 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.

Tipapitcikesinihikan:Sommaire à droite Tipapitcikesinihikan:Raccourci de modèle

Utilisation

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 :

éviter un retour à la ligne automatique entre le nombre et l’unité ou le nom correspondant, comme dans « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » ou « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » ;
faciliter l’écriture des exposants et des unités multiples, comme dans « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » ;
faciliter les traductions d'articles lors d'import de valeurs (il faut toutefois 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 « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). ». 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), 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.

Syntaxe

{{Unité|nombre|unité₁|exposant₁|unité₂|exposant₂|unité₃|exposant₃|unité₄|exposant₄|unité₅|exposant₅}}
{{Unité|nombre|à=seconde valeur de la plage|et=seconde valeur|±=incertitude|e=puissance de 10|unité₁|exposant₁|symbole₂|unité₂|symbole₃|unité₃|unité₄|exposant₄|unité₅|exposant₅}}
{{Unité|nombre ±incertitude epuissance de 10 unité₁exposant₁ symbole₂unité₂ symbole₃unité₃ unité₄exposant₄ unité₅exposant₅}}

Paramètres

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
`fraction=`	fraction à afficher après le nombre	Facultatif
`arrondi=`	Arrondi la valeur après ce nombre de décimale	Facultatif	Peut être négatif
`décimales`	Affiche exactement ce nombre de décimales	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 reconnait aussi bien le point que la virgule comme séparateur décimal, exemples :

« {{Unité|2,3|g}} » affiche « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » ;
« {{Unité|2.3|g}} » affiche « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » ;
« {{Unité|1002,3|km}} » affiche « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » ;
« {{Unité|1002.3|km}} » affiche « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » ;
« {{Unité|1,002.3|km}} » affiche « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » ;
« {{Unité|1 002.3|km}} » affiche « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » ;
« {{Unité|1234567890.12345678|¤}} » affiche « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). »
« {{Unité|1.002,3|km}} » affiche « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). » pour être compatible avec les limites précédentes du modèle, mais cette syntaxe est déconseillée.

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 « Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). »

Exemples d’utilisation

Syntaxe	Résultat	Commentaire
`{{Unité\|1234567}}` `{{Unité\|1234567,89}}` `{{Unité\|1,23456789\|e=15}}` `{{Unité\|1,23456789e15}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 521: attempt to index field 'convert' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 521: attempt to index field 'convert' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 521: attempt to index field 'convert' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	Pour un nombre seul, la différence avec formatnum est la possibilité 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}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	Cas d’utilisation simple : une valeur suivie d’un symbole.
`{{Unité\|10000\|km\|2}}` `{{Unité\|10000\|m\|3}}` `{{Unité\|10000 m3}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	Cas d’utilisation pour une unité avec un exposant.
`{{Unité\|10000\|kilomètres par heure}}` `{{Unité\|10000 kilomètres par heure}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	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é}} Tipapitcikesinihikan:Incise empêche les ruptures de ligne dans toute l’expression « Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). ».
`{{Unité\|10000\|km\|\|h\|-1}}` `{{Unité\|10000 km h-1}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	Deux symboles successifs, le second avec un exposant.
`{{Unité\|10000\|J\|2\|K\|3\|s\|-1}}` `{{Unité\|10000 J2K3s-1}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	Trois symboles avec des exposants spécifiques.
`{{Unité\|10000\|J\|\|kg\|\|m\|-2}}` `{{Unité\|10000 J kg m-2}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	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}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	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}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	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}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value).	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}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	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}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	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 supportées 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}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value).	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.
`{{Unité\|16 2/3 Hz}}` `{{Unité\|1/2 lb}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value).	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}}`	Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 309: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value). Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value).	Les résultats d'un calcul automatique peuvent être arrondis ou affichés avec un nombre fixe de décimales.

Nombres seuls

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 ?

Résultat identique pour un code wiki beaucoup plus simple à éditer sans modèle
Code wiki	Rendu HTML
`{{Unité\|20\|%}}`	`20Tipapitcikesinihikan:Rouge%`
`20 %`	`20Tipapitcikesinihikan:Rouge%`
`20 %`	`20Tipapitcikesinihikan:Rouge%`

Cas particuliers de %

Tipapitcikesinihikan:Aide détaillée 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 : Lua oniparin dans Aitapihikewin:Unité à la ligne 646: attempt to index field 'unit' (a nil value)..

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

Tipapitcikesinihikan:Article détaillé 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

↑ Lexique des règles typographiques en usage à l'Imprimerie nationale, Imprimerie nationale Tipapitcikesinihikan:ISBN, Tipapitcikesinihikan:P., dont : Tipapitcikesinihikan:Citation.

Templatedata

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		E witcikemakak	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 ».	Chaîne	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é ».	Chaîne	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 Exemple « s » pour l'unité « métre par seconde carré ».	Chaîne	facultatif
Troisième Exposant	`7`	Exposant du troisième symbole.	Nombre	facultatif
Quatrième symbole	`8`	aucune description	Chaîne	facultatif
Quatrième exposant	`9`	Exposant du quatrième symbole.	Nombre	facultatif
Cinquième symbole	`10`	aucune description	Chaîne	facultatif
Cinquième exposant	`11`	Exposant du cinquième symbole.	Nombre	facultatif
à	`à`	Permet d'avoir un deuxième nombre avec la conjonction « à ». Exemple 15,36	Nombre	facultatif
et	`et`	Permet d'avoir un deuxième nombre avec la conjonction « et ». Exemple 15,36	Nombre	facultatif
ou	`ou`	Permet d'avoir un deuxième nombre avec la conjonction « ou ». Exemple 15,36	Nombre	facultatif
/	`/`	Permet d'avoir 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	Nombre	facultatif
–	`–` `-`	Permet d'avoir un deuxième nombre séparé du premier par un tiret demi cadratin. Exemple 15,36	Nombre	facultatif
×	`×` `x`	Permet d'avoir un deuxiéme nombre séparé par un signe multiplier, par exemple pour une surface. Exemple 29,7	Nombre	facultatif
××	`××`	Permet d'avoir un troisième nombre séparé par un signe multiplier, par exemple pour un volume. Exemple 3	Nombre	facultatif
±	`±` `+-` `+/-`	Incertitude. Exemple 0,05	Nombre	facultatif
+	`+`	Incertitude positive, si la valeur est différente de l'incertitude négative. Exemple 0,2	Nombre	facultatif
−	`−`	Incertitude négative, si la valeur est différente de l'incertitude positive. Exemple 0,1	Nombre	facultatif
arrondi	`arrondi`	Nombre maximal de décimales affichées. Exemple 2	Nombre	facultatif
décimales	`décimales`	Nombre de décimales affichées. Exemple 2	Nombre	facultatif
fraction	`fraction`	fraction a afficher après l'éventuel nombre. Exemple 2/3	Chaîne	facultatif

Correspondance interwiki

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

{{unité/2}} qui offre plus de possibilités (conversions, approximations, intervalles)
{{Température}} qui permet de mettre en forme une température
{{λ}} qui permet de formater les longueurs d'onde
{{Monnaie}} qui permet de formater les devises
{{Dunité}} qui sert à indiquer les deux dimensions d'un objet rectangulaire, par exemple d’une peinture.
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.
{{exp}} — mettre en exposant.
{{nobr}} — éviter une rupture d’une ligne dans une expression.
Aide de « formatnum », sur Meta.

La documentation de ce modèle est incluse depuis sa sous-page de documentation (modifier | historique).
Veuillez placer les catégories dans la sous-page /Documentation.
Les éditeurs peuvent travailler dans le bac à sable (créer) et la page de test (créer).

[1] Lexique des règles typographiques en usage à l'Imprimerie nationale, Imprimerie nationale Tipapitcikesinihikan:ISBN, Tipapitcikesinihikan:P., dont : Tipapitcikesinihikan:Citation.

[1]