Ajuda:Plantilla

Aquesta pàgina és la traducció corresponent de m:Help:Template (en anglès). Si cal fer modificacions, considereu abans fer-les en la pàgina original, ja que es podrien perdre en una propera actualització.

Les plantilles són pàgines que pertanyen a l'espai de noms Plantilla: (també en anglès Template:, nom vàlid a tots els projectes) i es fan servir per a incloure el seu contingut als articles. En realitat, qualsevol pàgina de la Viquipèdia es pot utilitzar com a plantilla, però és molt recomanable crear-les en Plantilla: per a una bona separació dels tipus de pàgines (articles, discussions, ajuda, viquipèdia, plantilles).

Si voleu emprar una plantilla que està desada amb el nom:

Plantilla:nom-de-la-plantilla

Per a incloure una plantilla dins d'un article heu d'escriure

{{nom-de-la-plantilla}}

sense necessitat d'escriure Plantilla: davant el nom. En general aquest és l'ús més habitual de les plantilles i el recomanat, ja que l'espai d'edició en edicions posteriors resulta més diàfan. Un cop desats els canvis qualsevol canvi en la plantilla es reflectirà en el canvi de la pàgina.

Hi ha casos especials d'ús de la plantilla. Si es tracta de que es visualitzin tots els continguts d'altres pàgines, heu d'escriure el nom complet, i els dos punts per als articles. Per exemple:

{{Viquipèdia:Mapa}} - Inclou el contingut de Viquipèdia:Mapa

{{:Portada}} - Inclou el contingut de la Portada

En tots estos casos, el codi del vostre article conté solament la referència a la plantilla. Si el que voleu és copiar el contingut de la plantilla dins l'article per a editar-lo, heu d'escriure

{{subst:nom-de-la-plantilla}}

Si ja sabeu com utilitzar les plantilles i voleu vore les que teniu a la vostra disposició en aquesta Viquipèdia, visiteu Categoria:Plantilles i Viquipèdia:Plantilles.

Els paràmetres permeten afegir dades a la plantilla i així una plantilla es pot (i en algunes s'ha de) "personalitzar" per a cada article on vagi inserida. La manera en que cada plantilla afegeix els paràmetres és una qüestió de sintaxi del contingut de la pàgina de la plantilla.

Per a incloure plantilles amb paràmetres en pàgines de la Viquipèdia segueix el següent esquema general:

{{nom-de-la-plantilla|paràmetre-1|paràmetre-2|...}}

Fixeu-vos que per separar paràmetres es fa servir el símbol | que podeu trobar sota de l'espai d'edició quan esteu editant articles.

Amb un exemple s'entén millor: La Plantilla:Polisèmia, accepta un paràmetre. Com s'ha vist abans per a fer aparèixer la plantilla polisèmia afegim el següent text a l'article {{Polisèmia}}. Per afegir el terme polisèmic afegirem el paràmetre (en aquest cas el títol de l'article destí). Si copieu aquest text en un article {{Polisèmia|Paràmetre}} apareixerà de la següent manera.

Per a altres significats, vegeu «Paràmetre».

El terme “paràmetre” apareix en la plantilla.

