Ayuda:Plantillas

De Wikinoticias, la fuente libre de noticias
Ayuda de edición (contenidos)
Artículos
Usando MediaWiki (Referencia rápida)
Recursos
Atajo: A:P

Las plantillas son textos, bloques, cuadros de información que pueden ser utilizados desde muchos artículos distintos. No solamente con un contenido fijo, sino que pueden ser personalizados con la información adecuada a cada artículo. De estas plantillas se trata aquí.

Anteriormente a la versión 1.3 de MediaWiki algunos de estos mensajes estaban en el espacio de nombres de MediaWiki, ahora están en el espacio Plantilla:. Aquí hallarás más información (en inglés) acerca del espacio de nombres de mensajes parametrizables (plantillas o templates) de MediaWiki.

Instrucciones[editar]

Para crear un mensaje personalizado nuevo sólo tienes que crear una página en el espacio de nombres Plantilla llamándola "Plantilla:" y el nombre del mensaje. Por ejemplo, Plantilla:Argentina. Se pueden usar los mismos caracteres que para crear páginas normales, incluyendo espacios y caracteres con diacríticos. No hay unas convenciones de títulos por el momento, pero se suele primar la brevedad sobre la claridad.

Si creas un mensaje personalizado, añádelo a esta página, manteniendo el orden alfabético.

Para usar el mensaje en una página hay que enlazarlo utilizando dos pares de llaves (curly bracket) entre el nombre.

Básicamente hay dos formas de usar los mensajes personalizados en un artículo: la sustitución y transclusión.

Comando Efecto
{{subst:mensaje}} La sustitución copia el texto del mensaje donde escribiste el identificador, justo después de guardar el artículo.
({{mensaje}} o {{msg:mensaje}} (el uso de msg: está considerado obsoleto desde la versión 1.3) La transclusión carga el mensaje y lo pone en la página cada vez que ésta se carga.

En otras palabras, si alguien actualiza el texto del mensaje y se ha utilizado transclusión, no habrá necesidad de actualizar la página en que se ha incluido. Los mensajes breves y temporales, que se eliminarán pronto, deberían copiarse utilizando subst (que tiene la ventaja de que muestra el texto del mensaje en el código fuente wiki), y los avisos estándares que puede que permanezcan en la página durante meses o para siempre, deberían transcluirse para facilitar su actualización (la transclusión no debería utilizarse si el mensaje contiene enlaces que pueden cambiar en el futuro. Este método no actualiza "Lo que enlaza aquí" a menos que todos los artículos que contengan el mensaje se cambien tras la modificación del enlace del mensaje).

Plantillas con parámetros[editar]

El contenido de las plantillas acepta toda la sintaxis wiki (ver Wikinoticias:Cómo se edita una página).

Desde la versión 1.3 de MediaWiki estos mensajes pueden tomar parámetros, por eso se llaman plantillas (templates). Con estos parámetros se puede conseguir que el mismo mensaje tenga textos variables en función de los valores que toman los parámetros al transcluirlos.

Para definir los parámetros en una plantilla lo único que tienes que hacer es usar la etiqueta {{{n}}}, donde n es un número o un identificador de texto, allá donde quieras poner un texto variable. Recuerda que los parámetros en la plantilla llevan tres llaves en vez de dos.

Para usar la plantilla con argumentos se usa una de las sintaxis siguientes (dependiendo de la definición de la plantilla):

  1. {{nombre de plantilla|parámetro=texto|parámetro2=texto2}} si los parámetros se han definido con un nombre, es decir, n es un texto alfanumérico.
  1. {{nombre de plantilla|texto|texto2}} si los parámetros se han definido con un número, es decir, n es un número en el ejemplo anterior.

Se puede ver un ejemplo con números en Plantilla:Wikinoticias y un ejemplo de uso. Además verás que las plantillas sirven para escribir otras plantillas. ¡Adiós al copiar-pegar!

Para buscar plantillas[editar]

Cuando se grabe la página (o se muestre la previsualización) en lugar de ese texto aparecerá el contenido de la página «Plantilla:Nombre de la plantilla».

Si se desea incluir una página que no esté en el espacio de nombres «Plantilla», se deberá escribir el espacio de nombres explícitamente, usando «:» para el espacio de nombres principal.

{{:Artículo ejemplo}}   → esto incluirá el contenido del artículo «Artículo ejemplo».
{{Usuario:Ejemplo/plantilla}}   → esto incluirá el contenido de la página Usuario:Ejemplo/plantilla.
página Plantilla:Ejemplo de plantilla Ejemplo de artículo
código

Este texto se incluye desde la plantilla en el artículo principal


Este texto está en el artículo, y ... {{Ejemplo de plantilla}}


resultado

Este texto se incluye desde la plantilla en el artículo principal



Este texto está en el artículo, y ... Este texto se incluye desde la plantilla en el artículo principal


«includeonly» y «noinclude»[editar]

En una plantilla, el texto entre <noinclude> y </noinclude> no se incluirá dentro de otras páginas. Por otro lado, el texto entre <includeonly> e </includeonly> sólo será visible en las páginas donde la plantilla se incluya, y no cuando se visualice la plantilla como página independiente.

página Plantilla:Ejemplo de plantilla Ejemplo de artículo
código

Este texto se incluye desde la plantilla en el artículo principal
<noinclude>Este texto no se incluirá; sólo se ve en la página de la plantilla</noinclude>
<includeonly>Este texto sólo se verá cuando la plantilla sea incluida en otra página</includeonly>

Este texto está en el artículo, y ... {{Ejemplo de plantilla}}


resultado

Este texto se incluye desde la plantilla en el artículo principal
Este texto no se incluirá; sólo se ve en la página de la plantilla


Este texto está en el artículo, y ... Este texto se incluye desde la plantilla en el artículo principal
Este texto sólo se verá cuando la plantilla sea incluida en otra página

Esta funcionalidad es útil para categorizar. Si se coloca una [Categoría:...]] en una sección noinclude y otra en una sección includeonly, entonces la plantilla se categorizará en la primera y la página donde la plantilla se incluya, en la segunda.

