Ajuda: plantilla

TIPUS DE PÀGINA
Element · Fil ( barra ) Categoria · Portal Fitxer ( imatge · so ) Pàgina de servei Plantilla · Pauta Projecte · Pàgina d'usuari Mòdul Tots els espais de noms

Abreviatures
WP: TL WP: Tl

A la Viquipèdia, una plantilla ^[1] és una pàgina especial creada per incloure-la en altres pàgines mitjançant el mecanisme d' inclusió .

Es pot utilitzar per a diversos propòsits:

inseriu fàcilment text repetit a diferents pàgines, escrivint-lo una vegada, com per a les plantilles de navegació
inseriu elements estàndard, taules d'informació o avisos
inserir elements el comportament dels quals es pugui programar segons algunes variables.

Les plantilles es troben a la plantilla d'espai de noms (o espai de noms 10), és a dir, l' espai de noms les pàgines del qual tenen la forma " Plantilla: NOM " (per exemple: Plantilla: S , Plantilla: Benvinguda , Plantilla: Europa ).

Per referir-vos a una plantilla també podeu utilitzar l'abreviatura T, per exemple. t: Europa .

- Taulell d'informació

Inserció

El mateix tema en detall: Ajuda: inclusió .

Exemple d'inclusió

Totes les pàgines que pertanyen a l'espai de noms 10 es poden inserir ràpidament en una pàgina, simplement escrivint el nom de la plantilla (la part següent del text Plantilla: text) entre claudàtors dobles ^[2] , com a {{ NAME }}. Aquesta referència al wikitext fa que s’insereixi el contingut de la plantilla quan es mostra la pàgina.

Si la pàgina "Plantilla: nom " no existeix, aleshores {{ nom }} funciona com a [[Plantilla: nom ]], un enllaç a una pàgina inexistent que condueix a la pàgina d'edició.

No està permès inserir plantilles inexistents.

Si la plantilla no es troba a l'espai de noms adequat (perquè encara s'està treballant o perquè és una inserció d'una altra pàgina) es pot utilitzar de totes maneres, introduint el nom amb el camí d'accés complet (per exemple, {{usuari: NOM) COGNOM / Pàgina de prova}}).

L'entrada majúscules i minúscules, és a dir, els distingeix de programari majúscules i lletres minúscules, amb l'excepció de la primera lletra i espais que són equivalents a subratllat ( "_"). Per tant:

la plantilla {{pàgina de prova}} i la plantilla {{pàgina de prova}} es reconeixeran com a diferents
les plantilles {{pàgina de prova}} i {{prova_pàgina}} seran idèntiques.

Podeu utilitzar la inclusió imbricada: una plantilla inclosa en una pàgina també pot contenir una o més plantilles.

En inserir plantilles, és possible declarar variables que s’utilitzaran dins de la plantilla : en aquest cas parlem d’una plantilla paramètrica .

Tirants

Per inserir els claudàtors dobles que obren i tanquen una plantilla, hi ha diverses maneres que depenen tant del disseny del teclat com del sistema operatiu . També podeu copiar i enganxar des d'aquí: {{}}

clip obert	clip tancat	sistema
`Alt` + `Gr` + `7`	`Alt` + `Gr` + `0`	GNU / Linux
`Alt` + `Gr` + `8`	`Alt` + `Gr` + `9`	GNU / Linux
`Alt` + `123`	`Alt` + `125`	Microsoft Windows
`Alt` + `Gr` + `⇧ Maj` + `és`	`Alt` + `Gr` + `⇧ Maj` + `+`	Microsoft Windows : GNU / Linux
`Alt` + `Ctrl` + `⇧ Maj` + `és`	`Alt` + `Ctrl` + `⇧ Maj` + `+`	Microsoft Windows
`⌥` + `⇧` + `és`	`⌥` + `⇧` + `+`	macOS (amb el disseny italià - Pro )

