Modèl:BUtilizaire/Documentacion

Modèl | Documentacion | Discussion

Aqueste metamodèl permet de generar aisidament de bóstias d'utilizaire estandardizadas.

Comentari 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.

Constantas

modificar
  • largor de la bóstia : 238px
  • largor de l'emplaçament de l'icòna : 45px
  • imatges e tèxtes son centrats dins lors cellulas

Modèls corrents de recopiar

modificar
Modèl de basa
amb imatge, títol
e ligam de categoria
Modèl simple
sens títol en naut
ni ligam de categoria
Modèl amb imatge-doble Modèl amb icòna tèxt Modèl amb tèxt-doble
{{BUtilizaire|
  color=|
  img=|
  títol=|
  tèxte=|
  categoria=Utilizaire xxx|
  nocat={{{nocat|}}}|
}}
{{BUtilizaire|
  color=|
  img=|
  img-títol=|
  tèxte=|
}}
{{BUtilizaire|
  color=|
  img-color=|
  img=|
  img-talha=|
  img-títol=|
  img2=|
  img2-talha=|
  img2-títol=|
  títol=|
  tèxt=|
}}
{{BUtilizaire|
  color=|
  img-color=|
  img-tèxte=|
  img-tèxte-color=|
  img-tèxte-talha=|
  títol=|
  tèxte=|
}}
{{BUtilizaire|
  color=|
  img=|
  títol=|
  tèxte=|
  tèxte2=|
}}
{{BUtilizaire|
  bordadura=#999999|             <!-- facultatiu - per defaut, #999999 (gris) -->
  color=#EEEEEE|             <!-- facultatiu - per defaut, #EEEEEE (gris clar) -->
  tèxt-color=#000000|       <!-- facultatiu - per defaut, #000000 (negre) -->
  img-color=#FFFFFF|         <!-- facultatiu - per defaut, #FFFFFF (blanc) -->
  img=icòna.svg|               <!-- facultatiu mas fòrtament conselhat - s'es absent, pas d'imatge -->
  img-talha=45px|             <!-- facultatiu - per defaut, 45px -->
  img-títol=Títol Icòna|       <!-- facultatiu mas conselhat - per defaut, {{{img}}} -->
  títol-talha=8pt|            <!-- facultatiu - per defaut, 8pt -->
  títol=Poker|                 <!-- facultatiu - la bóstia pòt comportar pas de títol en gras  -->
  tèxte-talha=8pt|            <!-- facultatiu - per defaut, 8pt (aumentar per arabi e chinés) -->
  tèxte=Jògi al [[poker]].| <!-- facultatiu mas fòrtament conselhat - s'es absent, pas de tèxt -->
}}

Nòta : lo títol parteja la meteissa color que lo tèxt.

Se la bóstia deu conténer dos imatges, un al costat de l'autre, cal rensenhar tres autres paramètres per l'imatge de drecha :

  imgd=icòna2.svg|           <!-- facultatiu - s'es absent, pas d'imatge -->
  imgd-talha=45px|          <!-- facultatiu - per defaut, 45px -->
  imgd-títol=Títol Icòna 2|  <!-- facultatiu mas conselhat - per defaut, {{{imgd}}} -->

Se la bóstia deu conténer dos imatges, un al dessús de l'autre, cal rensenhar tres autres paramètres per la segonda linha :

  img2=lògo.svg|             <!-- facultatiu - s'es absent, pas d'imatge -->
  img2-talha=45px|          <!-- facultatiu - per defaut, 45px -->
  img2-títol=Títol Lògo|     <!-- facultatiu mas conselhat - per defaut, {{{img2}}} -->

La bóstia pòt conténer fins a quatre imatges, img e imgd en primièra linha, img2 e impd2 en segonda linha :

  imgd2=lògo2.svg|           <!-- facultatiu - s'es absent, pas d'imatge -->
  imgd2-talha=45px|         <!-- facultatiu - per defaut, 45px -->
  imgd2-títol=Títol Lògo 2|  <!-- facultatiu mas conselhat - per defaut, {{{imgd2}}} -->

En plaça dels 1 a 4 imatges, se pòt metre un tèxt :

  img-tèxte=Abrev|          <!-- facultatiu - s'es absent, pas de tèxt dins la partida esquèrra -->
  img-tèxte-color=#000000| <!-- facultatiu - per defaut, #000000 (negre) -->
  img-tèxte-talha=14pt|     <!-- facultatiu - per defaut, 14pt -->

