Les
plantilles
son una caracteristica potent del
MediaWiki
, pero es facil cometre errades, fins i tot per part d'usuaris experimentats. El canvis en plantilles complexes s'haurien de provar abans. Les plantilles incloses en moltes pagines solen estar protegides per evitar modificacions improductives que carreguin innecessariament els servidors i per evitar canvis no desitjats que afectin a moltes pagines.
Es recomanable provar abans l'efecte que pot tenir una modificacio en una plantilla que utilitzi
funcions parser
per generar diferents continguts segons el context, aixi com les que tinguin molts parametres o aquelles que tinguin diferents opcions amb l'operador
#switch
. En aquests casos caldria assegurar diferents
casos de prova
segons els diferents tipus de pagina on la plantilla pugui estar inclosa. Es una bona practica que la mateixa documentacio tingui els casos de prova i aixi es poden comprovar rapidament els efectes d'uns canvis.
Quan la plantilla genera sempre el mateix contingut, com per exemple en plantilles de navegacio, llavors la prova es pot reduir a una previsualitzacio de la mateixa plantilla, de la mateixa forma que es faria amb altres pagines de contingut.
Qualsevol plantilla que estigui transclosa en milers de pagines s'hauria de provar sempre abans de fer cap modificacio. En aquests casos es habitual que la plantilla estigui protegida per seguretat i caldra demanar les modificacions en la seva pagina de discussio (vegeu
{{
modificacio protegida
}}
). Per fer aquesta sol·licitud es una bona practica facilitar algun enllac sobre les proves fetes.
Segons la complexitat, hi ha diferents tipus de proves que es poden fer.
Expansio de plantilles
[
modifica
]
- Vegeu
mw: Extension:ExpandTemplates
En la pagina
Especial:Expansio de plantilles
es pot introduir un text wiki i mostra el resultat expandint les plantilles, funcions parser i variables. Es pot proporcionar un titol de pagina per substituir en les variables que l'utilitzin, pero no es poden proporcionar valors pels parametres de plantilla (p.ex.
{{{1}}}
).
La pagina especial expandeix el text wiki proporcionant el mateix resultat intermedi que es produeix abans de processar-lo en desar la pagina o previsualitzar-la. A mes de fer proves, pot ser d'ajuda per entendre i analitzar el text expandit activant l'arbre XML.
Per provar plantilles simples, es poden escriure en el text amb la seva sintaxi i amb els seus parametres,
- per exemple
{{numero mes|maig}}
o be copiant el contingut de la plantilla es pot provar el resultat fent-ne modificacions (
exemple
). Pot ser util per provar la sintaxi i la resposta de funcions parser en diferents condicions,
- per exemple
sintaxi #time i resultat per passat dema
o be el comportament de diferents casos #if, #ifeq, #switch, etc o la resposta de variables (
{{PAGENAME}}
, ...)
Previsualitzacio de pagines amb plantilles
[
modifica
]
En modificar una plantilla de contingut invariable segons context o parametres es pot previsualitzar el resultat com qualsevol altra pagina. En cas contrari, pot ser interessant previsualitzar una altra pagina que tingui inclosa la plantilla per veure com quedaria amb la plantilla modificada i encara no desada.
En la caixa d'edicio d'una pagina en l'espai de plantilles, sota del boto "Desa la pagina" hi ha una caixa addicional amb el titol "Previsualitzacio d'una pagina amb aquesta plantilla". Introduint el titol de la pagina la podreu previsualitzar tal com quedaria amb la plantilla modificada i encara no desada. Abans de la caixa d'edicio es previsualitzara la pagina indicada en lloc de la mateixa plantilla.
Es recomanable previsualitzar diferents pagines on la plantilla pugui tenir diferents comportaments per assegurar que el resultat es el desitjat en tots els casos i que no afecta a altres pagines amb resultats imprevistos. Si la mateixa plantilla esta documentada mostrant diferents casos de prova, pot servir previsualitzar la seva subpagina d'us "Plantilla:
Nom
/us". Tambe pot ser util comprovar l'enllac de la caixa d'eines "Que hi enllaca" i provar diferents pagines a l'atzar.
Espai personal de proves
[
modifica
]
Per previsualitzar modificacions en mes d'una plantilla, o per modificacions majors, es poden desar els canvis en una copia de la plantilla o plantilles en l'espai personal de proves. Igualment per crear una plantilla nova complexa pot ser util treballar-la primer en l'espai d'usuari. Pot servir qualsevol subpagina de la vostra pagina d'usuari. Per defecte esta definit com a subpagines de "Usuari:
Nom
/proves/".
Si la plantilla ja existeix i te la corresponent
documentacio
podeu veure que a peu de pagina apareix, entre altres enllacos d'ajuda: "Els editors poden fer proves amb aquesta plantilla al seu espai de proves". Clicant a l'enllac "crea" que hi ha continuacio es crea una copia de la plantilla al vostre espai de proves "Usuari:
Nom_d'usuari
/proves/Plantilla:
Nom_de_plantilla
". Si afegiu de nou
{{
us de la plantilla
}}
tindreu uns nous enllacos d'utilitat per a proves, entre altres:
Amb la pagina especial de proves de plantilles (TemplateSandbox) podeu generar la previsualitzacio d'una pagina tal com quedaria substituint les seves plantilles per les que tingueu en el vostre espai de proves. Poseu la pagina a previsualitzar en el camp "Pagina a generar:". Per previsualitzar versions anteriors de la pagina poseu el numero de revisio (parametre oldid= de l'enllac permanent) en el camp "Revisio a generar:". Per previsualitzar un text wiki poseu-lo en el camp "Text wiki a generar:" i ompliu tambe "Pagina a generar:" per contextualitzar variables com {{PAGENAME}}.