Ayuda:Plantillas
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:avisomedico. 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 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):
- {{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.
- {{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:ELnd y un ejemplo de uso en Plantilla:EL. Además verás que las plantillas sirven para escribir otras plantillas. ¡Adiós al copiar-pegar!
Plantillas disponibles
[editar]Inclusión
[editar]Se llama plantilla a cualquier página que esté destinada a incluirse dentro de otra. Generalmente se trata de las que se encuentran en el espacio de nombres «Plantilla».
Para incluir el contenido de una plantilla en una página (procedimiento también llamado transclusión) se debe escribir el nombre de la plantilla entre llaves dobles, de esta manera:
{{Nombre de la plantilla}}
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 |
|
|
| 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 |
|
|
| 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 |
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 |
|
|
| resultado | La fecha es {{{fecha}}} y la contraseña es {{{clave}}} |
Este texto está en el artículo, y ... |
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 |
|
|
| resultado | La fecha es {{{1}}} y la contraseña es {{{2}}} |
Este texto está en el artículo, y ... |
Atención con los parámetros posicionales
[editar]¿Por qué falla este ejemplo?:
| página | Plantilla:Muestra cuenta | Ejemplo de artículo |
| código |
|
|
| resultado | La cuenta es {{{1}}} |
Este texto está en el artículo, y ... |
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 |
|
|
| resultado | La cuenta es {{{1}}} |
Este texto está en el artículo, y ... |
Este problema suele suceder a menudo cuando se pasan URL como parámetros posicionales. Muchas veces, las URL (como http://es.Wikiversidad.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.Wikiversidad.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,
{{Info|q|s|commons|2=wikt|wikisource=Ayuda}}
es equivalente a
{{Info|1=q|2=s|3=commons|2=wikt|wikisource=Ayuda}}
que, como el parámetro «2» aparece dos veces, es lo mismo que
{[Info|1=q|3=commons|2=wikt|wikisource=Ayuda}}.
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 |
|
|
| resultado | La fecha es hoy |
Este texto está en el artículo, y ... |
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]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 variables son:
- Año:
- {{CURRENTYEAR}} = 2024
- Mes del año, numero:
- {{CURRENTMONTH}} = 11
- Mes del año, nombre completo:
- {{CURRENTMONTHNAME}} = noviembre
- Mes del año, nombre:
- {{CURRENTMONTHNAMEGEN}} = noviembre
- Mes del año, nombre breve:
- {{CURRENTMONTHABBREV}} = nov
- Día del mes:
- {{CURRENTDAY}} = 21
- Nombre del dia de la semana:
- {{CURRENTDAYNAME}} = jueves
- Hora del dia, hora:minutos:
- {{CURRENTTIME}} = 08:58
- Número de semana del año:
- {{CURRENTWEEK}} = 47
- Nombre de la pagina:
- {{PAGENAME}} = Plantillas
- Tipo de la página:
- {{NAMESPACE}} = Ayuda
- Número de artículos:
- {{NUMBEROFARTICLES}} = 2113
- Número de páginas:
- {{NUMBEROFPAGES}} = 15 346
- Número de usuarios
- {{NUMBEROFUSERS}} = 60 751