Ayuda:Plantillas

Las plantillas son páginas de wiki que tienen el propósito de usarse en otras páginas para realizar ciertas acciones. Se usan en su propio espacio de nombres, llamado Plantilla:, diseñado para almacenar sus contenidos. Como toda acción, esta debe respetar las normas, pero también la guía de plantillas.

Descripción general

Una plantilla es una página de wiki que sirve para realizar acciones en múltiples páginas de maneras que el texto convencional no permitiría. Te permiten crear, formatear, simplificar y salvaguardar contenido, en especial para ayudarte a usarlo en otras páginas de una manera comprensible.

Parámetros

Un parámetro de plantilla es el comando o acción que realiza una plantilla cuando la insertas en un artículo y defines dicha acción. Si no se definen, o realizan un acción predeterminada o simplemente no hacen nada. Son un sistema complejo pero simple de entender, y posee dos tipos:

Numerados

Los parámetros numerados son parámetros que no tienen nombre, sino que utilizan números para indicar su orden, y no necesariamente tienen que indicarse. Uno puede crear una plantilla llamada Plantilla:Saludo como:

Hola, {{{1}}}. Quisiera mencionar que {{{2}}} {{{3}}}.

Que puede ser usada como:

{{Saludo|Usuario|Usuario2|hizo esto en [[Minecraft]] para ayudar}}

{{Saludo|1 = Usuario|2 = Usuario2|3 = hizo esto en [[Minecraft]] para ayudar}}

Y su resultado es:

Hola, Usuario. Quisiera mencionar que Usuario2 hizo esto en Minecraft para ayudar.

Nombrados

Los parámetros nombrados son parámetros que tienen nombre, y tienen si o si que indicarse con su nombre para que realicen una acción. Uno puede crear una plantilla llamada Plantilla:Saludo, pero a diferencia del ejemplo arriba le cambiamos un poco el código:

Hola, {{{receptor}}}. Quisiera mencionar que {{{usuario}}} {{{acción}}}.

Que se puede usar de la siguiente manera:

{{Saludo|receptor = Usuario|usuario = Usuario2|acción = hizo esto en [[Minecraft]] para ayudar}}

Y su resultado es:

Hola, Usuario. Quisiera mencionar que Usuario2 hizo esto en Minecraft para ayudar.

Documentación

La documentación en una plantilla es la manera en la que puedes ayudar a otros usuarios a darle un ejemplo de cómo construir una plantilla. Las documentaciones siempre van en una subpágina "/doc", y un ejemplo puede ser Plantilla:Saludo/doc. Siempre que puedas, añade al código de la plantilla la plantilla |documentación= de la siguiente manera

Hola, {{{receptor}}}. Quisiera mencionar que {{{usuario}}} {{{acción}}}.<noinclude>
{{Documentación}}</noinclude>

Una documentación de plantilla tiene que ser corta, simple pero a su vez específica y puntual. Si quieres hacer una documentación, ten en cuenta que la estás haciendo para que otros la lean y entiendan, por lo que recuerda mantenerla en un lenguaje no demasiado técnico pero tampoco demasiado simple, sino que un balance entre dichos estilos. Un ejemplo de documentación entonces sería algo como:

{{Documentation header}}
Plantilla para dar saludos y comentarios. La plantilla añade la página a la [[:Categoría:Saludos]].

== Uso ==
<pre style="display: table;">{{Saludo
| receptor = El receptor del mensaje
| usuario = Un usuario que hace algo
| acción = Acción que realice
}}</pre>

TemplateData

La extensión TemplateData es una manera de ayudar a los editores que utilicen el editor visual a insertar una plantilla y que el sistema le ofrezca los parámetros a utilizar. Este sistema es complejo y requiere de entender un poco del editor de código, pero se pueden ver ejemplos en plantillas como |Message box=. Siempre va en la sección === Parámetros ===, y un ejemplo corto y simple es el que usa la plantilla |Tabla de opción=, cuyo código es algo como:

=== Parámetros ===
<templatedata>
{
	"params": {
		"1": {
			"label": "Color de la celda",
			"description": "Cambia el color de la celda de acuerdo a los valores predeterminados.",
			"type": "boolean",
            "suggested": true
		},
		"2": {
			"label": "Texto de la celda",
			"description": "Cambia el texto de la celda.",
            "type": "boolean"
		},
		"rowspan": {
			"label": "Ancho de la celda",
			"description": "Cambia el ancho de la celda.",
			"type": "string"
		},
		"colspan": {
			"label": "Tamaño de la celda",
			"description": "Cambia el tamaño de la celda.",
			"type": "string"
		},
		"style": {
			"label": "Estilo de la celda",
			"description": "Cambia el estilo de la celda.",
			"type": "string"	
		}
	},
	"description": "La plantilla de elección de tablas permite elegir un color predeterminado para celdas de tabla.",
    "format": "block"
}
</templatedata>

Lo que mostraría la siguiente tabla:

La plantilla de elección de tablas permite elegir un color predeterminado para celdas de tabla.

Parámetros de la plantilla

Se prefiere introducir los parámetros de esta plantilla en el formato de bloque.

Parámetro		Descripción	Tipo	Estado
Color de la celda	1	Cambia el color de la celda de acuerdo a los valores predeterminados.	Lógico	sugerido
Texto de la celda	2	Cambia el texto de la celda.	Lógico	opcional
Ancho de la celda	rowspan	Cambia el ancho de la celda.	Cadena	opcional
Tamaño de la celda	colspan	Cambia el tamaño de la celda.	Cadena	opcional
Estilo de la celda	style	Cambia el estilo de la celda.	Cadena	opcional

Notas y consejos útiles

• Usa plantillas con moderación.
• Recuerda que es importante documentar las plantillas.
• Si no entiendes algo, puedes visitar la página comunidad:Ayuda:Plantillas.