Ayuda: Plantilla

TIPOS DE PAGINA
Voz · Categoría de discusión ( barra ) · Archivo del portal ( imagen · sonido ) Plantilla de página de servicio · Guía del proyecto · Módulo de página de usuario Todos los espacios de nombres

abreviaturas
WP: TL WP : TL

En Wikipedia, una plantilla ^[1] es una página especial creada para ser incluida en otras páginas a través del mecanismo de inclusión .

Se puede utilizar para varios propósitos:

inserte fácilmente texto repetido en diferentes páginas, escribiéndolo una vez, como para las plantillas de navegación
insertar elementos estándar, tablas de información o avisos
insertar elementos cuyo comportamiento se pueda programar en función de unas variables.

Las plantillas están contenidas en la plantilla de espacio de nombres (o espacio de nombres 10), es decir, el espacio de nombres cuyas páginas tienen la forma " Plantilla: NOMBRE " (por ejemplo: Plantilla: S , Plantilla: Bienvenido , Plantilla: Europa ).

Para hacer referencia a una plantilla, también puede utilizar la abreviatura T, p. t: Europa .

- Mostrador de información

Inserción

Mismo tema en detalle: Ayuda: Inclusión .

Ejemplo de inclusión

Todas las páginas que pertenecen al espacio de nombres 10 se pueden insertar rápidamente en una página, simplemente escribiendo el nombre de la plantilla (la parte que sigue a la Plantilla: texto) entre llaves dobles ^[2] , como en {{ NOMBRE }}. Esta referencia en el wikitexto hace que se inserte el contenido de la plantilla cuando se muestra la página.

Si la página "Plantilla: nombre " no existe, entonces {{ nombre }} funciona como [[Plantilla: nombre ]], un enlace a una página inexistente que conduce a la página de edición.

No está permitido insertar plantillas inexistentes.

Si la plantilla no está en el espacio de nombres apropiado (porque todavía se está trabajando en ella o porque es una inserción de otra página), se puede usar de todos modos, ingresando el nombre con la ruta completa (por ejemplo {{usuario: NOMBRE APELLIDOS / Página de prueba}}).

La entrada distingue entre mayúsculas y minúsculas , es decir, el software distingue mayúsculas y minúsculas, con la excepción de la primera letra y los espacios que equivalen a guiones bajos ("_"). Por lo tanto:

la plantilla {{página de prueba}} y la plantilla {{página de prueba}} se reconocerán como diferentes
las plantillas {{test page}} y {{test_page}} serán idénticas.

Puede utilizar la inclusión anidada: una plantilla incluida en una página también puede contener una o más plantillas.

Al insertar las plantillas es posible declarar variables que se utilizarán dentro de la plantilla: en este caso hablamos de una plantilla paramétrica .

Tirantes

Para insertar los corchetes dobles que abren y cierran una plantilla existen varias formas que dependen tanto de la disposición del teclado como del sistema operativo . También puedes copiar y pegar desde aquí: {{}}