Podeu conèixer quins tipus de paràmetres accepta una plantilla i quines funcions genera cada paràmetre i com incloure-les visitant la seva pàgina de descripció (en el cas de l'exemple Plantilla:Polisèmia). Hi ha plantilles que requereixen obligatòriament la inclusió d'algun tipus de paràmetre, n'hi ha en que no és obligatori i fins i tot n'hi ha que no en tenen definits.

Sovint les plantilles utilitzen noms per a identificar els paràmetres, a diferència de l'anterior en que el paràmetre està identificat per l'ordre que ocupa segons la seqüència del símbol |.

Així:

{{nom-de-la-plantilla|nom-del-paràmetre-a=paràmetre-a|nom-del-paràmetre-b=paràmetre-b|...}}

Seria el mateix que:

{{nom-de-la-plantilla|nom-del-paràmetre-b=paràmetre-b|nom-del-paràmetre-a=paràmetre-a|...}}

Les plantilles es creen i editen igual que els articles, amb la particularitat que el nom ha de començar amb Plantilla:. Actualment es disposa d'un bon nombre de plantilles, abans d'iniciar una plantilla nova verifiqueu que no existeixi ja alguna amb la mateixa funció. Es recomana triar un nom curt però amb sentit, perquè es puga recordar fàcilment. Les plantilles es categoritzen en alguna de les categories dins de Categoria:Plantilles. Si la sintaxi de la plantilla és complexa, com en el cas de les infotaules es recomana incloure una descripció del seu ús afegint després del codi de la plantilla, al final de la sintaxi de la pàgina, la següent expressió:

<noinclude>{{ús de la plantilla}}</noinclude>

Deseu la plantilla. Un cop desada apareixerà un marcador addicional que us ha de permetre crear una subpàgina associada a la pàgina de la plantilla creada. En aquesta subpàgina podeu afegir la informació d'ús de la plantilla, així com una explicació dels usos previstos per a la plantilla, altres plantilles i pàgines de l'espai Viquipèdia que s'hi relacionen, les categories i els interviquis. Aquesta pàgina va associada amb la pàgina principal de la plantilla, de manera que si algun cop es decideix reanomenar la pàgina principal aquesta també es reanomenarà i no es perdrà. Aquesta dissociació permet editar la informació d'ús de la plantilla sense haver d'editar la plantilla separant les edicions sobre el codi propi del funcionament de la plantilla amb les edicions relatives a les instruccions d'ús.

Per un exemple vegeu: Plantilla:Indret i Plantilla:Indret/ús

Dins la pàgina de descripció de la plantilla, cada paràmetre s'inclou escrivint el seu número entre claus triples:

{{{1}}} - és el primer paràmetre

{{{2}}}, {{{3}}}, ... - la resta de paràmetres.

Les etiquetes <noinclude> i <includeonly> serveixen per determinar quina part de la plantilla no serà inclosa quan es faci servir en un article (noinclude) o mostrada només quan la plantilla sigui inclosa (includeonly).

Són molt útils perquè permeten tractar les plantilles com la resta d'articles:

• noinclude permet:
  • Categoritzar la plantilla.
  • Fer-hi enllaços interwiki
  • Afegir-hi instruccions d'ús
• includeonly permet:
  • Afegir tots els articles que incloguin la plantilla a una categoria, però sense afegir la plantilla a aquesta categoria.

Sense aquestes etiquetes tots el continguts de la plantilla serien inclosos a l'article que la referenciés.

Exemple d'ús:

<includeonly>El nom de la ''cosa'' és: '''{{{nom}}}'''[[Categoria:Coses]]</includeonly><noinclude>

==Instruccions d'ús de la plantilla "nom de la cosa"==

{{nom_de_la_cosa |
nom = 
|}}

[[Categoria:Exemples]]</noinclude>

En aquest exemple les instruccions d'ús no seran incloses a l'article que faci servir aquesta plantilla, i aquest article no s'inclourà en la categoria "Exemples" gràcies a les etiquetes <noinclude>.

L'article que faci servir aquesta plantilla s'inclourà a la categoria "Coses", però no la mateixa plantilla. A més, quan algú llegeixi la pàgina de la plantilla no li serà mostrat el codi que fa que la plantilla funcioni, haurà d'editar-la per veure-ho, donat que està dins de les etiquetes <includeonly>.

Atenció: qualsevol espai o salt de línia entre el codi de la plantilla i l'etiqueta <noinclude> s'inclourà en els articles que la facin servir! Per tant és recomanable arrapar aquesta etiqueta al codi funcional.

• Ajuda:Plantilles, a Mediawiki
• Ajuda:Infotaules
• Plantilla:Caixa de navegació, com ajuda per a elaborar plantilles de navegació.
• Viquipèdia:Documentació de plantilles.
• Viquipèdia:Infotaules
• Plantilla:Infotaula, plantilla per a generar infotaules de forma fàcil.