Nota : la clau ⇧ Maj , en alguns teclats també es pot anomenar "Maj". Sovint es troba just a sota de la clau ↵ Introduïu (o "Retorn").

Ús

Les plantilles són útils per a qualsevol element complex, especialment amb el format gràfic, que s’ha de repetir en dues o més pàgines sense haver d’escriure-ho cada vegada. Gràcies als paràmetres també és possible canviar-ne l’aspecte en funció de l’element, sempre sense haver d’escriure-ho tot cada vegada. Les plantilles no només són convenients, sinó que poden ajudar a aconseguir la coherència entre les pàgines.

Les aplicacions típiques són:

Alertes com {{ S }}
Plantilla de navegació com a Plantilla: Europa . Aquestes plantilles van a la part inferior de la pàgina, després dels enllaços externs i abans de la plantilla i les categories {{ portal }}.
Plantilles sinòptiques (també anomenades caixes d'informació ), que cada vegada mostren el mateix tipus d'informació amb el mateix format però diferenciades mitjançant els paràmetres, per exemple {{ Estat }}. Aquestes plantilles s’insereixen a la part superior dreta de l’element.

Usos desaconsellats

No es recomana duplicar contingut textual (tant amb plantilles com sense), per exemple posar una secció que tingui a veure amb A i B tant en el tema A com en el tema B. Això crea confusió, especialment per als col·laboradors novells. En aquests casos, és recomanable veure el text en un lloc i utilitzar enllaços wikil per connectar-lo des de diversos llocs.

Plantilles paramètriques

Quan es construeix una plantilla, pot ser que sigui necessari deixar a l'usuari la possibilitat de personalitzar part del text o del comportament de la plantilla, en funció de la pàgina on s'insereixi. En aquest cas, l'usuari indica un o més paràmetres que després s'utilitzaran per a la representació de vídeo de la pròpia plantilla. Per exemple, la plantilla: Movie mostra dades diferents segons la pel·lícula que descriu.

A cada pàgina on s’insereix la plantilla, els paràmetres s’expressen després del nom de la plantilla, separats per barres verticals i es poden identificar mitjançant un nom de paràmetre o per un ordre progressiu. El mètode d’identificació depèn de com es va construir la plantilla i s’explica al seu manual ; ambdues poden ser compatibles.

Exemple d'inclusió amb paràmetres anomenats per nom:

 {{nom de la plantilla | nom = Tom | cognom = Tom | data = dimarts}}

Exemple d'inclusió amb paràmetres seqüencials:

 {{nom de la plantilla | Tizio | Caio | dimarts}}

Dins de la pròpia plantilla, enmig de l' codi wiki que constitueix la "Plantilla: nom de la plantilla" de la pàgina, els paràmetres estan representats per etiquetes incloses en els suports triples, quan s'inclou la plantilla, aquestes etiquetes seran substituïdes pels valors de text assignats de tant en tant per l'usuari als paràmetres.

Al primer exemple:

 {{{name}}}, {{{surname}}} i {{{data}}}

En el segon:

 {{{1}}}, {{{2}}} i {{{3}}}

Per tant, la sintaxi completa és

 {{templatename | nom del paràmetre1 = valor del paràmetre1 | nom del paràmetre2 = valor del paràmetre2}}
 amb les etiquetes {{{nomeparametro}}} a la plantilla

o bé

 {{templatename|valoreparametro1|valoreparametro2}}
 amb les etiquetes {{{1}}} , {{{2}}} , etc. a la plantilla.

notes importants :

les etiquetes de paràmetres de la plantilla tenen tres claudàtors i no dos .
els noms dels paràmetres han de coincidir exactament; les majúscules sí que importen i els espais no són equivalents als subratllats.

Exemple

La pàgina "Plantilla: felicitació" conté:

 Hola {{{name}}}, com estàs?

La plantilla s'inclou en una entrada escrivint:

 {{Salutació | nom = Tom}}

Després de desar el canvi (o a la previsualització ), l'element mostrarà:

 Hola amic, com estàs?

A la fase de representació (és a dir, generar el resultat d’inserir la plantilla a la pantalla), s’ignoraran els paràmetres addicionals. Si, en canvi, els paràmetres són insuficients, normalment es produirà un error, tret que s’hagi previst la possibilitat d’ometre un paràmetre determinat.

Paràmetres opcionals

Normalment, un paràmetre es fa opcional amb el formulari {{{1|}}} o {{{1|Pippo}}} , és a dir, amb una barra vertical després del nom. La barra significa que, en absència d'aquest paràmetre, el valor següent a la barra s'utilitzarà per defecte (res en el primer cas; "Pippo" en el segon).

El valor per defecte no s'aplica si el paràmetre està buit, però la seva declaració continua present: trucant a {{nome template|}} (o {{nome template|nome=}} si aquest paràmetre té un nom), el valor del paràmetre serà només nul i no "Pippo". Per comprovar que el paràmetre no està absent ni està buit, cal la funció #if .

Personatges espacials

Quan s'utilitza la notació =, tots els espais i retorns de carros al voltant dels valors dels paràmetres s'ignoren, de manera que {{Saluto|nome=Tizio}} és equivalent a {{Saluto| nome = Tizio }} . Per aquest motiu, les plantilles que tenen molts paràmetres anomenats sovint es col·loquen en el format següent, que és més fàcil de llegir i omplir:

 {{nom de la plantilla
| nom = Tom
| cognom = Caio
...
}}

Tanmateix, aquest no és el cas de les declaracions implícites: {{Saluto|Tizio}} i {{Saluto| Tizio }} són diferents i, en el segon cas, els espais s’informaran textualment a la pàgina de trucades. Els espais solen ser inofensius de totes maneres, però si no, un possible truc per eliminar-los és utilitzar {{#if:toglispazi|{{{1}}}}} al codi de la plantilla ("space-removed" és qualsevol cadena ).

Limitacions

Un nom de paràmetre o el seu valor no poden contenir el caràcter " | ", ja que s'utilitza per separar paràmetres. Qualsevol "|" dins de wikilinks ( enllaços canalitzats ) o altres plantilles no són un problema, però si cal inserir un "|" per altres motius, utilitzeu l'ordre {{!}}.

aquesta sintaxi funciona correctament: {{Plantilla | [[Mart (astronomia) | Mart]]}}

però això no funciona: {{Plantilla | La | és un bar}}

per solucionar-ho, heu d'utilitzar aquesta variant: {{Plantilla | El {{!}} és una barra inclinada}}

A més, si no s'especifica el nom de la variable, el seu valor no pot contenir el signe " = ". Si heu d'inserir el signe "=" en una plantilla que utilitzi noms implícits de variables, heu d'especificar el nom, per exemple:

aquesta sintaxi funciona correctament: {{Plantilla | A | B}}

però això no funciona: {{Plantilla | A = 10 | B = 32}}

per solucionar-ho, heu d'utilitzar aquesta variant: {{Plantilla | 1 = A = 10 | 2 = B = 32 }}

O bé podeu utilitzar la plantilla {{ = }} de la següent manera: {{Plantilla | A {{=}} 10 | B {{=}} 32}}.

Editeu una plantilla

Per veure el contingut d’una plantilla cal obrir-la en mode d’edició.

Simplement aneu a la pàgina de la plantilla, segons com estigui configurada, obtindreu en els casos més habituals un exemple de visualització de la plantilla o una pàgina d’instruccions, de vegades acompanyada d’un advertiment que marca les plantilles més complexes i difícils de modificar.

Per anar a la pàgina d’una plantilla, a més d’escriure el seu nom al quadre de cerca, és possible fer clic a l’etiqueta d’ edició d’un element on es troba la plantilla. A la part inferior esquerra, després del wikicode de l’ítem, apareixerà una secció amb el títol "Plantilles utilitzades en aquesta pàgina", que conté enllaços a totes les plantilles inserides a la pàgina.

Cal un aclariment important:

MAI MODIFIQUEU EL CONTINGUT D’UNA PLANTILLA EN ÚS SI NO SABEU EL QUE FEU

L’edició d’una plantilla molt recordada pot danyar moltes pàgines, a més de sobrecarregar els servidors de Wikipedia, que han d’actualitzar totes les pàgines que l’inclouen. En particular, no canvieu el nom / ordre dels paràmetres , tret que vulgueu corregir una per una totes les pàgines que ja inclouen la plantilla. Sempre és millor experimentar abans de modificar les plantilles populars, mitjançant la previsualització o les proves .

Quan una plantilla està oberta per editar-la, és possible, com per a totes les pàgines, veure la vista prèvia de la plantilla; a més, hi ha una altra funció disponible per a les plantilles (el quadre "Visualització prèvia d'una pàgina amb aquesta plantilla") que us permet veure directament l'efecte que tindrien els canvis en un element que ja inclou la plantilla, sense haver de desar, ni tan sols sandbox.

Creeu una plantilla

La creació d’una nova plantilla es fa com per a qualsevol altra pàgina. Com que una plantilla es fa servir per a diverses veus, de vegades fins i tot milers, és bo discutir sobre la conveniència de la seva creació, per exemple en un projecte temàtic .

Quan escriviu una plantilla, sempre és una bona idea inserir les categories a les quals pertany la plantilla, un breu text d’instruccions (o millor encara un manual ) i una presentació de les funcions de la plantilla entre les etiquetes <noinclude> </noinclude>. Consulteu Ajuda: inclusió per obtenir una descripció d’aquestes etiquetes. Si no utilitzeu noinclude, les categories i les instruccions també apareixeran de forma errònia a tots els elements en què s’insereix la plantilla.

Si cal, el codi de la plantilla actual es troba inclòs en etiquetes <includeonly> </includeonly>, per evitar que es mostri un resultat sense sentit a la pàgina de la plantilla. No inseriu espais ni emboliqueu-los fora de les etiquetes includeonly i noinclude, ja que també apareixerien a les entrades.

Noms de plantilla

No hi ha límits tècnics als títols que no siguin els que tenen totes les altres pàgines; una plantilla es pot anomenar fàcilment "Plantilla: principals ciutats italianes", sense la necessitat de noms de llenguatge de programació com "Plantilla: CittaITA1" (es pot dir el mateix dels noms dels paràmetres). Per tant, en general, seguiu les mateixes convencions que s’utilitzen per a les veus , escollint noms en italià correcte.

Les abreviatures solen utilitzar-se només per a plantilles àmpliament utilitzades que requereixen una velocitat d’entrada manual elevada, és el cas, per exemple, de les advertències principals.

Tingueu en compte que les redireccions també funcionen per a plantilles.

Llista de pàgines que contenen una plantilla

Per comprovar quines pàgines contenen una plantilla que utilitzeu (com per a qualsevol pàgina), utilitzeu les eines Apunta aquí a l'esquerra. L'eina us permet distingir quines pàgines inclouen la plantilla i quines simplement apunten a ella amb un enllaç wikil.

Llista de plantilles incloses en una pàgina

Si voleu veure la llista de plantilles incloses en una pàgina, obriu-la en mode d'edició (o visualitzeu la font, per a les pàgines protegides).

Just a sota del quadre d'edició, a l'esquerra, hi ha una part de la pàgina titulada "Plantilles utilitzades en aquesta pàgina", que mostra les diverses plantilles incloses a la pàgina en qüestió. Podeu fer clic al nom d’un d’ells per accedir a la pàgina corresponent i, si cal, editar-la des d’aquí.

Nota: no només s’hi indiquen les plantilles incloses directament, sinó també indirectament (és a dir, les incloses al seu torn en una plantilla inclosa a la pàgina, etc.).

Memòria cau

El mateix tema en detall: Ajuda: purga .

Quan es modifica una plantilla, la versió HTML emmagatzemada a la memòria cau de totes les pàgines que fan servir la plantilla es marca com a regenerada, que es realitza mitjançant una cua de treball pels servidors. Per tant, l’actualització pot trigar una mica, especialment quan la plantilla s’inclou a moltes pàgines; així que no us preocupeu si els canvis de plantilla no apareixen de seguida a les pàgines. Per forçar immediatament l' actualització d'una pàgina determinada, només cal que deseu la pàgina (fins i tot sense modificacions).

Substitució d'una plantilla (subst :)

El mateix tema en detall: Ajuda: Subst .

Si col·loqueu "subst:" després de les claus dobles obertes, aquesta ordre al wikitext se substituirà pel contingut de la plantilla quan es desi la pàgina. Si algú canvia la pàgina més endavant, ja no veurà l'etiqueta al wikitext, sinó només el text substituït.

Comproveu el seu aspecte

Quan editeu els gràfics d’una plantilla, és una bona idea comprovar-ne l’aspecte amb els navegadors principals, ja que no tots els navegadors mostren gràfics de la Viquipèdia de la mateixa manera. Vegeu també Viquipèdia: Accessibilitat del contingut .

Variables del sistema

Les variables del sistema es poden considerar com a plantilles especials gestionades amb la mateixa sintaxi, fins i tot si el sistema les reconeix sense la necessitat d’una pàgina corresponent a l’espai de noms Plantilla, que de fet, si es creés amb un nom ja utilitzat per les variables, seria ignorat.

També és possible utilitzar variables dins de les plantilles, a més dels paràmetres declarats per l'usuari, per obtenir informació, com ara els noms de les pàgines on s'inclou la plantilla ({{PAGENAME}}) o la data ({{ CURRENTDAY}} {{CURRENTMONTHNAME}} i {{CURRENTYEAR}} en les diverses combinacions). Una paraula màgica en una plantilla s’avalua després d’inserir-la a la pàgina que hi fa referència, per exemple, si la paraula màgica {{PAGENAME}} apareix al wikicode d’una plantilla, es renderitza amb el nom de la pàgina que la conté i no amb el nom de la plantilla.

msgnw

Utilitzeu "msgnw:" després de les claus obertes per mostrar el wikicode intern de la plantilla en lloc de la seva aparença. Per exemple, {{ITA}} i {{msgnw: ITA}} es mostren respectivament:

Itàlia
I
{{bandera | ITA | nom}} <noinclude> {{Protegit}} [[Categoria: Plantilles de bandera nacional]] [[fr: Model: Italie]] </noinclude>

Cerca combinada

Arbre de categories relatives a les plantilles
(pàgines en cursiva )

► Plantilles de tema

► Plantilla per estat

► Plantilla per tipus

► Ajuda de plantilla

► Gestió de plantilles

► Mòduls

► Sandbox de plantilles

Plantilla: Disposició d'elements

Plantilla: Disposició dels elements finals

Plantilla: Diagrama de punts de dies

Plantilla: NumLegenda

Plantilla: separació d'elements

Plantilla: gràfic de colors

Plantilla: taula de colors / acabats

Plantilla: gràfic de colors / inici

Plantilla: Visió de Wikimedia

Cerqueu a l’espai de noms Plantilla

Nota

^ El terme està en anglès ( [ˈtɛmpleɪt] o [ˈtɛmplɪt] ): en italià significa "model", però literalment és "silhouette", "cast". Per obtenir informació general, consulteu l'entrada Plantilla .
^ Amb el teclat italià, la clau oberta es pot obtenir prement Alt Gr + ⇧ Maj + [ , mentre premeu la tecla de tancament prement Alt Gr + + ⇧ Maj + ] )