Modèle:Unité/Documentation

Ceci est la sous-page de documentation du modèle {{Unité}} ; elle est insérée sur la page de celui-ci à l’aide du modèle {{Documentation}}. C’est également sur cette page que vous placerez les liens interwiki et les catégories du modèle.

Utilisation

modifier

Le modèle {{unité}} permet d’écrire facilement et de typographier correctement un nombre suivi d’une unité ou d’un nom (voir Lexique des règles typographiques en usage à l'Imprimerie nationale, Imprimerie nationale (ISBN 978-2-7433-0482-9), p. 61-62, dont : « Un nombre en chiffres arabes ou romains ne sera jamais séparé du nom qui le précède ou qui le suit [...] »). Par rapport à une écriture directe, ses avantages sont :

  • éviter un retour à la ligne automatique entre le nombre et l’unité correspondante, comme dans « 30 km » ;
  • 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 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 « 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}} mais en tant que redirection elle risque d'être remplacée par des contributeurs ou des robots.

Dans le cas d'un nombre seul il est 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:}}, un espace simple suffit pour {{unité}}.

Syntaxe

modifier
  • {{Unité|nombre|unité1|exposant1|unité2|exposant2|unité3|exposant3|unité4|exposant4}}

Paramètres

modifier

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

ParamètreDescriptionType
1=Valeur à afficherObligatoire
e=Puissance de 10 à afficherFacultatif
2=Premier symboleFacultatif
3=Exposant du premier symboleFacultatif
4=Deuxième symboleFacultatif
5=Exposant du deuxième symboleFacultatif
6=Troisième symboleFacultatif
7=Exposant du troisième symboleFacultatif
8=Quatrième symboleFacultatif
9=Exposant du quatrième symboleFacultatif
abr=Nom en toute lettre de l'unité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.

Avertissement de voyage ATTENTION :
  • Le premier paramètre, celui de la valeur à afficher, est mis en forme à l’aide du mot magique {{formatnum:}}. Par conséquent :
    • il faut utiliser le point comme séparateur décimal (convention anglo-saxonne), et non la virgule, dans le paramètre transmis au modèle. Le modèle affichera automatiquement le nombre suivant les conventions francophones.
    • le mot magique ne sait pas convertir les notations scientifiques exponentielles (utilisant le symbole e avant l’exposant entier) ; on placera l’exposant entier dans le paramètre nommé e ;
    • il ne faut pas insérer de séparateurs de milliers sous forme d’espace ou d’apostrophe : ils sont automatiquement ajoutés par le modèle sous forme d’espace (insécable), sauf pour la partie décimale, où, pour respecter la typographie recommandée, il est préférable de placer des espaces simples par groupes de trois chiffres.
    • il est cependant possible de grouper les chiffres autrement que par trois, en insérant explicitement une virgule comme séparateur (convention anglo-saxonne), laquelle sera transformée en espace (insécable) par le modèle.
  • Exemples :
    • « {{Unité|2,3|g}} » affiche « 2,3 g », ce qui n’est sans doute pas le résultat attendu ;
    • entrer « {{Unité|2.3|g}} » pour afficher « 2,3 g » ;
    • entrer « {{Unité|1002.3|km|abr=kilomètre}} » pour afficher « 1 002,3 km » ;
    • noter encore « {{Unité|1234567890.123 456 78|¤}} » qui affiche « 1 234 567 890,123 456 78 ¤ » etc.

Exemples d’utilisation

