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

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

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 :

{{NaU}}, {{Unitat}}

Utilizacion

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

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 km²	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 J²⋅K³⋅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× 10⁹ J²⋅K³⋅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 km²	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 »

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

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.