Plantilla:Metacaixa d'avís sistema/ús
Aquesta és una subpàgina de documentació per a la Plantilla:Metacaixa d'avís sistema Té la informació d'ús, les categories, els enllaços interwiki i qualsevol altre contingut que no forma part essencial del codi de la plantilla. |
Descripció
[modifica]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
[modifica]Exemple simple:
{{Metacaixa d'avís sistema| text = Text del missatge.}}
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. }}
Text del cos del missatge. |
Tipus de caixes d'avís
[modifica]Els següents exemples utilitzen els diferents valors del paràmetre tipus, amb la imatge per defecte de cada tipus.
tipus=avís – Per a missatges d'avís del sistema. |
tipus=informació – Fons transparent per a missatges d'informació, per exemple en la pàgina d'edició. |
tipus=sistema – Format per defecte per a missatges dels sistema amb fons clar. |
Imatges
[modifica]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
:
imatge = [[Fitxer:User-info.svg|40px]] |
imatge = [[Fitxer:Commons-logo.svg|40x40px]] |
imatge = cap – No hi ha cap imatge i el text utilitza tota l'amplada de la caixa. |
imatge = [[Fitxer:User-info.svg|40px]] imatgedreta = [[Fitxer:Nuvola apps bookcase.svg|40px]] |
Paràmetres
[modifica]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
[modifica]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> }}
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 }}. I ara una barra vertical seguida de dues claus de tancament |}}. |
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é
[modifica]- Plantilla:Metacaixa d'avís, per a caixes d'avís genèriques amb diferents formats segons l'espai de noms.
- Plantilla:Metacaixa d'avís sistema, 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.
- Plantilla:Metacaixa d'avís article, per a caixes d'avís en l'espai principal d'articles.
- Plantilla:Metacaixa d'avís projecte, aquesta és una plantilla que serveix de model uniformitzador per les caixes d'avís en pàgines del projecte, com "Viquipèdia:", "Ajuda:", etc.
- Plantilla:Metacaixa d'avís categoria, per a caixes d'avís en l'espai de categories.
- Plantilla:Metacaixa d'avís discussió, per a caixes d'avís en pàgines de discussió.