modifier
Syntaxe Résultat Commentaire
{{Unité|1234567}}
{{Unité|1234567.89}}
1 234 567
1 234 567,89
Cas d’utilisation minimale : une valeur seule (sans unité). L’utilisation du modèle uniquement pour une valeur équivaut à l’utilisation du modèle spécial {{formatnum:}}.
{{Unité|10000|km|abr=kilomètre}}
{{Unité|10000|km/h|abr=kilomètre par heure}}
10 000 km
10 000 km/h
Cas d’utilisation simple : une valeur suivie d’un symbole.
{{Unité|10000|km|2|abr=kilomètre-carré}}
{{Unité|10000|m|3}}
10 000 km2
10 000 m3
Cas d’utilisation pour une unité avec un exposant.
{{Unité|10000|kilomètres par heure}}10 000 kilomètres par heureNon 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é}} empêche les ruptures de ligne dans toute l’expression « 10 000 kilomètres par heure ».
{{Unité|10000|km||h|-1}}10 000 km⋅h-1Deux symboles successifs, le second avec un exposant.
{{Unité|10000|J|2|K|3|s|-1}}10 000 J2⋅K3⋅s-1Trois symboles avec des exposants spécifiques.
{{Unité|10000|J||kg||m|-2}}10 000 J⋅kg⋅m-2Trois symboles, les deux premiers ne possédant pas d’exposant.
{{Unité|−40.234|°C}}−40,234 °CCas mettant en évidence l’utilisation de la notation anglo-saxonne dans le premier paramètre, lequel est affiché selon les conventions francophones.
{{Unité|1|[[w:kilomètre carré|km{{exp|2}}]]}}1 km2Il est aussi possible de placer un lien vers l'article de Wikipédia concernant l'unité employée.
{{Unité|150000|[[Belgique|Belges]]}}
{{Unité|15|[[Belgique#Villes|villes belges]]}}
150 000 Belges
15 villes belges
Il est aussi possible de placer un lien vers l'article de Wikivoyage, ou une section d'un article, concernant l'unité employée.

Nombre seul

modifier

Bien que ce modèle fonctionne aussi dans ce cas, pour typographier une quantité sans unité ou non suivie d’un nom, il n’est pas nécessaire de l’utiliser. Le mot magique « {{formatnum:}} » est suffisant :

{{formatnum:nombre}}

(notez la présence du deux-points plutôt que la barre verticale).

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 wikiRendu HTML
{{Unité|20|%}}20 %
20 %20 %
20 %20 %

Cas particuliers de %

modifier
  • Aide sur l’espace insécable Logo indiquant un lien wikipédia  Aide détaillée sur Wikipédia.

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
  • Conventions concernant les nombres – Pour un comptage ou une mesure Logo indiquant un lien wikipédia  Article détaillé sur Wikipédia.

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 est donc inutile d’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.

Problème connu

modifier

Lorsque l’expression produite par le modèle {{Unité}} se trouve entre parenthèses, comme dans (1 309 m), certains navigateurs web permettent une rupture de ligne entre l’une des parenthèses et l’expression. Ce problème est notamment rencontré avec Internet Explorer 6 et 7, mais est résolu depuis la version 8.

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]

ParamètreDescriptionTypeÉtat
Valeur1

Valeur à afficher. Utilisez le point comme séparateur décimal (convention anglo-saxonne, au lieu de la virgule) et n'insérez pas de séparateurs de milliers sous forme d’espace. Le modèle affichera automatiquement le nombre suivant les conventions francophones.

Nombreobligatoire
Exposante

Puissance de 10 à afficher, par exemple « 9 » pour la valeur « 4,5×10^9 ».

Nombrefacultatif
Premier symbole2

Premier symbole, par exemple « m » pour l'unité de « mètre ».

Chaînefacultatif
Premier exposant3

Exposant du premier symbole, par exemple « 2 » pour l'unité « mètre carré ».

Nombrefacultatif
Deuxième symbole4

Deuxième symbole, par exemple « m » pour l'unité « mètre carré ».

Chaînefacultatif
Deuxième exposant5

Exposant du deuxième symbole, par exemple « 2 » pour l'unité « mètre carré ».

Nombrefacultatif
Troisième symbole6

Troisième symbole, par exemple « m » pour l'unité « mètre carré ».

Chaînefacultatif
Troisième Exposant7

Exposant du troisième symbole, par exemple « 2 » pour l'unité « mètre carré ».

Nombrefacultatif
Quatrième symbole8

Quatrième symbole, par exemple « m » pour l'unité « mètre carré ».

Chaînefacultatif
Quatrième exposant9

Exposant du quatrième symbole, par exemple « 2 » pour l'unité « mètre carré ».

Nombrefacultatif
Nom de l'unitéabr

Nom en toute lettre de l'unité, par exemple « kilomètre » pour l'abréviation « km ».

Chaînefacultatif

Voir aussi

modifier