Ayuda:Plantillas

De Wikipedia, la enciclopedia libre
Saltar a: navegación, búsqueda
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 (1) (2)
Cómo empezarlo
Cómo redactarlo mejor
Cómo añadirle imágenes (3)
Cómo referenciarlo(4)
Cómo categorizarlo
Cómo añadirle enlaces interlingüísticos
No lo firmes (5) (6)
Clases de artículos
Los espacios de nombres
Modelos · Anexos · Redirecciones
Uso de MediaWiki
Cronologías · Listas · Tablas
Plantillas · Palabras mágicas · ParserFunctions
Caracteres especiales · TeX · LaTeX
Más ayuda
Preguntas idiomáticas
Transliteración
Enlaces útiles
Dónde colaborar
Recursos
Recursos de dominio público
Imágenes de dominio púbilico
Más recursos y herramientas
Ejemplos de peticiones de permiso
Espacios de nombres
Espacios básicos Espacios de discusión
0 Principal (o Artículo) Discusión 1
2 Usuario Usuario discusión 3
4 Wikipedia Wikipedia discusión 5
6 Archivo Archivo discusión 7
8 MediaWiki MediaWiki discusión 9
10 Plantilla Plantilla discusión 11
12 Ayuda Ayuda discusión 13
14 Categoría Categoría discusión 15
100 Portal Portal Discusión 101
102 Wikiproyecto Wikiproyecto Discusión 103
104 Anexo Anexo Discusión 105
446 Education Program Education Program talk 447
828 Módulo Módulo discusión 829
Espacios virtuales
-1 Especial
-2 Medio

Una plantilla es un fragmento de código de Wikipedia que puede ser reutilizado por muchas páginas distintas, sin necesidad de copiar todo el código nuevamente. Corresponden a un tipo de páginas especiales, destinadas a utilizarse dentro de otras, y que utilizan el espacio de nombres Plantilla:.

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 dentro del espacio de nombres «Plantilla:». Como todos los títulos, distingue entre mayúsculas y minúsculas (excepto la primera letra): Plantilla de ejemplo y Plantilla de Ejemplo son plantillas diferentes, pero Plantilla de ejemplo y plantilla de ejemplo son la misma plantilla.

Cómo utilizar una plantilla[editar]

Supongamos que queremos utilizar una plantilla llamada Plantilla:Nombre_de_plantilla en una página cualquiera, llamada Página de ejemplo. Esto podemos hacerlo de dos maneras diferentes:

Sustitución[editar]

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[editar]

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 cuáles 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[editar]

En realidad, cualquier página puede usarse como plantilla, por substitución o transclusión. La sintaxis es la misma, sólo 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[editar]

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 actor}} muestra {{Ficha de actor}}.

Parámetros[editar]

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[editar]

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|otropará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=11 de julio de 2014|clave=paparulo}}

Dentro de la plantilla, se usará {{{fecha}}} y {{{clave}}}. Cada aparición de {{{fecha}}} será sustituida por 11 de julio de 2014, 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=11 de julio de 2014|clave=paparulo}}
{{Ejemplo de plantilla}}

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

La fecha es 11 de julio de 2014 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, sólo 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[editar]

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|11 de julio de 2014|paparulo}}

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

La fecha es 11 de julio de 2014 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 ecució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.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[editar]

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[editar]

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[editar]

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=11 de julio de 2014}}
{{Mostrar fecha}}

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

La fecha es: 11 de julio de 2014
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[editar]

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[editar]

En general, todo el conenido 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 sólo se ve al visitar la página de la plantilla.

  • Contenido incluido: «includeonly»

Corresponde al código que sólo 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 sólo se ve al visualizar la plantilla. Normalmente contiene la documentación de la misma.</noinclude>
<includeonly>Este texto sólo 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 sólo 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 sólo se verá en las páginas que usen la plantilla.


Sugerencias[editar]

No abuses de las plantillas[editar]

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[editar]

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.

Categoriza y documenta[editar]

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

Tipos de plantillas[editar]

Plantillas de mantenimiento[editar]

Las plantillas de mantenimiento son las utilizadas, como su nombre lo indica, para apoyar el mantenimiento de los artículos de Wikipedia. Normalmente luego 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[editar]

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}}.

Plantillas de navegación[editar]

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.

Userboxes[editar]

Una userbox (término propio del inglés, aún no traducido al español) 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[editar]

Véase también[editar]

Otras páginas sobre plantillas[editar]

Ayuda adicional[editar]

Convenciones y políticas de plantillas[editar]