stringtranslate.com

Wikipedia: espacio de nombres de plantilla

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

El espacio de nombres Plantilla en Wikipedia se utiliza para almacenar plantillas , que contienen marcas Wiki destinadas a ser incluidas en varias páginas, generalmente mediante transclusión . Aunque el espacio de nombres Plantilla 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 Usuario .

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 Template talk:página coincidente 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 transcluye en otra página al incluir una etiqueta de plantilla en el contenido de esa página. Una etiqueta de plantilla contiene el nombre de la página de la plantilla rodeado por 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 crear utilizando el Template:prefijo, por ejemplo [[Template:Disambiguation]]. Estos enlaces dirigen 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 Plantilla:Tl (abreviatura de "enlace de plantilla"). Por ejemplo, para hacer referencia a la plantilla de limpieza, escribir {{tl|Cleanup}}los resultados en {{ Limpieza }}. También puede agregar parámetros usando Plantilla:Tlp ; por ejemplo, {{tlp|Convert|1|m}}se muestra como {{ Convert |1|m}} .

Consulte la documentación de la plantilla en Plantilla:Tl para ver 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 (únicamente) no distingue entre mayúsculas y minúsculas, por lo que {{cleanup}}y {{Cleanup}}son la misma plantilla, pero {{cfd}}no {{cfD}}lo son. 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 en inglés (consulte también las convenciones de nomenclatura de los 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 que sus experimentos no se eliminen antes de terminar con ellas), puede hacerlo en el Sandbox de plantillas . También puede utilizar las plantillas X1 , X2 , X3 , X4 , X5 , X6 , X7 , X8 , X9 , X10 , X11 y X12 con 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 a menudo tienen cada una su propia zona de pruebas y páginas de casos de prueba (especialmente aquellas que usan {{ Documentación }}). Los cambios se deben probar minuciosamente allí antes de aplicarlos a la plantilla principal, para evitar daños involuntarios a muchas páginas.

Legibilidad

Para 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 iguales. Esto ayuda a los futuros editores a leer más fácilmente el código wiki.

{{Nombre de plantilla de ejemplo| first_parameter = Texto del first_value| second_parameter = 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 normalmente flotan 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 pauta 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.

Sustitución

Invocar una plantilla usando el formulario

{{subst:name of template (|parameters |...)}}

(es decir, insertar subst:inmediatamente después del par inicial de llaves) 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 para nuevos usuarios 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

Debido a que las plantillas representan un paso adelante en dificultad para el editor novato, se debe proporcionar documentación que describa su uso (parámetros opcionales) y alcance (dónde debe usarse). Hay dos maneras diferentes de hacer esto:

Una alternativa es usar <noinclude> para agregar una descripción menor directamente a la plantilla, por ejemplo:

'''Este es un artículo {{{1}}}.'''<noinclude>Coloque esta plantilla en cualquier artículo que requiera descripción. Éltoma 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 (preferida para plantillas con múltiples parámetros, etc.) y agregarla después de la plantilla real. La primera etiqueta "noinclude" debe colocarse en la misma línea que las llaves finales de la plantilla real de la siguiente manera:<noinclude>{{Documentation}}</noinclude>

{{(Nombre de la plantilla)(parámetros canalizados)}}<no incluir>...

Si la etiqueta "noinclude" comienza en la línea debajo de las llaves de cierre de la plantilla, entonces se introducen espacios en blanco no deseados en la parte inferior de la plantilla cuando se usa en artículos y en otras páginas.

Módulos

A veces se utilizan módulos Lua en lugar de plantillas para almacenar material reutilizable. Las razones de esto incluyen el uso de funciones 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, generalmente 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 analizador. Luego, la documentación se ubica principalmente en la página /doc de la plantilla, con la documentación del módulo apuntando a la plantilla y/o explicando detalles técnicos adicionales que son innecesarios en la documentación de la plantilla principal.

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 que puede ser necesario evitar el uso de uno en artículos que están cerca del límite.

Historia

Históricamente, se debía agregar un prefijo "msg:" delante del nombre de la plantilla cuando se usaba en una página. Por ejemplo, se escribió {{msg:stub}} en lugar de {{stub}}. Esto ya no es necesario.

En los primeros 35 meses de Wikipedia, no existía ninguna plantilla ni mecanismo de transclusión. La página Wikipedia: texto repetitivo se creó en septiembre de 2002 para recopilar texto de uso frecuente 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 usó no solo para la interfaz de usuario sino también para crear mensajes de texto repetitivos que se insertarían en artículos usando la sintaxis {{msg: ...}}. Esta función fue reemplazada por el espacio de nombres de plantilla durante la actualización del software a MediaWiki 1.3 el 30 de mayo de 2004. Como función del " script de inicialización del espacio de nombres de plantilla ", todos los mensajes que no eran del sistema se movieron al nuevo espacio de nombres. El script de inicialización también reemplazó MediaWiki: referencias en artículos con Plantilla: para evitar las redirecciones creadas por los movimientos.

Durante un breve tiempo, Wikipedia: Artículos para eliminación (entonces conocidos como votos para eliminación o VfD ) utilizó MediaWiki: mensajes nombrados en el formato "MediaWiki:VfD- nombre del artículo ". Estos se trasladaron al espacio Plantilla: en junio de 2004 y se denominaron "Plantilla: VfD- nombre del artículo ". Este uso ahora está obsoleto en favor de las subpáginas.

Alrededor de 2005, la creciente complejidad de las funciones de las plantillas y el deseo de consolidar plantillas similares llevaron a la creación de trucos condicionales extremadamente complejos, como plantillas anidadas y trucos CSS . Estos métodos no deseados llevaron al desarrollo de m:Extension:ParserFunctions, añadido en 2006 con MediaWiki 1.7. En 2009, aún persistían muchos problemas con la legibilidad y la 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 Módulo: espacio de nombres para que lo utilicen los programadores ( las nuevas plantillas de Lua traen páginas más rápidas y flexibles a su wiki ).

Buscando plantillas

Utilice este formulario para buscar en los espacios de nombres Plantilla: o Plantilla_talk:. Consulte Ayuda:Buscando más información.

Páginas que contienen información sobre plantillas de uso común:

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 .

Ver 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