clip abierto	clip cerrado	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`+ `⇧ Shift`+`è`	`Alt`+ `Gr`+ +`⇧ Shift+`	Microsoft Windows - GNU/Linux
`Alt`+ `Ctrl`+ +`⇧ Shiftè`	`Alt`+ `Ctrl`+ +`⇧ Shift+`	Microsoft Windows
`⌥`+ `⇧`+`è`	`⌥`+ `⇧`+`+`	macOS (con el diseño italiano - Pro )

Nota : la teclatambién puede llamarse "Shift" en algunos teclados. A menudo se encuentra justo debajo de la tecla(o "Enter"). ⇧ Shift↵ Invio

Uso

Las plantillas son útiles para cualquier elemento complejo, especialmente con formato gráfico, que debe repetirse en dos o más páginas sin tener que escribirlo cada vez. Gracias a los parámetros también es posible cambiar su apariencia según el elemento, siempre sin tener que teclear todo cada vez. Las plantillas no solo son convenientes, sino que pueden ayudar a lograr la coherencia entre las páginas.

Las aplicaciones típicas son:

Alertas como {{ S }}
Plantilla de navegación como Plantilla: Europa . Estas plantillas van al final de la página, después de los enlaces externos y antes de la plantilla y las categorías {{ portal }}.
Plantillas sinópticas (también llamadas infoboxes ), que cada vez muestran el mismo tipo de información con el mismo formato pero diferenciado mediante parámetros, por ejemplo {{ Estado }}. Estas plantillas se insertan en la parte superior derecha del artículo.

Usos desaconsejados

No se recomienda duplicar contenido textual (con y sin plantillas), por ejemplo, poner una sección que tenga que ver con A y B tanto en el elemento A como en el elemento B. Esto crea confusión, especialmente para los colaboradores novatos. En estos casos es recomendable visualizar el texto en un solo lugar y usar wikilinks para conectarlo desde varios lugares.

Plantillas paramétricas

Al crear una plantilla, puede ser necesario dejar al usuario la posibilidad de personalizar parte del texto o el comportamiento de la plantilla, según la página en la que se inserte. En este caso, el usuario indica uno o más parámetros que luego serán explotados para la representación en video de la propia plantilla. Por ejemplo, la plantilla: Película muestra diferentes datos según la película que describe.

En cada página donde se inserta la plantilla, los parámetros se expresan después del nombre de la plantilla, separados por barras verticales, y pueden ser identificados por un nombre de parámetro o por un orden progresivo. El método de identificación depende de cómo se construyó la plantilla y se explica en su manual ; ambos también pueden ser compatibles.

Ejemplo de inclusión con parámetros llamados por nombre:

{{nombre de la plantilla | nombre = Tom | apellido = Tom | fecha = martes}}

Ejemplo de inclusión con parámetros en orden progresivo:

{{nombre de la plantilla | Tizio | Caio | Martes}}

Dentro de la plantilla misma, en el medio del código wiki que constituye la página "Plantilla: nombre de la plantilla", los parámetros están representados por etiquetas encerradas entre corchetes triples ; cuando se incluye la plantilla, estas etiquetas serán sustituidas por los valores de texto asignados en cada momento por el usuario a los parámetros.

En el primer ejemplo:

{{{nombre}}}, {{{apellido}}} y {{{datos}}}

En el segundo:

{{{1}}}, {{{2}}} y {{{3}}}

La sintaxis en su totalidad es por lo tanto

{{templatename | parámetro name1 = parámetro value1 | parámetro name2 = parámetro value2}} 
con etiquetas {{{nomeparametro}}} en la plantilla

o

{{templatename|valoreparametro1|valoreparametro2}}
con etiquetas {{{1}}}, {{{2}}}etc en la plantilla.

notas importantes :

¡ Las etiquetas de parámetros en la plantilla tienen tres corchetes y no dos !
los nombres de los parámetros deben coincidir exactamente; las mayúsculas sí importan, y los espacios no son equivalentes a los guiones bajos.

Ejemplo

La página "Plantilla: Saludo" contiene:

Hola {{{nombre}}}, ¿cómo estás?

La plantilla se incluye en una entrada escribiendo:

{{Saludo | nombre = Tom}}

Después de guardar el cambio (o en la vista previa ), el elemento mostrará:

Hola amigo, ¿cómo estás?

En la fase de renderizado (es decir, generar el resultado de insertar la plantilla en la pantalla), los parámetros adicionales se ignorarán. Si por el contrario los parámetros son insuficientes, normalmente se producirá un error, salvo que se haya previsto la posibilidad de omitir un determinado parámetro.

Parámetros opcionales

Por lo general, un parámetro se hace opcional con la forma {{{1|}}}o {{{1|Pippo}}}, es decir, con una barra vertical después del nombre. La barra significa que, en ausencia de ese parámetro, se utilizará por defecto el valor que sigue a la barra (nada en el primer caso; "Pippo" en el segundo).

El valor predeterminado no se aplica si el parámetro está vacío, pero su declaración aún está presente: llamando {{nome template|}}(o {{nome template|nome=}}si este parámetro tiene un nombre) el valor del parámetro será simplemente nulo y no "Foo". Para comprobar que el parámetro no está ausente ni vacío, se requiere la función #if .

Caracteres espaciales

Cuando se usa la notación con =, se ignoran los espacios y los retornos de carro alrededor de los valores de los parámetros, por lo {{Saluto|nome=Tizio}}que es equivalente a {{Saluto| nome = Tizio }}. Por esta razón, las plantillas que tienen muchos parámetros con nombre a menudo se colocan en el siguiente formato, que es más legible y fácil de completar:

{{Nombre de la plantilla
| nombre = Tomás
| apellido = Caio
...
}}

Este no es el caso de las declaraciones implícitas: {{Saluto|Tizio}}y {{Saluto| Tizio }}son diferentes, y en el segundo caso, los espacios se informarán textualmente en la página de llamada. A menudo, los espacios siguen siendo inofensivos, pero si no lo son, un posible truco para eliminarlos es usarlos {{#if:toglispazi|{{{1}}}}}en el código de la plantilla ("eliminar espacios" es cualquier cadena).

Limitaciones

Un nombre de parámetro o su valor no puede contener el carácter " | ", ya que se utiliza para separar parámetros. Cualquier "|" dentro de wikilinks ( enlaces canalizados ) u otras plantillas no son un problema, pero si necesita insertar un "|" por otras razones, use el comando {{!}}.

esta sintaxis funciona correctamente: {{Template | [[Mars (astronomy) | Mars]]}}

pero esto no funciona: {{Template | La | es un bar}}

para remediar esto, necesita usar esta variante: {{Plantilla | El {{!}} es una barra inclinada}}

Además, si no se especifican los nombres de las variables, su valor no puede contener el signo " = ". Si necesita insertar el signo "=" en una plantilla que utiliza nombres de variables implícitos, debe especificar el nombre, por ejemplo:

esta sintaxis funciona correctamente: {{Plantilla | A | B}}

pero esto no funciona: {{Plantilla | A = 10 | B = 32}}

para remediar esto, necesitas usar esta variante: {{Plantilla | 1 = A = 10 | 2 = B = 32 }}

O puedes usar la palabra mágica {{=}} de la siguiente manera: {{Plantilla | A {{=}} 10 | B {{=}} 32}}.

Editar una plantilla

Para ver el contenido de una plantilla es necesario abrirla en modo edición.

Simplemente yendo a la página de la plantilla, dependiendo de cómo esté configurada, obtendrá en los casos más comunes un ejemplo de visualización de la plantilla o una página de instrucciones, a veces acompañada de una advertencia que marca las plantillas más complejas y difíciles de modificar. .

Para ir a la página de una plantilla, además de escribir su nombre en el cuadro de búsqueda, es posible hacer clic en la etiqueta de edición de un elemento en el que se encuentra la plantilla. En la parte inferior izquierda, después del código wiki del elemento, aparecerá una sección con el título "Plantillas utilizadas en esta página", que contiene enlaces a todas las plantillas insertadas en la página.

Es necesaria una aclaración importante:

NUNCA MODIFIQUE EL CONTENIDO DE UNA PLANTILLA EN USO SI NO SABE LO QUE ESTÁ HACIENDO

La edición de una plantilla muy recordada puede dañar numerosas páginas, además de sobrecargar los servidores de Wikipedia, que tienen que actualizar todas las páginas que la incluyen. En particular, no cambie el nombre/orden de los parámetros , a menos que tenga la intención de corregir inmediatamente todas las páginas que ya incluyen la plantilla una por una. Siempre es mejor experimentar antes de modificar las plantillas populares, utilizando la vista previa o las cajas de arena .

Cuando una plantilla está abierta para su edición, es posible, como en todas las páginas, ver la vista previa de la propia plantilla; además, está disponible otra función para las plantillas (el cuadro "Vista previa de una página con esta plantilla") que permite ver directamente el efecto que tendrían los cambios en un elemento que ya incluye la plantilla, sin tener que guardar, ni siquiera salvadera.

crear una plantilla

La creación de una nueva plantilla se realiza como cualquier otra página. Dado que una plantilla está hecha para ser utilizada en varias voces, a veces incluso miles, es bueno discutir la conveniencia de su creación, por ejemplo en un proyecto temático .

Al escribir una plantilla, siempre es una buena idea insertar las categorías a las que pertenece la plantilla, un breve texto instructivo (o mejor aún, un manual ) y una presentación de las funciones de la plantilla entre las etiquetas <noinclude> </noinclude>. Consulte Ayuda: Inclusión para obtener una descripción de estas etiquetas. Si no utiliza noinclude, las categorías e instrucciones también aparecerán de forma errónea en todos los elementos en los que se inserte la plantilla.

Si es necesario, el código de la plantilla real se incluye en las etiquetas <includeonly> </includeonly>, para evitar que se muestre un resultado sin sentido en la propia página de la plantilla. No inserte espacios y ajuste fuera de las etiquetas includeonly y noinclude, ya que también aparecerían en las entradas.

Nombres de plantillas

No existen límites técnicos en los títulos distintos a los que tienen todas las demás páginas; una plantilla puede llamarse fácilmente "Plantilla: principales ciudades italianas", sin necesidad de nombres de lenguaje de programación como "Plantilla: CittaITA1" (lo mismo puede decirse de los nombres de los parámetros). En general, por lo tanto, siga las mismas convenciones utilizadas para las voces , eligiendo nombres en italiano correcto.

Las abreviaturas suelen usarse solo para plantillas muy utilizadas que requieren una alta velocidad de entrada manual, este es el caso, por ejemplo, de las advertencias principales .

Tenga en cuenta que las redirecciones también funcionan para las plantillas .

Lista de páginas que contienen una plantilla

Para verificar qué páginas contienen una plantilla, usa (como para cualquier página) las herramientas aquí a la izquierda. La herramienta te permite distinguir qué páginas incluyen la plantilla y cuáles simplemente apuntan a ella con un wikilink.

Lista de plantillas incluidas en una página

Si desea ver la lista de plantillas incluidas en una página, abra esa página en modo de edición (o vea la fuente, para páginas protegidas).

Justo debajo del cuadro de edición, a la izquierda, hay una parte de la página titulada "Plantillas utilizadas en esta página:" que enumera las diversas plantillas incluidas en la página en cuestión. Puede hacer clic en el nombre de uno de ellos para llegar a la página correspondiente y, si es necesario, editarlo desde allí.

Nota: Allí no solo se indican las plantillas incluidas directamente, sino también las indirectas (es decir, las incluidas a su vez en una plantilla incluida en la página, etc.).

Cache

Mismo tema en detalle: Ayuda: Purgar .

Cuando se modifica una plantilla, la versión HTML almacenada en caché de todas las páginas que usan la plantilla se marcan como regeneradas, lo que se realiza a través de una cola de trabajo por parte de los servidores. Por lo tanto, la actualización puede llevar algún tiempo, especialmente cuando la plantilla se incluye en muchas páginas; así que no se preocupe si los cambios de plantilla no aparecen de inmediato en las páginas. Para forzar inmediatamente la actualización de una determinada página, simplemente guarde (incluso sin cambios) la página.

Sustitución de una plantilla (sust :)

Mismo tema en detalle: Ayuda: Subst .

Al poner "subst:" después de las llaves dobles abiertas, este comando en el wikitexto será reemplazado por el contenido de la plantilla cuando se guarde la página. Si alguien cambia la página más tarde, ya no verá la etiqueta en el wikitexto, sino solo el texto reemplazado.

Compruebe el aspecto y la sensación

A la hora de editar los gráficos de una plantilla, conviene comprobar su aspecto con los principales navegadores, ya que no todos los navegadores muestran los gráficos de Wikipedia de la misma forma. Véase también Wikipedia: Accesibilidad del contenido .

Variables del sistema

Las variables del sistema se pueden considerar como plantillas especiales gestionadas con la misma sintaxis, incluso si el sistema las reconoce sin necesidad de una página correspondiente en el espacio de nombres de la plantilla , que de hecho, si se creara con un nombre ya utilizado por las variables, sería ignorado. .

También es posible utilizar variables dentro de las plantillas, además de los parámetros declarados por el usuario, para obtener alguna información como los nombres de las páginas en las que se incluye la plantilla ({{PAGENAME}}) o la fecha ({{ CURRENTDAY} } {{CURRENTMONTHNAME}} y {{CURRENTYEAR}} en las distintas combinaciones). Una palabra mágica en una plantilla se evalúa después de la inserción en la página que la referencia, por ejemplo, si la palabra mágica {{PAGENAME}} aparece en el código wiki de una plantilla, se representa con el nombre de la página que la contiene y no con el nombre de la plantilla.

mensaje

Use "msgnw:" después de los corchetes abiertos para mostrar el código wiki interno de la plantilla en lugar de su apariencia. Por ejemplo, {{ITA}} y {{msgnw: ITA}} muestran respectivamente:

Italia
y
{{flag | ITA | name}} <noinclude> {{Protected}} [[Category: National flag templates]] [[fr: Model: Italie]] </noinclude>

Búsqueda combinada

Árbol de categorías relativas a Plantillas
( páginas en cursiva )

Gestión de plantillas

formularios

Caja de arena de plantilla

Plantilla: Arreglo de elementos

Plantilla: Arreglo de elementos finales

Plantilla: gráfico de puntos de días

Plantilla: NumLegenda

Plantilla: separación de elementos

Plantilla: Carta de colores

Plantilla: Tabla de colores/acabados

Plantilla: Carta de colores / inicio

Plantilla: visión de Wikimedia

Buscar en el espacio de nombres de la plantilla

Nota

^ El término está en inglés ( [ˈtɛmpleɪt] o [ˈtɛmplɪt] ): en italiano significa "modelo", pero literalmente es "silueta", "elenco". Para obtener información general, consulte la entrada Plantilla .
^ Con el teclado italiano, la llave abierta se puede obtener presionando Alt Gr++ , mientras que la llave cerrada se puede obtener presionando ++ )⇧ Shift[Alt Gr⇧ Shift]