Modèl:BUtilizaire/Documentacion

Un article de Wikipèdia, l'enciclopèdia liura.

Modèl | Documentacion | Discussion Aqueste Meta-modèl permet de generir aisidament de boitas d'utilizaire estandardizadas. Aqueste modèl emplega qualques foncionalitats extrèmament complicadas e esotericas de la sintaxi dels ParserFunctions. Ensagetz pas de l’alterar a mens que siatz certan/a de plan comprene sa concepcion e que siatz preparat/ada a reparar totes los damatges collaterals se los resultats son inesperats. Tot experiment se deuriá menar d’en primièr via una còpia sul Modèl nauc de sabla o dins vòstre espaci d’utilizaire.

Somari 1 Constantas 2 Modèls corrents de recopiar 3 Sintaxi 4 Valors detalhadas dels paramètres 5 Taula de las colors 6 Exemples

[Modificar] Constantas

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

[Modificar] Modèls corrents de recopiar

{{BUtilizaire|
  color=|
  img=|
  títol=|
  tèxt=|
  categoria=Utilizaire xxx|
  nocat={{{nocat|}}}|
}}

{{BUtilizaire|
  color=|
  img=|
  img-títol=|
  tèxt=|
}}

{{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èxt=|
  img-tèxt-color=|
  img-tèxt-talha=|
  títol=|
  tèxt=|
}}

{{BUtilizaire|
  color=|
  img=|
  títol=|
  tèxt=|
  tèxt2=|
}}

[Modificar] Sintaxi

{{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 - se 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 boita pòt comportar pas de títol en gras  -->
  tèxt-talha=8pt|            <!-- facultatiu - per defaut, 8pt (augmentar per arabi e chinés) -->
  tèxt=Jògi al [[poker]].| <!-- facultatiu mas fòrtament conselhat - se absent, pas de tèxt -->
}}

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

Se la boita 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 - se 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 boita 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 - se 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 boita 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 - se 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èxt=Abrev|          <!-- facultatiu - se absent, pas de tèxt dins la partida esquèrra -->
  img-tèxt-color=#000000| <!-- facultatiu - per defaut, #000000 (negre) -->
  img-tèxt-talha=14pt|     <!-- facultatiu - per defaut, 14pt -->

Se òm vòl ajustar un segond tèxt separat per un filet orizontal (per exemple una revirada 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èxt2=I play [[poker]].|  <!-- facultatiu - se absent, pas de second tèxt separat per un filet -->
  tèxt2-talha=8pt|         <!-- facultatiu - per defaut, 8pt (augmentar per arabi o chinés) -->

Se la boita 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 boita 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 boita 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 boita 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'ancian noms de categorias, lo prefix "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'inclouriá aqueste modèl. En principi, se deu l'emplegar pas que dins una sospagina "Utilizaire:xxx/xxx" (archiu, ensages…) per polluir pas las categorias d'utilizaires. (De sosmodèls de Boitas Utilizaire sufixats per "/nocat" pòdon èsser creats per indicar aqueste paramètre en mai del modèl normal de boita utilizaire qu'inclutz pas aqueste paramètre).

[Modificar] Valors detalhadas dels paramètres

La boita globala posicionada dins la pagina :

• bordadura : facultatiu (defaut=#999999, gris escur) la color de bordadura de la boita, exemple : "black" o "#0000FF"
• arredondit : facultatiu (defaut=0) Los angles pòdon aparéisser arredondits se lo navigaire o permet

1. Mozilla : visible
2. Internet explorer : non visible

Valor conselhada : 0.6em. S'exprima en pt, px o em

• align : facultatiu, (defaut=left) ; Alinhament de flotason de la boita, unicament dins lo cas d'una utilizacion dirèctament dins una pagina personala, mas pas dins un modèl de boita comuna. Las valors possiblas son left, center, right, o none (boita 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 bandas blancas al long d'un bòrd, es util d'especificar la color en #EEEEEE que permet de remarcar la banda 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 exprimit en pixels, exemple : "30px"; pels imatges en paisatges (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 depasse pas 45px (çò que conserva la talha de las boitas 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=mc²"
  • 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 boita, exemple : "#906090" o "#ccc"
• tèxt-color : facultatiu (defaut=#000000, negre) la color dels tèxtes e del títol dins la boita, exemple : "yellow" o "#0CCCC"

  Normalament la color de boita 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 color precisa una tinta escura). Vejatz la carta grafica de las boitas

• 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 boita ; 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 lo mai corrent)
  • títol-talha : facultatiu (defaut=tèxt-talha se definit, siquenon 8pt; augmentar 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 boita, en seguida del títol
  • tèxt-talha : facultatiu (defaut=8pt, augmentar a 13pt per l'arabi o lo chinés)
• Un second 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; augmentar 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 boita ele-meteis sens lo prefix "Modèl:".
• siá vèrs una categoria d'utilizaires d'aquesta boita qu'i seràn automaticament categorizats :
  • categoria : facultatiu, indica lo nom de la categoria dels utilizaires d'aquesta boita, sens lo prefix "Categoria:". Notatz que solas las paginas de l'espaci "Utilizaire:" i seràn categorizadas. Se pòt utilizar la meteissa boita endacòm mai dins de discussions o dins "Wikipèdia:" sens que aquestas discussions sián categorizadas demest los utilizaires de la boita. 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 boita son totes categorizats se lo paramètre categoria es present . La valor recomandada es nocat={{nocat|}}}| çò que permet de crear un segond modèl de boita utilizaire nomenat amb lo sufix "/nocat" e apelant lo primièr modèl de boita 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 boita i serà pas listat. A l'utilizacion del modèl, es pas necessari de crear un modèl "/nocat" just per inclòure la boita dins una pagina de discussion (lo seul interès de crear un segond modèl nomenat "Modèl:Utilizaire xxx/nocat" es de far aparéisser la boita d'utilizaire "{{Utilizaire xxx|nocat=o}}" per poder l'utilizar dins "{{Boita Utilizaire| xxx/nocat | ...}}}" o dins "{{Boita 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 boita sus lor pagina personala, son categorizats demest los utilizaires de la boita).
• Per afichar cap ligam, sufís de pas rensenhar dins la boita ni lo paramètre ligam, ni lo paramètre categoria.

[Modificar] Taula de las colors

[Modificar] Exemples

Code	Resultat
{{BUtilizaire| img=Wiki.png| 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 Mon enciclopèdia liura e gratuita es 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 Crèsi al Paire Nadal.
{{BUtilizaire| img=Blason_Languedoc.svg| img-títol=Armas Lengadòc| img-talha=21px| imgd=Swiss-coat of arms.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=BlasonChampagneArdennes.PNG| 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.| }}	Quatre imatges Se pòt plaçar fins a quatre imatges dins la partida drecha.
{{BUtilizaire| tèxt=Aqueste utilizaire s’interèssa pas a res.| }}	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>'''.| }}	e= mc² Aquesta utilizaire es un gèni.
{{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| }}	en-0 ∇ Aqueste utilizaire compren pas res a l’anglés,o vòl pas parlar aquesta lenga. This user does not speak English, or does not want to speak English.