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.
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.
La principal manera de usar una plantilla es transcluyéndola: {{Plantilla|Parámetro}}
. No obstante, hay pautas para su uso:
- No abuse del uso de plantillas en una página, ya que puede causar tiempos de carga demasiado lentos.
- Siempre incluya categorías dentro de etiquetas <includeonly></includeonly> cuando esté creando una plantilla.
- Incluya la plantilla
{{documentación}}
dentro de etiquetas <noinclude></noinclude> cuando esté creando una plantilla. - Cree únicamente plantillas con texto traducido, no parámetros traducidos, y mantenga los parámetros en inglés en las ya existentes.
- Use los nombres de plantilla en español, para prevenir el uso de redirecciones, a menos que no haya uno en español por motivos variados.
- Creación de plantillas
{{Plantilla | parámetro 1 = {{{parámetro x|}}} }}<includeonly>[[Categoría:Alguna categoría]]</includeonly><noinclude> {{Documentación}} </nowiki>
- Ejemplo de uso
{{Plantilla|parámetro x = Algún valor}}
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:
Que puede ser usada como:
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:
Que se puede usar de la siguiente manera:
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
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. Además, siempre incluye {{documentation header}}
en el encabezado. Un ejemplo de documentación entonces sería algo como:
En general, las plantillas suelen ordenarse de esta manera:
- Organización de secciones
- Texto de encabezado explicando el propósito de la plantilla.
- Sección "Uso" con la explicación de los parámetros.
- (Si se requiere) Subsección "Parámetros" si es complicado explicarlo en "Uso".
- (Si se requiere) Subsección específica de algún parámetro por si es incluso más grande. Va en el mismo lugar que "Parámetros" si no existe esta.
- (Si se requiere) Subsección "Parámetros" si es complicado explicarlo en "Uso".
- (Si se requiere, opcional) Sección "Ejemplos" (Nota: debería estar en tablas)
- Sección "Véase también"
Enlaces detallados[]
Español:
- wikipedia:Ayuda:Guía rápida de plantillas
- wikipedia:Ayuda:Plantillas
- mw:Help:Templates/es
- comunidad:Ayuda:Plantillas
Inglés: