stringtranslate.com

Wikipedia:Espacio de nombres de plantilla

Esta página no debe confundirse con Plantilla:Espacios de nombres

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] y, por lo tanto, 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 coherente 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]]. Estos enlaces llevan a una página que contiene directamente una plantilla base y, a menudo, documentación.

Pautas

  • WP:TG
  • WP:TMPG

Prácticas sugeridas

Plantillas de referencia

A veces, querrás hacer referencia a una plantilla, en lugar de invocarla. Una forma sencilla de hacerlo es llamar a Template:Tl (abreviatura de "vínculo de plantilla"). Por ejemplo, para hacer referencia a la plantilla Cleanup, escribir da {{tl|Cleanup}}como resultado {{ Cleanup }} . También puedes agregar parámetros usando 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 conocer otras opciones, como {{ tlb }} (negrita), (código), (parámetros en cursiva) y muchas más.{{tlx}}{{tlxi|param1|param2}}

Nombres de plantillas

  • WP:TPN

Los nombres de las plantillas pueden 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.

Sandbox para experimentos

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.

Legibilidad

En el caso de las plantillas que utilizan 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.

{{Nombre de plantilla de ejemplo| primer_parámetro = Texto del primer_valor| segundo_parámetro = Texto del segundo_valor| tercer_parámetro = Texto del tercer_parámetro| etc. = etc.}}

Saltos de línea

Algunas plantillas pueden provocar accidentalmente saltos de línea adicionales en los artículos renderizados. Esto es especialmente cierto en el caso de las plantillas de cuadro de información y otros cuadros de plantilla que suelen flotar en el lado derecho de un artículo, ya que las líneas adicionales no se verán en la página de la plantilla. Para obtener más información, consulte Wikipedia:Manejo de saltos de línea .

Como regla general, evite incluir dos saltos de línea juntos en su plantilla. Estos pueden "sumarse" con otros saltos de línea en el artículo y aparecer como un espacio en blanco no deseado.

Sustitución

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

Documentación

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 alternativa es usar <noinclude> para agregar una descripción menor directamente en la plantilla, por ejemplo:

'''Este es un artículo {{{1}}}.'''<noinclude>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.) y agregarla después de la plantilla real. La primera etiqueta "noinclude" normalmente debe colocarse en la misma línea que los últimos caracteres de la plantilla real, de la siguiente manera:<noinclude>{{Documentation}}</noinclude>

{{(nombre de la plantilla)(parámetros canalizados)}}<noinclude>...

Si la etiqueta "noinclude" comienza en la línea debajo de los caracteres finales de la plantilla, es posible que se introduzcan espacios no deseados en la parte inferior de la plantilla cuando se utilice en artículos y otras páginas.

Módulos

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.

Historia

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 de las renderizaciones 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 ).

Buscando plantillas

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 .

Véase también

Notas

  1. ^ Los espacios de nombres desde los cuales no se permite la transclusión se especifican en una wiki mediante la variable $wgNonincludableNamespaces