Ayuda:Plantillas

(Redirigido desde «Ayuda:Plantilla»)
Ayuda de edición
Antes de comenzar
Cómo se edita una página
La interfaz de Wikipedia
Barra de herramientas de edición
Creación de un artículo
Manual de estilo
Estructura de un artículo
Cómo cambiarle el título (convenciones, restricciones técnicas)
Cómo empezarlo
Cómo redactarlo mejor
Cómo añadirle imágenes (política de imágenes)
Cómo referenciarlo (política de verificabilidad)
Cómo categorizarlo
No lo firmes (política de derechos de autor y páginas de autopromoción)
Clases de artículos
Los espacios de nombres
Modelos · Anexos · Redirecciones
Uso de MediaWiki
Cronologías · Listas · Tablas · Columnas
Notas · Enlaces externos
Plantillas · Mapas de imágenes
Caracteres especiales
Palabras mágicas · ParserFunctions
Fórmulas LaTeX
Más ayuda
Preguntas idiomáticas
Transliteración
Dónde colaborar
Contenidos de ayuda
Recursos
Recursos libres
Imágenes de dominio púbilico
Ejemplos de peticiones de permiso
Más recursos y herramientas

Una plantilla es una página especial de Wikipedia, y en el software libre denominado MediaWiki que la misma utiliza, que contiene un fragmento de código diseñado para ser insertado en otras páginas de Wikipedia. Las plantillas utilizan el espacio de nombres Plantilla y se incluyen en el wikitexto utilizando un par de llaves dobles {{ }}. Antes de crear una plantilla, asegúrate de leer y entender esta guía, en particular la sección Sugerencias.

El nombre de una plantilla es el título de la página alojada dentro del espacio de nombres «Plantilla». Como todos los títulos, distingue entre mayúsculas y minúsculas (sin contar la primera letra); así, Plantilla de ejemplo y Plantilla de Ejemplo son plantillas diferentes, mientras que Plantilla de ejemplo y plantilla de ejemplo son la misma plantilla.

Cómo utilizar una plantilla

Supongamos que se quiere utilizar una plantilla llamada Plantilla:nombre de plantilla en una página llamada Página de ejemplo. Se puede llevar a cabo mediante alguno de estos dos métodos:

Sustitución

Se escribe {{subst:Nombre de plantilla}} en Página de ejemplo, con lo cual el contenido de la plantilla se agrega permanentemente a la Página de ejemplo.

La sustitución se realiza una sola vez, al momento de grabar la página. No quedan rastros de que se hubiera usado una plantilla, y el resultado es el mismo que si se hubiera escrito manualmente el texto generado por la plantilla. Cualquier cambio posterior hecho al código de la plantilla no tiene ningún efecto sobre la página. La sustitución se utiliza cuando queremos que el contenido incorporado por la plantilla pueda editarse posteriormente desde la página marcada, o cuando no es conveniente que futuros cambios en la plantilla modifiquen la página (ej.: los avisos por vandalismo en una página de discusión de usuario).

Transclusión

Se escribe {{Nombre de plantilla}} en Página de ejemplo. Es la forma más común de usar una plantilla. Cada vez que se carga la página, también se procesa la plantilla, y el resultado se incluye dentro de la primera.

La transclusión ralentiza un poco la carga de las páginas, pero como se mantiene la dependencia con la plantilla, cualquier cambio o mejora que se haga a esta impactará automáticamente en todas las páginas que la usen (o transcluyan). Además, como el código de la plantilla no se guarda en la página que la utiliza, el código de esta última no se «ensucia», haciéndose más fácil de entender y de editar. También permite encontrar qué páginas utilizan cierta plantilla (usando el enlace "Lo que enlaza aquí" del menú Herramientas).

Excepto algunas situaciones específicas, lo normal es incluir las plantillas por transclusión.

Pseudoplantillas

En realidad, cualquier página puede usarse como plantilla, por substitución o transclusión. La sintaxis es la misma, solo que no se puede omitir el espacio de nombres al usarlas, como se omite el "Plantilla:" en las plantillas normales. El ejemplo por antonomasia de pseudoplantillas son las userboxes.

Mencionar una plantilla

Cuando se desea mencionar y enlazar a una plantilla (por ejemplo, dentro de las páginas de discusión o de ayuda) se utiliza la plantilla {{ep}}. Por ejemplo {{ep|Ficha de persona}} muestra {{Ficha de persona}}.

Parámetros

Las plantillas aceptan parámetros o argumentos, que permiten aumentar sus funcionalidades, adecuándose a las necesidades de cada página que las utiliza. Cada aparición de un parámetro dentro del código de la plantilla se sustituye por el valor que se le haya dado a ese parámetro en el momento de usar la plantilla. Así, el texto generado por una misma plantilla puede variar en función de los valores que toman sus parámetros.

