« Modèle:Unité/Documentation » : différence entre les versions

Navigation interactive dans l’historique

Contenu supprimé Contenu ajouté

Intégrés

Dernière version du 25 mai 2024 à 12:16

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 sa sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.

Raccourcis [+]

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 :

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 « 1 500 habitants » ;
faciliter l’écriture des exposants et des unités multiples, comme dans « 10 m s⁻¹ » ;
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}} ;
mettre en forme automatiquement les nombres en notation scientifique, comme dans « 5 × 10⁸ » ;
ajouter une infobulle sur les unités.

Dans le cas d’un nombre « simple » suivi d'un nom, utiliser de préférence le modèle {{nobr}}. Il ne gère que les nombres sans mise en forme particulière (en particulier, sans séparateurs de milliers ni décimaux), mais est plus économe en ressources consommées par le serveur.

Dans le cas d’un nombre « simple » seul (et uniquement dans ce cas), utiliser le mot magique {{formatnum:}}, qui demande moins de ressources au serveur. Utilisé avec des nombres plus « complexes », il impose d'adopter un hybride de typographie anglo-saxonne (séparateurs décimal et de milliers). En particulier, dans le cas d’un nombre suivi d’une partie décimale (comprenant des chiffres après la virgule), il prend le point comme séparateur décimal (au lieu de la virgule) et ne peut afficher correctement que trois chiffres de la partie décimale (ex. : {{formatnum:3.141592}}), ce qui n’est pas le cas de {{unité}} (voir : « Wikipédia:Conventions typographiques#Nombres et espaces » et « Formatage de formatnum: »).

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

Deux syntaxes sont possibles, mais il ne faut pas les mélanger.

Syntaxe distinguant chacun des paramètres

Syntaxe simple (un nombre) :
{{Unité|nombre|unité₁|exposant₁|unité₂|exposant₂|unité₃|exposant₃|unité₄|exposant₄|unité₅|exposant₅}}

Un seul paramètre est indispensable, nombre ou unité₁.

Syntaxe plus complexe (deux nombres) :
{{Unité|premier nombre|à=second nombre|et=second nombre|±=incertitude|e=puissance de 10|unité₁|exposant₁|symbole₂|unité₂|symbole₃|unité₃|unité₄|exposant₄|unité₅|exposant₅}}

Les paramètres à= (pour une plage de valeurs) et et= (pour une paire de valeurs) sont facultatifs mais mutuellement exclusifs. Les paramètres ±=, e= ainsi que les unités et les exposants sont facultatifs.

Syntaxe à un paramètre global

{{Unité|nombre₁ à/et nombre₂ ± incertitude epuissance-de-10 unité₁exposant₁ unité₂exposant₂ unité₃exposant₃ unité₄exposant₄ unité₅exposant₅}}

Le terme « à/et » est à remplacer par à (plage de valeurs) ou et (paire de valeurs). Il faut au moins indiquer nombre₁, ± incertitude ou unité₁ ; à cette exigence près, nombre₁, les groupes à/et nombre₂, ± incertitude et epuissance-de-10 ainsi que les unités et leurs exposants sont tous facultatifs.

Le modèle interprète aussi correctement le signe de fraction, par exemple g/cm3 pour « g/cm³ » (gramme par centimètre cube).

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 m² », ou des nombres ou exposants contenant des lettres (des variables mathématiques), par exemple « 2,5y e²ⁱ ».

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
`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.
`basique=`	Désactive la syntaxe en un seul paramètre et les analyses sur le deuxième paramètre	Facultatif	Principalement destiné aux infobox.

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,123 456 78 ¤ » ;
« {{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.

La syntaxe à un paramètre simplifie la saisie :

{{Unité|1,23 ± 0,02 e-3 m/s2}} affiche « (1,23 ± 0,02) × 10⁻³ m/s² ».

Exemples d'utilisation

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,234 567 89 × 10¹⁵ 1,234 567 89 × 10¹⁵	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}}`	10 000 km 10 000 km	Cas d’utilisation simple : une valeur suivie d’un symbole.
`{{Unité\|10000\|km\|2}}` `{{Unité\|10000\|m\|3}}` `{{Unité\|10000 m3}}`	10 000 km² 10 000 m³ 10 000 m³	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	Il est possible d'écrire l'unité en toutes lettres.
`{{Unité\|10000\|km\|\|h\|-1}}` `{{Unité\|10000\|km\|\|/h}}` `{{Unité\|10000 km h-1}}` `{{Unité\|10000 km/h}}`	10 000 km h⁻¹ 10 000 km/h 10 000 km h⁻¹ 10 000 km/h	Deux symboles successifs, le second avec un exposant.
`{{Unité\|10000\|J\|2\|K\|3\|s\|-1}}` `{{Unité\|10000 J2K3s-1}}`	10 000 J² K³ s⁻¹ 10 000 J² K³ s⁻¹	Trois symboles avec des exposants spécifiques.
`{{Unité\|10000\|J\|\|kg\|\|m\|-2}}` `{{Unité\|10000 J kg m-2}}`	10 000 J kg m⁻² 10 000 J kg m⁻²	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,234 56 × 10⁹ J² K³ s⁻¹ 1,234 56 × 10⁹ J² K³ s⁻¹	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.
`{{unité\|e-1 m}}` `{{unité\|10{{exp\|−1}}\|m}}` `{{unité\|10{{-1}}\|m}}`	10⁻¹ m 10⁻¹ m 10⁻¹ 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) × 10³ 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 × 6 × 2,3 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 ²⁄₃ Hz ¹⁄₂ lb	Fraction pour éviter une approximation ou être plus proche de l’expression courante. Ne 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,235 m 1,234 56 m 123 500 m 1,235 × 10⁵ m 1,235 m 1,234 560 m	Les résultats d’un calcul automatique peuvent être arrondis ou affichés avec un nombre fixe de décimales.