Se l'òm vòl ajustar un segond tèxt separat per un filet orizontal (per exemple una traduccion dins una autra lenga), se pòt rensenhar (aqueste segond tèxt utiliza las meteissas colors que lo primièr tèxt e lo títol mas pòt avèr una talha diferenta) :

  tèxte2=I play [[poker]].|  <!-- facultatiu - s'es absent, pas de segond tèxt separat per un filet -->
  tèxte2-talha=8pt|         <!-- facultatiu - per defaut, 8pt (aumentar per arabi o chinés) -->

Se la bóstia deu conténer un ligam de tipe Paginas ligadas, cal rensenhar un paramètre suplementari (aquò aficha un triangle vèrs una pagina especiala listant totas las paginas ligadas al modèl) :

  ligam=Poker| <!-- Fin del nom de la bóstia d'utilizaire (aicí pel Modèl:Utilizaire Poker) -->

Çaquelà, s'existís una categoria correspondenta per las paginas d'utilizaires, s'utilizarà puslèu :

  categoria=Utilizaire Poker| <!-- facultatiu - en principi lo meteis nom que la bóstia d'utilizaire (aicí pel Modèl:Utilizaire Poker) -->
  categoria2=Utilizaire Taròt| <!-- facultatiu - per una segonda categoria (aicí pel Modèl:Utilizaire Taròt) -->
  nocat={{{nocat|}}}|          <!-- facultatiu - per defaut, void -->

Amb aqueste paramètre, los utilizaires qu'inserisson aquesta bóstia dins lor pagina personala an lor pagina personala automaticament categorizada. Nòta : se deu indicar lo nom complet de la categoria, perque per de rasons de compatibilitat amb d'ancians noms de categorias, lo prefixe "Categoria:Utilizaire xxx" es pas totjorn present.
Lo paramètre opcional nocat, s'es non void (per exemple nocat=o), evita de categorizar automaticament una pagina "Utilizaire:xxx" qu'incluriá aqueste modèl. En principi, se deu emplegar pas que dins una sospagina "Utilizaire:xxx/xxx" (archiu, ensages…) per polluir pas las categorias d'utilizaires. (De sosmodèls de Bóstias d'utilizaire sufixats per "/nocat" se pòdon crear per indicar aqueste paramètre en mai del modèl normal de bóstia d'utilizaire qu'inclutz pas aqueste paramètre).

Valors detalhadas dels paramètres

modificar