Parámetros con nombre

Es conveniente que los parámetros tengan nombre. A diferencia de los nombres de página, "un nombre", "Un nombre" y "Un_nombre" son todos nombres de parámetros distintos.

  • Para referirse al valor de un parámetro dentro del código de la plantilla, se escribe {{{nombre}}}, donde nombre es el nombre del parámetro.
  • Para indicar el valor deseado para un parámetro al momento de usar la plantilla dentro de la página, se escribe {{Nombre de plantilla|parámetro=valor del parámetro|otro parámetro=otro valor|tercer parámetro=texto del tercer parámetro}}

Supongamos que la plantilla:Nombre de plantilla tiene dos parámetros: fecha y clave. Para incluir la plantilla (mediante transclusión) dentro de un artículo, se deberá escribir:

{{Nombre de plantilla|fecha=24 de diciembre de 2024|clave=paparulo}}

Dentro de la plantilla, se usará {{{fecha}}} y {{{clave}}}. Cada aparición de {{{fecha}}} será sustituida por 24 de diciembre de 2024, y cada aparición de {{{clave}}} será sustituida por paparulo, al momento de usar la plantilla.

Plantilla:Ejemplo de plantilla La fecha es {{{fecha}}} y la contraseña es {{{clave}}}.
Ejemplo de artículo Este texto está en el artículo, y ...

{{Ejemplo de plantilla|fecha=24 de diciembre de 2024|clave=paparulo}}
{{Ejemplo de plantilla}}

Resultado Este texto está en el artículo, y ...

La fecha es 24 de diciembre de 2024 y la contraseña es paparulo.
La fecha es {{{fecha}}} y la contraseña es {{{clave}}}

Nótese cómo en la segunda inclusión, al no asignársele valores a los parámetros fecha y clave, los textos {{{fecha}}} y {{{clave}}} no se reemplazaron y quedaron tal cual. Cómo evitarlo se verá en la sección Valores por defecto.

Si se le asigna más de un valor al mismo parámetro, solo la última asignación se tomará en cuenta. Por ejemplo,

{{Ejemplo de plantilla|clave=zxcvz|clave=12345}}

es equivalente a

{{Ejemplo de plantilla|clave=12345}}.

Los espacios en blanco (incluyendo tabulaciones y saltos de línea) que aparecen al principio y al final del valor de un parámetro por nombre, se eliminan; los que están en el interior, se mantienen:

Plantilla:Persona Nombre: {{{nombre}}}

Domicilio: {{{domicilio}}}

Ejemplo de artículo
{{Persona|nombre=Juan Pérez|domicilio=Basavilbaso 1234}}

{{Persona|  nombre  =     Juan Pérez    |  domicilio    =  Basavilbaso 1234  }}

{{Persona
| nombre    =      Juan Pérez     
| domicilio =   Basavilbaso 1234 
}}
Resultado (los tres iguales) Nombre: Juan Pérez

Domicilio: Basavilbaso 1234

Parámetros posicionales

También es posible omitir el nombre de un parámetro, y en ese caso se identifica por su posición. Dentro del código de una plantilla, {{{3}}} hace referencia al tercero de los parámetros sin nombre usados al invocar la plantilla. Es decir, al usar una plantilla de esta forma:

{{Nombre de la plantilla|param=texto1|otro valor|más texto}}

{{{2}}} será reemplazado por más texto (el segundo de los parámetros sin nombre).

Plantilla:Ejemplo de plantilla La fecha es {{{1}}} y la contraseña es {{{2}}}.
Ejemplo de artículo Este texto está en el artículo, y ...

{{Ejemplo de plantilla|24 de diciembre de 2024|paparulo}}

Resultado Este texto está en el artículo, y ...

La fecha es 24 de diciembre de 2024 y la contraseña es paparulo.

Otro ejemplo (incorrecto):

Plantilla:Muestra ecuación La ecuación es: {{{1}}}
Ejemplo de artículo Este texto está en el artículo, y ...

{{Muestra ecuación|2x - y = 0}}

Resultado Este texto está en el artículo, y ...

La ecuación es {{{1}}}

Note que este ejemplo falla. El problema está en que el texto que estamos pasando como primer parámetro («2x - y = 0») tiene un signo igual. El signo igual se utiliza en la sintaxis de los parámetros nombrados, por lo que el sistema cree que le estamos pasando un parámetro de nombre «2x - y» con valor «0». Hay dos formas de solucionar esto:

  • nombrar explícitamente el parámetro: 1=2x - y = 0. (Luego del primer signo igual, que se usa para separar el nombre de su valor, ya no importa si hay más).
  • usar la plantilla {{=}} en reemplazo del signo igual.
