El espacio de nombres Template de Wikipedia se utiliza para almacenar plantillas , que contienen el marcado Wiki destinado a ser incluido en varias páginas, generalmente mediante transclusión . Aunque el espacio de nombres Template se utiliza para almacenar la mayoría de las plantillas, es posible transcluir y sustituir desde otros espacios de nombres, [1] por lo que algunas páginas de plantilla se colocan en otros espacios de nombres, como el espacio de nombres User .
Las plantillas ayudan a mantener un formato consistente y facilitan la navegación entre artículos. A menudo incluyen elementos opcionales y/o variables controlados por parámetros para permitir un uso especializado. Las plantillas también se utilizan para ayudar en una gran variedad de tareas de mantenimiento de Wikipedia . Cada plantilla tiene una página correspondiente Template talk:donde los editores pueden discutir el diseño y la implementación de la plantilla asociada (consulte Ayuda: Uso de páginas de discusión para saber cómo participar en las discusiones de las páginas de discusión).
Una plantilla se incorpora a otra página mediante la inclusión de una etiqueta de plantilla en el contenido de esa página. Una etiqueta de plantilla contiene el nombre de la página de plantilla rodeado de llaves dobles, por ejemplo {{Disambiguation}}. Si el nombre de la página de la plantilla no comienza con un espacio de nombres y dos puntos, se supone que está en el espacio de nombres de la plantilla.
Los enlaces internos a páginas de plantilla se pueden realizar utilizando el Template:prefijo, por ejemplo [[Template:Disambiguation]]. Consulte § Enlaces a plantillas para conocer otras formas de crear enlaces a una plantilla.
Los enlaces internos a páginas de plantilla se pueden realizar utilizando el Template:prefijo, p. ej [[Template:Disambiguation]]. Estos enlaces llevan a una página que contiene directamente una plantilla base, pero también se pueden vincular directamente subpáginas como la documentación de la plantilla, p. ej [[Template:Disambiguation/doc]].
Para vincular a una plantilla utilizando un formato de visualización apropiado para plantillas, utilice Template:Tl (abreviatura de "vínculo de plantilla"). Por ejemplo, para hacer referencia a la plantilla Cleanup, escribir da {{tl|Cleanup}}como resultado {{ Cleanup }} . Esto no llama a la plantilla, pero la visualización indica claramente que el objeto vinculado es una plantilla. También puede agregar parámetros utilizando Template:Tlp ; por ejemplo, {{tlp|Convert|1|m}}se muestra como {{ Convert |1|m}} . Consulte la documentación de la plantilla en Template:Tl para ver otras opciones, como {{ tlb }} (negrita), (código), (parámetros en cursiva) y muchas más.{{tlx}}{{tlxi|param1|param2}}
Los nombres de las plantillas deben estar formados por una o más palabras, como {{Train topics}}. El primer carácter no distingue entre mayúsculas y minúsculas, por lo que {{cleanup}}y {{Cleanup}}son la misma plantilla. Todos los demás caracteres sí distinguen entre mayúsculas y minúsculas, por lo que {{cfd}}y {{cfD}}no son iguales. Los nombres de las plantillas son más fáciles de recordar si siguen la ortografía, el espaciado y el uso de mayúsculas del inglés estándar (consulte también las convenciones de nomenclatura para artículos). Evite tener plantillas cuyos nombres difieran solo en mayúsculas y minúsculas, espaciado o puntuación.
En el caso de las plantillas con nombres largos, se pueden crear redirecciones de plantilla (a menudo denominadas accesos directos) para facilitar la escritura. Por ejemplo, en lugar de escribir, está disponible {{Template link with subst}}el acceso directo .{{tls}}
Si desea experimentar con plantillas (y no desea que se eliminen sus experimentos antes de terminar con ellos), puede hacerlo en el área de pruebas de plantillas . También puede utilizar las plantillas X1 , X2 , X3 , X4 , X5 , X6 , X7 , X8 , X9 , X10 , X11 y X12 para fines experimentales. Para incluir una plantilla de prueba, utilice el formulario {{X1}}para la plantilla X1, {{X2}}para la plantilla X2, etc.
Las plantillas existentes suelen tener sus propias páginas de prueba y de entorno de pruebas (especialmente las que utilizan {{ Documentation }} ). Los cambios deben probarse exhaustivamente allí antes de aplicarlos a la plantilla principal, para evitar daños involuntarios en muchas páginas.
En el caso de las plantillas que tienen una gran cantidad de parámetros, puede resultar útil colocar cada parámetro en una línea separada y alinear los signos de igual. Esto ayuda a los futuros editores a leer el código wiki con mayor facilidad. Por ejemplo, si desea crear un nuevo cuadro de información (que puede contener docenas de parámetros), su código podría verse así:
{{Cuadro de información| header1 = Texto del encabezado1|etiqueta2 = Texto de etiqueta2| data2 = Texto de data2| etc. = etc.}}Las plantillas que utilizan muchas expresiones condicionales a menudo se benefician del espaciado entre líneas, como el siguiente código utilizado en {{ If either }}
{{ #si :{{{ 1 |}}} |{{{ entonces |{{{ 3 |}}}}}} |{{ #si :{{{ 2 |}}} |{{{ entonces |{{{ 3 |}}}}}} |{{{ de lo contrario |{{{ 4 |}}}}}} } } } }Si bien no es necesario, los saltos de línea demostrados permiten un análisis más sencillo de qué condicionales se relacionan con qué declaración #if.
Aunque los saltos de línea en el cuerpo de un código de plantilla son útiles para la legibilidad, los saltos de línea al principio o al final del código de plantilla pueden causar problemas de visualización en los artículos. Se debe tener cuidado al codificar plantillas para asegurarse de que no haya espacios en blanco innecesarios. Un solo salto de línea en un cuadro de información puede combinarse con un salto de línea en un artículo para causar un salto de párrafo, o puede causar una plantilla no deseada en una plantilla en línea. Como regla general, evite dos saltos de línea juntos en su plantilla. Estos pueden "sumarse" con otros saltos de línea en el artículo y mostrarse como espacios en blanco no deseados. Para obtener más información sobre los saltos de línea y cómo afectan al wikitexto, consulte Wikipedia:Manejo de saltos de línea .
Para evitar espacios en blanco innecesarios, asegúrese de que las <noinclude>etiquetas se coloquen inmediatamente después del código de plantilla. El código siguiente es de {{ questions }} y tiene una buena gestión de saltos de línea.
{{ notice | small = yes | Si desea hacer una pregunta, consulte la página [[ Wikipedia : Preguntas ]] para obtener orientación. }}< noinclude > [[ Categoría : Plantillas de ayuda de Wikipedia ]] </ noinclude >Invocar una plantilla mediante el formulario
{{subst:name of template (|parameters |...)}}(es decir, insertar subst:inmediatamente después del par de llaves de apertura) hará una copia del texto de la plantilla y lo colocará en la página, donde será visible en la fuente. La plantilla ya no se transcluye y los cambios futuros en la plantilla no cambiarán el texto. Como guía, este método debe usarse para cualquier mensaje breve y temporal que se elimine rápidamente, como en las páginas User_talk:. El mensaje estándar de nuevo usuario es un buen ejemplo.{{Welcome}}
Utilice subst: también si necesita editar el mensaje después de incluirlo en la página. Si no necesita editarlo y prefiere que el mensaje se actualice automáticamente junto con los cambios realizados en la plantilla, no utilice subst:.
Dado que las plantillas representan un paso más en la dificultad para el editor novato, se debe proporcionar documentación que describa su uso (parámetros opcionales) y su alcance (dónde se debe utilizar). Hay dos formas diferentes de hacerlo:
Una opción es utilizar la plantilla {{ documentation }} para agregar una descripción menor directamente en la página de la plantilla. Como se menciona en § Saltos de línea, la primera <noinclude>etiqueta debe colocarse en la misma línea que el último carácter de la plantilla real. Por ejemplo:
'''Este es un artículo de {{{ 1 }}} . ''' < noinclude > {{ documentación | contenido =Coloque esta plantilla en cualquier artículo que requiera descripción.toma un parámetro, un adjetivo utilizado para describir el artículo.Por ejemplo, {{ article-describe | bad }} produce el texto '''Este es un mal artículo.''' }} </ noinclude >Otra alternativa es crear una subpágina /doc formal para la documentación (preferible para plantillas con múltiples parámetros, etc.). La plantilla {{ documentation }} se sigue llamando, pero todo el texto mostrado se incluirá desde la subpágina /doc de la plantilla.
'''Este es un artículo de {{{ 1 }}} . ''' < noinclude > {{ documentación }} </ noinclude >A veces se utilizan módulos Lua en lugar de plantillas para almacenar material reutilizable. Entre las razones para ello se incluyen el uso de características específicas del módulo, como bucles o valores almacenados, y el código complejo suele ser más fácil de leer y mantener en un módulo. Si un módulo se puede implementar fácilmente en una plantilla, por lo general debería serlo, ya que hay más usuarios con experiencia en la edición de plantillas.
Si se pretende utilizar un módulo en artículos o páginas de discusión, generalmente se debe crear un contenedor de plantilla para simplificar el uso sin requerir directamente la #invokefunción de análisis. La documentación se encuentra entonces principalmente en la página /doc de la plantilla, y la documentación del módulo apunta a la plantilla y/o explica detalles técnicos adicionales que no son necesarios en la documentación principal de la plantilla.
Un contenedor de plantilla utiliza más del límite de tamaño de inclusión posterior a la expansión que llamar al módulo directamente, por lo tanto, puede ser necesario evitar usar uno en artículos que estén cerca del límite.
Históricamente, se debía agregar un prefijo "msg:" antes del nombre de la plantilla cuando se usaba en una página. Por ejemplo, se escribía {{msg:stub}} en lugar de {{stub}}. Esto ya no es necesario.
Durante los primeros 35 meses de Wikipedia, no existía ningún mecanismo de plantilla o de transclusión. La página Wikipedia:Boilerplate text se creó en septiembre de 2002 para recopilar texto usado con frecuencia en varios procesos de Wikipedia. El espacio de nombres MediaWiki se introdujo con MediaWiki 1.2.6 el 6 de diciembre de 2003 y se utilizó no sólo para la interfaz de usuario sino también para crear mensajes de texto repetitivos que se insertarían en los artículos utilizando la sintaxis {{msg: ...}}. Esta función fue reemplazada por el espacio de nombres Template durante la actualización de software a MediaWiki 1.3 el 30 de mayo de 2004. Como una función del " script de inicialización del espacio de nombres Template ", todos los mensajes que no eran del sistema se movieron al nuevo espacio de nombres. El script de inicialización también reemplazó las referencias MediaWiki: en los artículos por Template: para evitar las redirecciones creadas por los movimientos.
Durante un breve período, Wikipedia:Artículos para borrar (conocidos entonces como votos para borrar o VfD ) utilizó mensajes MediaWiki: nombrados en el formato "MediaWiki:VfD- nombredelartículo ". Estos fueron trasladados al espacio Template: en junio de 2004 y se denominaron "Template:VfD- nombredelartículo ". Este uso está en desuso ahora en favor de las subpáginas.
Alrededor de 2005, la creciente complejidad de las funciones de plantilla y el deseo de consolidar plantillas similares llevaron a la creación de hacks condicionales extremadamente complejos como plantillas anidadas y trucos CSS . Estos métodos indeseables llevaron al desarrollo de m:Extension:ParserFunctions, agregado en 2006 con MediaWiki 1.7. Para 2009, todavía persistían muchos problemas con la legibilidad y complejidad de las plantillas ( Sobre plantillas y lenguajes de programación ). En 2013, para abordar los tiempos de carga de las páginas, principalmente debido a la lentitud en la representación de las plantillas, se habilitó Lua , creando un espacio de nombres Módulo: para que los programadores lo utilicen ( Las nuevas plantillas Lua traen páginas más rápidas y flexibles a su wiki ).
Utilice este formulario para realizar búsquedas en los espacios de nombres Template: o Template_talk:. Consulte Ayuda:Búsquedas para obtener más información.
Páginas que contienen información sobre plantillas utilizadas comúnmente:
Si no puede encontrar una plantilla existente para su situación, pero no se siente cómodo creando una usted mismo, puede pedir ayuda en Wikipedia:Plantillas solicitadas .