Plantilla:Metacaixa d'avís sistema

De Viquipèdia
Dreceres ràpides: navegació, cerca
Icona de documentació de mòdul Documentació de la plantilla[mostra] [modifica] [historial] [refresca]

Aquesta és una plantilla que serveix de model uniformitzador per les caixes d'avís del sistema, com missatges generats a l'espai Mediawiki, capçaleres i peu de pàgines especials, de la caixa d'edició, etc.

El funcionament és similar a la família de metacaixes d'avís amb paràmetres similars. La diferència principal és que ocupa el 100% de l'amplada i té uns estils de colors diferents.

Aquesta plantilla utilitza les classes CSS definides a MediaWiki:Common.css com a "fmbox" (en anglès foot & header message box). Aquestes fulles d'estil es poden personalitzar.

Ús

Exemple simple:

{{Metacaixa d'avís sistema| text = Text del missatge.}}


Exemple complex:

{{Metacaixa d'avís sistema
| tipus     = informació
| imatge    = [[Fitxer:Emblem-question-yellow.svg|40px]]
| estil     = border: 1px solid #f4c430;
| estiltext = color: red; font-weight: bold; font-style: italic;
| text      = Text del cos del missatge.
}}

Tipus de caixes d'avís

Els següents exemples utilitzen els diferents valors del paràmetre tipus, amb la imatge per defecte de cada tipus.

Imatges

Les imatges per defecte mostrades més amunt generalment són de mostra. En molts casos serà més apropiat utilitzar imatges més específiques o bé cap. Els següents exemples utilitzen el paràmetre imatge:

Paràmetres

Llista de tots els paràmetres:

{{Metacaixa d'avís sistema
| tipus  = sistema / informació / avís
| imatge = cap / [[Fitxer:Nom de la imatge.svg|40px|enllaç=]]
| imatgedreta = [[Fitxer:Nom de la imatge.svg|40px|enllaç=]]
| id = id CSS
| class = clase CSS
| estil = valors CSS
| estiltext = valors CSS
| text  = Text del cos del missatge. 
}}

tipus

Si no es proporciona el paràmetre tipus, el valor per defecte és el sistema amb un fons clar.

imatge

No especificat = Si no es proporciona el paràmetre imatge la plantilla usa una imatge per defecte diferent per cada valor del paràmetre tipus.
Una imatge = Ha de ser una imatge amb el codi wiki habitual. L'amplada hauria de ser de 40 o màxim 50 px depenent de les proporcions d'amplada i alçada. És recomanable utilitzar el paràmetre enllaç=(buit) per evitar clicar sobre una icona. Exemple:
imatge = [[Fitxer:Unbalanced scales.svg|40px|enllaç=]]
cap = No es mostra cap imatge.

imatgedreta

No especificat = No es mostra cap imatge a la dreta de la caixa.
Una imatge = Ha de ser una imatge amb el codi wiki habitual. L'amplada hauria de ser de 40 o màxim 50 px depenent de les proporcions d'amplada i alçada. És recomanable utilitzar el paràmetre enllaç=(buit) per evitar clicar sobre una icona. Exemple:
imatgedreta = [[Imatge:Nuvola apps bookcase.png|40px|enllaç=]]
Altres = Qualsevol altre objecte que vulgueu mostrar a la dreta de la caixa.

id

L'id CSS opcional és utilitzat per a tota la taula de la caixa d'avís. És sense cometes " ". Principalment és per marcar una caixa d'avís amb el seu nom i fer més fàcil detectar la seva presència amb javascript. Per exemple a MediaWiki:Sp-contributions-footer es podria utilitzar:
id = sp-contributions-footer

class

Clase CSS opcional utilitzada per a tota la taula de la caixa d'avís. És sense cometes " ". Principalment és per marcar una caixa d'avís amb el seu nom i adaptar-la individualment. Per exemple a MediaWiki:Sp-contributions-footer es podria utilitzar:
class = sp-contributions-footer

estil

Valors opcionals CSS per a l'estil de la caixa, sense les cometes " " però amb el punt i coma final ;. Per exemple:
estil = margin-bottom: 0.5em;

estiltext

Valors opcionals CSS per a la cel·la de text. Per exemple:
estiltext = text-align: center;

estilimatge

Valors opcionals CSS per a la cel·la de la imatge de l'esquerra. Per exemple:
estilimatge = font-size: 90%; text-align: left;

text

El text del cos del missatge.

Detalls tècnics

Si necessiteu usar caràcters especials en el paràmetre text els podeu incloure de la següent forma:

{{Metacaixa d'avís sistema
| text  = <div>
El signe igual = i les claus simples d'obertura i tancament { } es poden usar directament. 
Però aquí teniu una barra vertical {{!}} i dues claus de tancament <nowiki>}}</nowiki>. 
I ara una barra vertical seguida de dues claus de tancament <nowiki>|}}</nowiki>.
</div>
}}

Aquesta plantilla usa classes CSS definides a MediaWiki:Common.css, per tant és configurable.

Aquesta plantilla defineix internament la taula amb codi HTML en lloc de codi wiki. És la forma habitual en les metaplantilles ja que el codi wiki té alguns inconvenients com, per exemple, la dificultat en l'us de funcions parser i caràcters especials en els paràmetres.

El MediaWiki no processa i converteix HTML en missatges del sistema de la mateixa forma que ho fa en pàgines normal. Això significa per exemple que <br> no es converteix automàticament a <br /> i les etiquetes no tancades </td> i </tr> no s'afegeixen automàticament. Per tant, vigileu que qualsevol codi HTML que utilitzeu en missatges del sistema sigui XHTML vàlid. És a dir, tanqueu totes les etiquetes obertes. Tanmateix, el codi wiki normal funciona en la majoria de missatges del sistema.

Vegeu també