Modèl:Nombre amb unitat/Documentacion
Lo modèl {{Nombre amb unitat}} permet de contornar l'abséncia de gestion dels espacis insecables pel logicial MediaWiki dins los nombres amb unitats.
Principi[Modificar lo còdi]
Del punt de vista tipografic, un espaci insecable deu èsser present entre una valor e son unitat, segon la nòrma del Sistèma Internacional d'Unitats (per que la valor e l'unitat sián pas separadas per un retorn automatic a la linha, çò que nòi a la lisibilitat). Per exemple, sens utilizar aqueste modèl, es necessari d'escriure « 10 km » per afichar « 10 km ».
Aqueste modèl, {{Nombre amb unitat}}, permet de s'afranquir de la balisa e d'utilizar, de mai, la foncion {{formatnum:}} per metre en forma la valor.
Noms alternatius[Modificar lo còdi]
Per simplicitat, dins los articles, es pas necessari d'escriure {{Nombre amb unitat}}. Los modèls seguents, del nom abreujat, redirigisson vèrs aqueste modèl :
Utilizacion[Modificar lo còdi]
La sintaxi generala del modèl es la seguenta :
{{Unitat|1|2|3|4|5|6|7|8|9}}
|
Lo modèl pòt prendre fins a 9 paramètres :
| Paramètre | Descripcion | Tipe |
|---|---|---|
1 |
Valor d'afichar | Obligatòri |
2 |
Primièr simbòl | Obligatòri |
3 |
Exponent del primièr simbòl | Facultatiu |
4 |
Segond simbòl | Facultatiu |
5 |
Exponent del segond simbòl | Facultatiu |
6 |
Tresen simbòl | Facultatiu |
7 |
Exponent del tresen simbòl | Facultatiu |
8 |
Quatren simbòl | Facultatiu |
9 |
Exponent del quatren simbòl | Facultatiu |
Sols los dos primièrs paramètres son obligatòris : es possible d'especificar l'unitat en un sol còp (çò que permet d'utilizar una unitat quina que siá) o de la descompausar jos la forma d'una lista simbòl|exponent. Tanben es possible de metre pas d'exponent (quand il val 1), per aquò, sufís de daissar aqueste void. Al maximum, es possible d'afichar quatre simbòls possedent cadun un exponent.
Lo primièr paramètre, lo de la valor d'afichar, es mes en forma amb l'ajuda de la foncion {{formatnum:}}. Atencion : cal utilizar la notacion anglofòna dels nombres dins lo paramètre transmés al modèl, lo qual serà afichat segon las convencions occitanofònas. La virgula aficha un espaci, lo punt aficha una virgula.
Exemples : {{NaU|2,3|%}} aficha 2,3 %, dintrar {{NaU|2.3|%}} per afichar 2,3 %, {{NaU|1002.3}} o {{NaU|1,002.3}} per afichar 1 002,3 etc...
Exemples d'utilizacion[Modificar lo còdi]
| Sintaxi | Resultat | Comentari |
|---|---|---|
| {{Unitat|10000|km}} | 10 000 km | Cas d'utilizacion minimala : una valor seguida d'un simbòl |
| {{Unitat|10000|km/h}} | 10 000 km/h | Cas similar al precedent : lo resultat aficha un espaci insecable entre la valor e son unitat |
| {{Unitat|10000|quilomètres per ora}} | 10 000 quilomètres per ora | Es possible d'escriure l'unitat amb totas las letras ; dins aqueste cas l'usatge d'un espaci insecable entre la valor e l'unitat es pas estrictament necessari çaquelà |
| {{Unitat|10000|km|2}} | 10 000 km2 | Adjoncion d'un exponent al simbòl d'unitat |
| {{Unitat|10000|km||h|-1}} | 10 000 km⋅h-1 | Dos simbòls successius, lo primièr sens exponent |
| {{Unitat|10000|J|2|K|3|s|-1}} | 10 000 J2⋅K3⋅s-1 | Tres simbòls amb d'exponents especifics |
| {{Unitat|10000|J||kg||m|-2}} | 10 000 J⋅kg⋅m-2 | Tres simbòls, los dos primièrs sens exponent |
| {{Unitat|-40.234|°C}} | −40,234 °C | Cas metent en evidéncia l'utilizacion de la notacion anglofòna dins lo primièr paramètre, lo qual es afichat segon las convencions francofònas |
| {{Unitat|1.23456{{x10|9}}|J|2|K|3|s|-1}} | 1,23456× 109 J2⋅K3⋅s-1 | Tres simbòls amb d'exponents especifics, metent en evidéncia l'utilizacion de la notacion anglofòna e l'usatge de poténcias de 10 (usatge scientific) dins lo primièr paramètre |
| {{Unitat|1|[[quilomètre|km]]|2}} | 1 km2 | Tanben es possible de plaçar un ligam vèrs las unitats, mas lo modèl i pèrd de son eficacitat |
Limitacions e « efièches de bòrd »[Modificar lo còdi]
- Utilizat amb un sol paramètre, {{Nombre amb unitat}} dona lo meteis resultat que {{formatnum}}. Se desconselha d'utilizar {{Nombre amb unitat}} per aqueste usatge.
- Lo simbòl gra (°) sembla d'èsser considerat coma un caractèr « secable » per MediaWiki. Aquò es pas tractat per aqueste modèl.
Vejatz tanben[Modificar lo còdi]
|
Aqueste modèl emplega qualques foncionalitats complèxas de la sintaxi de las ParserFunctions.
Ensagetz pas de lo modificar, a mens que siatz segur de plan comprene sa concepcion e que siatz preparat a reparar totes los damatges collaterals se los resultats son inesperats. Tota experimentacion se deuriá conduire d’en primièr via una còpia sul Modèl nauc de sabla o dins vòstre espaci d'utilizaire. Clicatz aicí per purgar lo cache quand vòstras modificacions apareisson pas. |