Cas particuliers

Pour les nombres sans mise en forme particulière et suivis d'un nom, utiliser de préférence le modèle {{nobr}}, plus simple. Pour typographier les nombres seuls, n’étant pas en notation scientifique, ne comportant que trois chiffres décimaux au plus, et non suivis d'une unité ou d’un nom, le mot magique « {{formatnum:nombre}} » est suffisant.

Dans quels 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\|%}}`	`20 %`
`20 %`	`20 %`
`20 %`	`20 %`

Cas particuliers de %

Aide détaillée : 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

Article détaillé : 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 ce modèle.

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

Dans le cas de coordonnées composées, il est souhaitable d’utiliser le modèle {{nobr}} : {{nobr|35° 19′ 20″}} de latitude N qui donne : 35° 19′ 20″ de latitude N.

Symbole « a »

Le symbole « a » est celui de l'are ou d'annum (année julienne).

« {{Unité|123 a}} » affiche « 123 a » avec l'infobulle « are ».
« {{Unité|3 cm/an}} » affiche « 3 cm/an » avec l'infobulle « centimètre par an ».

Les multiples et sous-multiples usuels sont gérés correctement (absence d'ambiguïté, en pratique) : ca et ha (qui concernent l'are), ka, Ma et Ga (qui concernent l'annum).

Terme « F »

« F » est le symbole du farad.

« {{Unité|123 F}} » affiche « 123 F » avec l'infobulle « farad ».

« F » est aussi l'abréviation courante des unités monétaires (actuelles ou anciennes) portant le nom de « franc » (ex. : franc suisse, franc CFA, franc Pacifique, franc français).

Symboles « N m », « Nm³ » et « Nm »

« {{Unité|123 N m}} » affiche « 123 N m » avec l'infobulle « newton mètre ».
« {{Unité|123 Nm3}} » affiche « 123 Nm³ » avec l'infobulle « normo mètre cube ».
- « {{Unité|123 Nm}} » affiche « 123 Nm » avec l'infobulle « normo mètre ».

Symbole « MN »

« {{Unité|123 MN}} » affiche « 123 MN » avec l'infobulle « méganewton ».
« MN » est aussi le symbole du mille marin.

Symbole « b »

« {{Unité|64 b}} » affiche « 64 b » avec l'infobulle « bit ».
« b » est aussi le symbole du barn.

Texte alternatif pour les images

MediaWiki retire automatiquement les balises HTML/CSS indésirables qui sont dans le paramètre |alt= pour être conforme aux normes W3C, ajouter le modèle {{unité}} n’est donc pas utile et n’aura aucun effet.

Notes et références

↑ 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

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
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. 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 texte	obligatoire
à	`à`	Permet d'indiquer un intervalle avec la conjonction « à ». Exemple 15,36	Nombre	facultatif
ou	`ou`	Permet d’indiquer un deuxième nombre avec la conjonction « ou ». Exemple 15,36	Nombre	facultatif
et	`et`	Permet d’indiquer un deuxième nombre avec la conjonction « et ». Exemple 15,36	Nombre	facultatif
–	`–` `-`	Permet d'indiquer un intervalle à l'aide d'un tiret demi‑cadratin. Exemple 15,36	Nombre	facultatif
/	`/`	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	Nombre	facultatif
×	`×` `x`	Permet d’indiquer un deuxième nombre séparé par un signe multiplier, par exemple pour une surface. Exemple 29,7	Nombre	facultatif
××	`××`	Permet d’indiquer un troisième nombre séparé par un signe multiplier, par exemple pour un volume. Exemple 3	Nombre	facultatif
Exposant	`e`	Puissance de 10 à afficher. Exemple 9 pour la valeur « 4,5×10^9 ».	Nombre	facultatif
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 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
Cinquième symbole	`10`	aucune description	Ligne de texte	facultatif
Cinquième exposant	`11`	Exposant du cinquième symbole.	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	Ligne de texte	facultatif
M	`M`	Masse molaire, destinée à afficher en infobulle une conversion de g/cm³ en m³/mol ou de kJ/mol en kJ/g Exemple 26.0373	Nombre	facultatif
basique	`basique`	Désactive la syntaxe en un seul paramètre. Principalement destiné aux infobox. Par défaut non	Booléen	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.

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
{{Tunité}} qui sert à indiquer les trois dimensions d’un objet parallélépipédique, par exemple d’une tombe
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.
Catégorie:Page incorrectement traitée par le Module:Unité

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

[1]