La bóstia globala posicionada dins la pagina :

  • bordadura : facultatiu (defaut=#999999, gris escur) la color de bordadura de la bóstia, exemple : "black" o "#0000FF"
  • arredondit : facultatiu (defaut=0) Los angles pòdon aparéisser arredondits se lo navegador o permet
  1. Mozilla : visible
  2. Internet explorer : non visible

Valor conselhada : 0.6em. S'exprimís en pt, px o em

  • align : facultatiu, (defaut=left) ; Alinhament de flotason de la bóstia, unicament dins lo cas d'una utilizacion dirèctament dins una pagina personala, mas pas dins un modèl de bóstia comuna. Las valors possiblas son left, center, right, o none (bóstia non flotanta).

Partida d'esquèrra : generalament l'imatge :

  • img-color : facultatiu (defaut=#FFFFFF, blanc) la color de fons de l'imatge o dels imatges, exemple : "#906090" o "#ccc"; per las bandièras de bendas blancas al long d'un bòrd, es util d'especificar la color en #EEEEEE que permet de remarcar la benda blanca de la bandièra e mesurar sas proporcions (per exemple, amb la bandièra de Monegue o d'Argeria).
  • primièr imatge (opcional) :
    • img : facultatiu (defaut=pas d'imatge) lo nom de l'imatge, per exemple "Flag of France.svg"
    • img-talha : facultatiu (defaut=45px) la largor de l'imatge exprimida en pixèls, exemple : "30px"; pels imatges en païsatges (bandièras, la màger part de las fòtos), inutil d'especificar lo paramètre que servís sustot per redusir la largor per defaut per que la nautor despasse pas 45px (çò que consèrva la talha de las bóstias e permet de las alinhar)
    • img-títol : facultatiu (defaut=valor del paramètre títol se desfinís çaijos, siquenon nom de l'imatge) exemple : "Bandièra de França"
  • segond imatge, a drecha del primièr imatge (opcional) :
    • imgd : facultatiu (defaut=pas d'imatge)
    • imgd-talha : facultatiu (defaut=45px)
    • imgd-títol : facultatiu (defaut=nom de l'imatge)
  • primièr imatge, en segonda linha, doncas jos lo primièr imatge (opcional) :
    • img2 : facultatiu (defaut=pas d'imatge)
    • img2-talha : facultatiu (defaut=45px)
    • img2-títol : facultatiu (defaut=nom de l'imatge)
  • segond imatge, en segonda linha, a drecha del primièr imatge en segonda linha (opcional) :
    • imgd2 : facultatiu (defaut=pas d'imatge)
    • imgd2-talha : facultatiu (defaut=45px)
    • imgd2-títol : facultatiu (defaut=nom de l'imatge)
  • o alara un tèxt (opcional) :
    • img-tèxt : facultatiu (defaut=pas de tèxt) lo tèxt remplaçant l'imatge, per exemple "E=mc2"
    • img-tèxt-color : facultatiu (defaut=#000) la color del tèxt/imatge, per exemple "red"
    • img-tèxt-talha : facultatiu (defaut=14pt) la talha del tèxt/imatge, per exemple "10pt"

Partida de drecha, lo tèxt afichat :

  • color : facultatiu (defaut=#DDDDDD, gris clar) la color de fons de la bóstia, exemple : "#906090" o "#ccc"
  • tèxt-color : facultatiu (defaut=#000000, negre) la color dels tèxtes e del títol dins la bóstia, exemple : "yellow" o "#0CCCC"
    Normalament la color de bóstia es clara (pastèl), e los tèxtes demòran dins la color per defaut en negre (inutil de precisar tèxt-color exceptat se lo paramètre de color precisa una tinta escura). Vejatz la carta grafica de las bóstias
  • Lo títol facultatiu (automaticament en gras e sus una linha separada en naut del tèxt)
    • títol : facultatiu (defaut=pas de títol) lo títol de la bóstia; serà afichat en gras seguit d'un saut de linha; s'es definit, servís tanben de títol per defaut pel primièr imatge (cas d'utilizacion mai corrent)
    • títol-talha : facultatiu (defaut=tèxt-talha se definit, siquenon 8pt; aumentar a 13pt per l'arabi o lo chinés)
  • Lo tèxt principal (afichat dirèctament dins un paragraf jol títol)
    • tèxt : obligatòri, mas sa valor pòt èsser voida, lo tèxt de la bóstia, en seguida del títol
    • tèxt-talha : facultatiu (defaut=8pt, aumentar a 13pt per l'arabi o lo chinés)
  • Un segond tèxt opcional (separat del títol e del primièr tèxt per un fileton orizontal de la color de la bordadura).
    • tèxt2 : facultatiu (defaut=pas de tèxt) un segond paragraf, per exemple pel tèxt dins una segonda lenga.
    • tèxt2-talha : facultatiu (defaut=tèxt-talha se definís, siquenon 8pt; aumentar a 13pt per l'arabi o lo chinés)

Partida opcionala : un ligam de navigacion en bas a drecha (un pichon triangle puntat vèrs lo bas). Se pòt afichar aqueste ligam de dos biaisses exclusius un de l'autre :

  • siá vèrs una pagina especiala "Special:Whatlinkshere" :
    • ligam : facultatiu, lo nom del modèl de bóstia el meteis sens lo prefixe "Modèl:".
  • siá vèrs una categoria d'utilizaires d'aquesta bóstia qu'i seràn automaticament categorizats :
    • categoria : facultatiu, indica lo nom de la categoria dels utilizaires d'aquesta bóstia, sens lo prefixe "Categoria:". Notatz que solas las paginas de l'espaci d'"Utilizaire:" i seràn categorizadas. Se pòt utilizar la meteissa bóstia endacòm mai dins de discussions o dins "Wikipèdia:" sens que aquestas discussions sián categorizadas demest los utilizaires de la bóstia. Nòta: se s'utiliza aqueste paramètre, lo paramètre "ligam=Utilizaire ...|" mencionant lo nom del modèl es ignorat e es lo ligam vèrs la categoria d'utilizaires qu'apareisserà.
    • nocat : facultatiu, per defaut los utilizaires de la bóstia son totes categorizats se lo paramètre de categoria es present. La valor recomandada es nocat={{nocat|}}}| çò que permet de crear un segond modèl de bóstia d'utilizaire nomenat amb lo sufixe "/nocat" e apelant lo primièr modèl de bóstia en precisant solament lo paramètre "nocat=o" (valor qual que siá non voida). Aqueste paramètre suprimís pas lo ligam afichat vèrs la categoria mas l'utilizaire de la bóstia i serà pas listat. A l'utilizacion del modèl, es pas necessari de crear un modèl "/nocat" just per inclure la bóstia dins una pagina de discussion (lo sol interès de crear un segond modèl nomenat "Modèl:Utilizaire xxx/nocat" es de far aparéisser la bóstia d'utilizaire "{{Utilizaire xxx|nocat=o}}" per poder l'utilizar dins "{{Bóstia d'utilizaire| xxx/nocat | ...}}}" o dins "{{Bóstia Babel| xxx/nocat | ...}}}" incluit dins lo còde d'una pagina "Utilizaire:Untal", ont se pòt pas precisar cap de paramètre amb lo nom, e la màger part dels utilizaires utilizaràn pas aquesta opcion : es a dire qu'a partir del moment qu'afichan publicament la bóstia sus lor pagina personala, son categorizats demest los utilizaires de la bóstia).
  • Per pas afichar cap de ligam, sufís de pas rensenhar dins la bóstia ni lo paramètre ligam, ni lo paramètre categoria.

Taula de las colors

modificar

Exemples

modificar
Code Resultat
{{BUtilizaire|
 img=Wikipedia-logo-v2-oc.svg|
 img-títol=Wikipèdia|
 color=#d0ffe0|
 títol=[[Wikipèdia]]|
 tèxt=Mon enciclopèdia liura e gratuita es '''[[Wikipèdia]]'''.|
 categoria=Wikipedians|
}}
Wikipèdia
{{BUtilizaire|
 img=SantaClaus.jpg|
 img-títol=Paire Nadal|
 color=#FF8080|
 títol=Paire Nadal|
 tèxt=Crèsi al '''[[Paire Nadal]]'''.|
 categoria=Utilizaire Paire Nadal|
}}
Paire Nadal
Paire Nadal
{{BUtilizaire|
 img=Blason_Languedoc.svg|
 img-títol=Armas Lengadòc|
 img-talha=21px|
 imgd=Coat of Arms of Switzerland.svg|
 imgd-títol=Blason Soïssa|
 imgd-talha=21px|
 img2=Blason_Nord-Pas-De-Calais.svg|
 img2-títol=Blason Nòrd-Pas-de-calais|
 img2-talha=21px|
 imgd2=|
 imgd2-títol=Blason Champanha-Ardenas|
 imgd2-talha=21px|
 color=#FFF0F5|
 títol=4 imatges|
 tèxt=Se pòt plaçar fins a quatre imatges dins la partida drecha.|
}}
Armas LengadòcBlason Soïssa
Blason Nòrd-Pas de Calais
Quatre imatges
{{BUtilizaire|
 tèxt=Aqueste utilizaire s’interèssa pas a res.|
}}
{{BUtilizaire|
 img-color=red|
 img-tèxt-color=yellow|
 img-tèxt-talha=12pt|
 img-tèxt='''e=<br />mc²'''|
 color=darkblue|
 tèxt-color=white|
 tèxt=Aquesta utilizaire es un '''<big><big>gèni</big></big>'''.|
}}
{{BUtilizaire|
 img-color=#FFBBBB|
 img-tèxt-talha=13pt|
 img-tèxt='''en-0'''|
 color=#FFEEEE|
 bordure=#FFBBBB|
 tèxt=Aqueste utilizaire '''[[:Categoria:Utilizaire en|compren pas res]]'''
a l’'''[[:Categoria:Utilizaire en|anglés]]''',
o vòl pas parlar aquesta lenga.|
 tèxt2=This user '''[[:Categoria:Utilizaire en|does not]]''' speak
'''[[:Categoria:Utilizaire en|English]]''', or does not want to speak English.|
 categoria=Utilizaire en-0|
}}