Ayuda: Plantilla

TIPOS DE PÁGINA
Elemento · Hilo ( barra ) Categoría · Portal Archivo ( Imagen · Sonido ) Página de servicio Plantilla ·Directriz Proyecto · Página de usuario Módulo 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 de acuerdo a algunas 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 el formato " Plantilla: NOMBRE " (por ejemplo: Plantilla: S , Plantilla: Bienvenida , Plantilla: Europa ).

Para hacer referencia a una plantilla, también puede utilizar la abreviatura T, p. Ej. 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 corchetes 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 APELLIDO / Página de prueba}}).

La entrada mayúsculas y minúsculas, es decir, los distingue de software mayúsculas y letras minúsculas, con la excepción de la primera letra y espacios que son equivalentes a subrayado ( "_"). Por lo tanto:

la plantilla {{página de prueba}} y la plantilla {{página de prueba}} se reconocerán como diferentes
las plantillas {{página de prueba}} y {{página de prueba}} 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 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 las llaves dobles que abren y cierran una plantilla hay varias formas que dependen tanto de la distribución del teclado como del sistema operativo . También puede 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` + `⇧ Mayús` + `es`	`Alt` + `Gr` + `⇧ Mayús` + `+`	Microsoft Windows - GNU / Linux
`Alt` + `Ctrl` + `⇧ Mayús` + `es`	`Alt` + `Ctrl` + `⇧ Mayús` + `+`	Microsoft Windows
`⌥` + `⇧` + `es`	`⌥` + `⇧` + `+`	macOS (con el diseño italiano - Pro )

Nota : la clave ⇧ Shift , en algunos teclados también se puede llamar "Shift". A menudo se encuentra justo debajo de la clave. ↵ Entrar (o "Entrar").

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 en función del artículo, 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 de {{ portal }}.
Plantillas sinópticas (también llamadas infoboxes ), que muestran cada vez el mismo tipo de información con el mismo formato pero diferenciada mediante los parámetros, por ejemplo {{ Status }}. Estas plantillas se insertan en la parte superior derecha del elemento.

Usos desaconsejados

No se recomienda duplicar el 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 contribuyentes novatos. En estos casos es recomendable ver 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 datos diferentes 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 se pueden identificar 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 secuenciales:

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

Dentro de la propia plantilla, en medio del wikicode que constituye la página "Plantilla: nombre de la plantilla", los parámetros están representados por etiquetas encerradas entre llaves triples ; cuando se incluye la plantilla, estas etiquetas serán reemplazadas con los valores de texto asignados de vez en cuando por el usuario a los parámetros.

En el primer ejemplo:

 {{{name}}}, {{{surname}}} y {{{data}}}

En el segundo:

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

Por tanto, la sintaxis completa es

 {{nombre de plantilla | nombre de parámetro1 = valor de parámetro1 | nombre de parámetro2 = valor de parámetro2}}
 con las etiquetas {{{nomeparametro}}} en la plantilla

o

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

notas importantes :

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

Ejemplo

La página "Plantilla: saludo" contiene:

 Hola, {{{name}}}, ¿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), se ignorarán los parámetros adicionales. Si, por el contrario, los parámetros son insuficientes, normalmente se producirá un error, a menos que se haya previsto la posibilidad de omitir un parámetro determinado.

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 a {{nome template|}} (o {{nome template|nome=}} si ese parámetro tiene un nombre) el valor del parámetro será solo nulo y no "Pippo". Para comprobar que el parámetro no está ni ausente ni vacío, se requiere la función #if .

Personajes espaciales

Cuando se usa la notación =, los espacios y los retornos de carro alrededor de los valores de los parámetros se ignoran, por lo que {{Saluto|nome=Tizio}} 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 más fácil de completar:

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

Sin embargo, 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. Los espacios a menudo son inofensivos de todos modos, pero si no, un posible truco para eliminarlos es usar {{#if:toglispazi|{{{1}}}}} en el código de la plantilla ("space-remove" es cualquier cadena ).

Limitaciones

El nombre de un 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: {{Plantilla | [[Marte (astronomía) | Marte]]}}

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

para solucionar este problema, debe utilizar esta variante: {{Plantilla | La {{!}} es una barra}}

Además, si no se especifica el nombre de la variable, 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 solucionar este problema, debe utilizar esta variante: {{Plantilla | 1 = A = 10 | 2 = B = 32 }}

O puede usar la plantilla {{ = }} 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 de la wikicode 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.

Se necesita una aclaración importante:

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

Editar una plantilla muy recuperada puede dañar numerosas páginas, así como 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 pretenda corregir todas las páginas que ya incluyen la plantilla una por una. Siempre es mejor experimentar antes de modificar las plantillas populares, usando 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.

Crea 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 en 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 erróneamente en todos los ítems en los que se inserta la plantilla.

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

Nombres de plantillas

No hay límites técnicos en los títulos que no sean los que tienen todas las demás páginas; una plantilla se puede llamar fácilmente "Plantilla: Principales ciudades italianas", sin la 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 se utilizan generalmente solo para plantillas de uso generalizado 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 comprobar qué páginas contienen una plantilla, utilice (como para cualquier página) las herramientas Point here a la izquierda. La herramienta te permite distinguir qué páginas incluyen la plantilla y cuáles simplemente la señalan 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 el código 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í se indican no solo las plantillas incluidas directamente, sino también indirectamente (es decir, las incluidas a su vez en una plantilla incluida en la página, etc.).

Cache

El mismo tema en detalle: Ayuda: Purga .

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

Reemplazo de una plantilla (subst :)

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.

Comprueba el aspecto y la sensación

Al editar los gráficos de una plantilla, es una buena idea comprobar su apariencia con los navegadores principales, 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 administradas con la misma sintaxis, incluso si el sistema las reconoce sin la necesidad de una página correspondiente en el espacio de nombres de la Plantilla, que de hecho, si se crea 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 insertarla en la página que la hace referencia; por ejemplo, si la palabra mágica {{PAGENAME}} aparece en el código wik de una plantilla, se representa con el nombre de la página que la contiene y no con el nombre de la plantilla.

msgnw

Utilice "msgnw:" después de las llaves abiertas para mostrar el código wikico interno de la plantilla en lugar de su apariencia. Por ejemplo, {{ITA}} y {{msgnw: ITA}} se muestran respectivamente:

Italia
Y
{{flag | ITA | name}} <noinclude> {{Protected}} [[Categoría: Plantillas de banderas nacionales]] [[fr: Model: Italie]] </noinclude>

Búsqueda combinada

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

► Plantillas de temas

► Plantilla por estado

► Plantilla por tipo

► Ayuda de plantilla

► Gestión de plantillas

► Módulos

► Caja de arena de plantilla

Plantilla: arreglo de elementos

Plantilla: disposición de los elementos finales

Plantilla: Gráfico de puntos por días

Plantilla: NumLegenda

Plantilla: separación de elementos

Plantilla: carta de colores

Plantilla: Mesa de color / acabado

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", "moldeado". Para obtener información general, consulte la entrada Plantilla .
^ Con el teclado italiano, la llave abierta se puede obtener presionando Alt Gr + ⇧ Shift + [ , mientras que la llave de cierre presionando Alt Gr + ⇧ Mayús + ] )