Plantilla:Muestra ecuación La ecuación es: {{{1}}}
Ejemplo de artículo Este texto está en el artículo, y ...

{{Muestra ecuación|1=2x - y = 0}}
{{Muestra ecuación|2x - y {{=}} 0}}

Resultado Este texto está en el artículo, y ...

La ecuación es: 2x - y = 0
La ecuación es: 2x - y = 0

Este problema suele suceder a menudo cuando se pasan URL como parámetros posicionales. Muchas veces, las URL (como http://es.wiki.x.io/w/index.php?title=Ayuda:Plantillas) suelen tener signos de igual, y el sistema toma como nombre del parámetro todo lo que esté delante del primero (con la URL de ejemplo, interpretaría que hay un parámetro llamado «http://es.wiki.x.io/w/index.php?title» con valor «Ayuda:Plantillas»). Por eso, siempre es conveniente nombrar el parámetro explícitamente cuando se le quiera pasar una URL a una plantilla.

A diferencia de los parámetros por nombre, los espacios en blanco (incluyendo tabulaciones y saltos de línea) que aparecen al principio y al final del valor de un parámetro posicional sí se preservan, tal como los que están en el interior. Se puede usar la plantilla {{trim}} para eliminarlos.

Parámetros combinados

Los parámetros nombrados y posicionales se pueden combinar sin problema. El sistema le asignará un número secuencial a cada uno de los parámetros sin nombre, y luego aplicará las reglas de los parámetros nombrados. Por ejemplo,

{{Info|q|s|commons|2=wikt|wikisource=Ayuda|otro}}

es equivalente a

{{Info|1=q|2=s|3=commons|2=wikt|wikisource=Ayuda|4=otro}}

que, como el parámetro «2» aparece dos veces, es lo mismo que

{{Info|1=q|3=commons|2=wikt|wikisource=Ayuda|4=otro}}.

Caracteres especiales

Como ya se mencionó, el signo igual '=' debe reemplazarse por {{=}} cuando se usa dentro del valor de un parámetro sin nombre.

También, como la barra vertical '|' se usa como separador, para incluirla dentro del valor de un parámetro se la debe reemplazar por {{!}} o bien por |.

Para incluir llaves '{{' o '}}' como valor de un parámetro, se pueden usar las plantillas {{((}} o {{))}}. Para otras sustituciones necesarias, véase la Categoría:Wikipedia:Plantillas para evitar la evaluación por MediaWiki.

Valores por defecto

La expresión {{{nombre|por defecto}}} es equivalente a {{{nombre}}} excepto cuando no se le ha dado valor al parámetro, en cuyo caso la primera devuelve el texto por defecto mientras que la segunda devuelve {{{nombre}}}.

Plantilla:Mostrar fecha La fecha es: {{{fecha|hoy}}}
Ejemplo de artículo Este texto está en el artículo, y ...

{{Mostrar fecha|fecha=24 de diciembre de 2024}}
{{Mostrar fecha}}

Resultado Este texto está en el artículo, y ...

La fecha es: 24 de diciembre de 2024
La fecha es: hoy

Como se ve, en la segunda inclusión de la plantilla no se le asignó valor al parámetro fecha, por lo que se incluyó el valor por defecto, hoy.

Variables y parser functions

Las variables que provee MediaWiki parecen ser plantillas pero no lo son: {{PAGENAME}}, {{SITENAME}}, etc. Las parser functions también usan una sintaxis parecida: {{#ifexpr: 1 > 0 | sí | no}}, pero tampoco son plantillas.

Tanto las variables como las parser functions pueden aparecer dentro del contenido de una plantilla, o como argumentos.

Cómo controlar la inclusión

En general, todo el contenido de la plantilla se muestra al visitar la página de la plantilla y, también, todo su contenido se incluye dentro de las páginas que la usan. Como esas dos situaciones son diferentes, se puede controlar qué partes de la plantilla se aplican a una y otra.

  • Contenido excluido: «noinclude». Corresponde al código que no se desea que sea incluido dentro de las páginas que utilicen la plantilla. Son las secciones que están entre las etiquetas <noinclude> y </noinclude>; puede no existir, puede haber una sola sección, o pueden ser varias. Se utiliza sobre todo para categorizar la plantilla, añadirle interwikis y documentar su uso. Es el contenido que solo se ve al visitar la página de la plantilla.
  • Contenido incluido: «includeonly». Corresponde al código que solo se incluirá en las páginas que utilicen la plantilla (y no al visualizar la página de la propia plantilla). Son las secciones que están dentro de las etiquetas <includeonly> e </includeonly>; puede no existir, puede haber una sola sección, o pueden ser varias. Se utiliza sobre todo para agregar categorías a las páginas marcadas con la plantilla (no para categorizar la plantilla en sí).

Todo el código de la plantilla que esté fuera de esas etiquetas se incluye siempre.

Página Plantilla:Ejemplo de plantilla Ejemplo de artículo
Código Este texto forma parte de la plantilla.

<noinclude>Este texto solo se ve al visualizar la plantilla. Normalmente contiene la documentación de la misma.</noinclude>
<includeonly>Este texto solo se verá en las páginas que usen la plantilla.</includeonly>

Este texto está en el artículo, y ...

{{Ejemplo de plantilla}}

Resultado Este texto forma parte de la plantilla.

Este texto solo se ve al visualizar la plantilla. Normalmente contiene la documentación de la misma.

Este texto está en el artículo, y ...

Este texto forma parte de la plantilla.
Este texto solo se verá en las páginas que usen la plantilla.

Sugerencias

No abuses de las plantillas

Ten en cuenta que existen muchísimas plantillas para los más diversos temas, y que es muy posible que alguien ya haya creado una plantilla para lo que deseas. Por eso, evita la creación de plantillas redundantes o innecesarias.

No son razones para crear una plantilla
  • Que ya exista una análoga en una wiki de otro idioma: muchas wikis no poseen un control sobre la creación de plantillas, y para una misma tarea puede haber muchísimas, lo que dificulta el mantenimiento. No copiemos los malos ejemplos.
  • Que ya exista una plantilla específica para otro tema: dado el caso, en lugar de crear otra plantilla que hace prácticamente lo mismo, es mejor pensar en ampliar la plantilla ya existente, incorporándole parámetros.

Respeta las convenciones de títulos

A pesar que la política de convenciones de títulos no está orientada a las plantillas, sí es muy deseable que los títulos que elijas sean en español e intuitivos. Lo mismo pasa con los nombres de los parámetros: prefiere aquellos explicativos en lugar a las abreviaciones, pero también evita que sean demasiado largos, para facilidad de uso.

Recuerda que también se pueden crear redirecciones a plantillas. Usar la redirección es lo mismo que usar la plantilla a la cual redirige, por ejemplo escribir {{bandera1}} es lo mismo que escribir {{bandera}}.

Categoriza y documenta

Nunca olvides categorizar y documentar las plantillas, mediante la etiqueta «noinclude» explicada inicialmente.

Tipos de plantillas

Plantillas de mantenimiento

Las plantillas de mantenimiento son las utilizadas, como su nombre lo indica, para apoyar el mantenimiento de los artículos de Wikipedia. Normalmente después de ser colocadas en los artículos se avisa al usuario responsable de la edición que ocasionó el problema o deficiencia con el uso de alguna plantilla de aviso en su página de discusión.

Fichas

Una ficha (en inglés llamada infobox) es una plantilla utilizada en artículos, y excepcionalmente en páginas de usuario —véase la ficha correspondiente— que sirve para resumir y sistematizar por medio de una tabla la información medular presente en cada página que la contiene. Se categorizan en la Categoría:Wikipedia:Fichas, y se basan en la ficha genérica {{Ficha}}. Un ejemplo de ellas es la plantilla {{Ficha de vía de transporte}}.

Existe una convención de títulos para las fichas, que puede verse aquí.

Plantillas de navegación

Una plantilla de navegación es una plantilla diseñada para agrupar artículos de un modo distinto al orden alfabético proporcionado por las categorías, y de forma tal que proporciona información adicional sobre la relación entre dichos artículos.

En otras wikipedias este tipo de plantillas coexiste y muchas veces es redundante con el uso de las categorías. En la Wikipedia en español, sin embargo, debe restringirse su uso a lo especificado en la política correspondiente.

Las plantillas de navegación específicas se basan en la metaplantilla {{Navegación}} y se sitúan en Categoría:Wikipedia:Plantillas de navegación. Las plantillas de navegación de propósito general se sitúan en la Categoría:Wikipedia:Plantillas generales de navegación.

Etiquetas de usuario

Una etiqueta de usuario (del inglés Userbox) es una pseudoplantilla utilizada exclusivamente en páginas de usuario y en algunos wikiproyectos, cuyo espacio de nombres es Usuario:, y que sirve para mostrar características del usuario que la utiliza. Se categorizan en la Categoría:Wikipedia:Plantillas de usuario, y un ejemplo de ellas es la pseudo-plantilla {{Usuario:Userbox/Astronomía}}.

Todas las plantillas

Véase también

Otras páginas sobre plantillas

Ayuda adicional

Convenciones y políticas de plantillas