Ayuda:Plantillas
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=23 de agosto de 2024|clave=paparulo}}
Dentro de la plantilla, se usará {{{fecha}}}
y {{{clave}}}
. Cada aparición de {{{fecha}}}
será sustituida por 23 de agosto 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 ...
|
Resultado | Este texto está en el artículo, y ... La fecha es 23 de agosto de 2024 y la contraseña es paparulo. |
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}}}
|
---|---|
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 ...
|
Resultado | Este texto está en el artículo, y ... La fecha es 23 de agosto 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 ...
|
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 ...
|
Resultado | Este texto está en el artículo, y ... 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.wikipedia.org/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.wikipedia.org/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 ...
|
Resultado | Este texto está en el artículo, y ... La fecha es: 23 de agosto de 2024 |
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. |
Este texto está en el artículo, y ...
|
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. |
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
- Wikipedia:Plantillas generales
- Wikipedia:Plantillas de enlaces
- Wikipedia:Plantillas de mantenimiento
- Wikipedia:Plantillas de borrado
- Wikipedia:Plantillas de disputas
- Plantilla:Transferir a
- Wikipedia:Plantillas de aviso a usuario
Ayuda adicional
- Ayuda:Guía rápida de plantillas
- Cómo renombrar una plantilla
- Wikiproyecto:Plantillas
- Wikipedia:Límites con las plantillas
- Wikipedia:Principales plantillas