Parámetros[editar]

Parámetros nombrados[editar]

Las plantillas pueden tomar parámetros. Dentro de la plantilla, cualquier palabra o palabras rodeada por llaves triples se reemplazará por el valor del parámetro del mismo nombre al momento de incluir la plantilla. Para asignarle valores a los parámetros al incluir la plantilla, se utiliza la siguiente sintaxis:

{{Nombre de la plantilla|nombre del parámetro=valor|nombre del otro parámetro=valor}}

(La cantidad de parámetros que pueden asignarse de esta manera no está limitada a dos.)

En el siguiente ejemplo se puede ver el cómo se reemplaza {{{nombre del parámetro}}} por su valor al momento de incluir la plantilla (y cómo no se reemplaza cuando no se le asigna ningún valor).

página Plantilla:Ejemplo de plantilla Ejemplo de artículo
código

La fecha es {{{fecha}}} y la contraseña es {{{clave}}}


Este texto está en el artículo, y ...
{{Ejemplo de plantilla|fecha=2006-01-01|clave=paparulo}}
{{Ejemplo de plantilla}}



resultado

La fecha es {{{fecha}}} y la contraseña es {{{clave}}}


Este texto está en el artículo, y ...
La fecha es 2006-01-01 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 Valores por omisión.

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

Parámetros posicionales[editar]

También se puede, al incluir una plantilla, pasarle parámetros sin nombrarlos explícitamente.

{{Nombre de la plantilla|primer parámetro|segundo...}}

Se considerará que el primer parámetro tiene nombre 1, el segundo 2, etc., y reemplazarán, dentro de la plantilla, a cualquier aparición de {{{1}}}, {{{2}}}, etc.

Un ejemplo:

página Plantilla:Ejemplo de plantilla Ejemplo de artículo
código

La fecha es {{{1}}} y la contraseña es {{{2}}}


Este texto está en el artículo, y ...
{{Ejemplo de plantilla|2006-01-01|paparulo}}



resultado

La fecha es {{{1}}} y la contraseña es {{{2}}}


Este texto está en el artículo, y ...
La fecha es 2006-01-01 y la contraseña es paparulo


Atención con los parámetros posicionales[editar]

¿Por qué falla este ejemplo?:

página Plantilla:Muestra cuenta Ejemplo de artículo
código

La cuenta es: {{{1}}}


Este texto está en el artículo, y ...
{{Muestra cuenta|2+2=4}}



resultado

La cuenta es {{{1}}}


Este texto está en el artículo, y ...
La cuenta es {{{1}}}



El problema está en que el texto que estamos pasando como primer parámetro («2+2=4») 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 «2+2» con valor «4». La solución consiste en nombrar explícitamente el nombre del parámetro («1»). Luego del primer signo igual, que se usa para separar el nombre del parámetro de su valor, ya no importa si hay más.

página Plantilla:Muestra cuenta Ejemplo de artículo
código

La cuenta es: {{{1}}}


Este texto está en el artículo, y ...
{{Muestra cuenta|1=2+2=4}}



resultado

La cuenta es {{{1}}}


Este texto está en el artículo, y ...
La cuenta es 2+2=4



Este problema suele suceder a menudo cuando se pasan URL como parámetros posicionales. Muchas veces, las URL (como http://es.wikinews.org/w/index.php?title=Ayuda:Plantillas) suelen tener signos 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.wikinews.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.

Combinando tipos de parámetros[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,

{{wikinoticias|título|fecha}}

es equivalente a

{{wikinoticias|1=título|2=fecha}}

Valores por omisión[editar]

Como se vio más arriba, si al incluir una plantilla no se provee un valor para algún parámetro que esta incluya entre triple llaves, esa referencia no se reemplaza. Afortunadamente es posible especificar un valor por omisión, de la siguiente manera:

{{{nombre del parámetro|valor por omisión}}}
página Plantilla:Ejemplo de plantilla Ejemplo de artículo
código

La fecha es: {{{fecha|hoy}}}


Este texto está en el artículo, y ...
{{Ejemplo de plantilla|fecha=2006-01-01}}
{{Ejemplo de plantilla}}



resultado

La fecha es hoy


Este texto está en el artículo, y ...
La fecha es 2006-01-01
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 omisión.

Variables predefinidas[editar]

Meta-Wiki
Meta-Wiki
Meta-Wiki tiene más información sobre Help:Magic words.

Existen unas variable ya definidas, que se pueden emplear como plantillas o como parámetros en otras plantillas, los datos cronológicos están referidos al meridiano de Meridiano de Greenwich, estas se encuentran disponibles en m:Help:Magic words.