Wikipedia: espacio de nombres de plantilla
El espacio de nombres de Plantilla en Wikipedia se utiliza para almacenar plantillas , que contienen marcado Wiki destinado a ser incluido en varias páginas, generalmente a través de la transclusión . Aunque el espacio de nombres de la plantilla se utiliza para almacenar la mayoría de las plantillas, es posible transcluir y sustituir de 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 de 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 la página de discusión).
Una plantilla se traslada a 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 de llaves dobles, p {{Disambiguation}}
. Ej . 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 las páginas de la plantilla se pueden hacer usando el Template:
prefijo, por ejemplo [[Template:Disambiguation]]
. Estos enlaces van a una página que contiene directamente una plantilla base y, a menudo, documentación .
Pautas
- Normalmente, las plantillas no deben usarse para almacenar el texto del artículo , ya que esto dificulta la edición del contenido. Tampoco deben usarse para "colapsar" u "ocultar" contenido al lector.
- Las plantillas utilizadas en los artículos están diseñadas para proporcionar información para ayudar a los lectores, como ayudas a la navegación, formato o advertencias de que el contenido no es estándar. Las plantillas que solo brindan información de servicio a los editores no deben aparecer en las páginas de los artículos; use la página de discusión del artículo u otros espacios de nombres que no sean de artículos.
- La función de la plantilla debe quedar clara en el nombre de la plantilla , pero se pueden crear redireccionamientos para ayudar al uso diario de plantillas muy populares.
- Las plantillas de alto riesgo deben estar semiprotegidas, protegidas por plantillas o completamente protegidas según corresponda (consulte Wikipedia: Política de protección ). Esto se aplica también a cualquier redireccionamiento de plantilla de uso elevado.
- Las plantillas deben estar claramente documentadas en cuanto a su uso y alcance.
- Las plantillas no deben usarse para crear listas de enlaces a otros artículos cuando una categoría , una página de lista o una lista de la sección "Ver también" pueden realizar la misma función.
- Las plantillas para mensajes breves y temporales que se eliminarán rápidamente (como en User_talk: páginas) o que contienen texto que probablemente nunca se modifique deben invocarse con sustitución (subst :). Las plantillas típicas que están diseñadas para un uso a largo plazo y es probable que requieran cambios deben incluirse para facilitar las actualizaciones futuras.
- Las plantillas que infrinjan las pautas de esta página, tienen una función mal definida, son redundantes, quedan huérfanas o se utilizan en una sola página, o violan otras políticas de Wikipedia pueden ser nominadas para su eliminación en Wikipedia: Plantillas para discusión .
Prácticas sugeridas
Plantillas de referencia
A veces querrá hacer referencia a una plantilla, en lugar de invocarla. Una forma fácil de hacerlo es llamar a Template: Tl (abreviatura de "enlace de plantilla"). Por ejemplo, para hacer referencia a la plantilla de limpieza, escribir los {{tl|Cleanup}}
resultados en {{ Limpieza }}. También puede agregar parámetros usando Template: Tlp ; por ejemplo, se {{tlp|Convert|1|m}}
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}}
Nombres de plantillas
Los nombres de las plantillas pueden estar formados por una o más palabras, como {{Train topics}}
. El primer carácter (sólo) no distingue entre mayúsculas y minúsculas, así {{cleanup}}
y {{Cleanup}}
son la misma plantilla, pero {{cfd}}
y {{cfD}}
no lo son. Los nombres de las plantillas son más fáciles de recordar si siguen la ortografía, el espaciado y las mayúsculas estándar en inglés (consulte también las convenciones de nomenclatura de los artículos). Evite tener plantillas cuyos nombres difieran solo en mayúsculas, espaciado o puntuación.
Sandbox para experimentos
Si desea experimentar con plantillas (y no eliminar sus experimentos antes de que haya terminado con ellas), puede hacerlo en la zona de pruebas 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 caja de arena y páginas de casos de prueba (especialmente aquellas que usan {{ Documentation }}). Los cambios deben probarse minuciosamente allí antes de aplicarlos a la plantilla principal, para evitar daños involuntarios en muchas páginas.
Legibilidad
Para las plantillas que usan una gran cantidad de parámetros, puede ser útil colocar cada parámetro en una línea separada y alinear los signos iguales. Esto ayudará a los futuros editores a leer más fácilmente el wikicode.
{{Ejemplo de nombre de plantilla | first_parameter = Texto de first_value | second_parameter = Texto de second_value | third_parameter = Texto del tercer_parámetro | etc = etc }}
Saltos de línea
Algunas plantillas pueden causar accidentalmente saltos de línea adicionales en los artículos renderizados. Esto es especialmente cierto para las plantillas de cuadro de información y otros cuadros de plantilla que generalmente 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, insertando subst:
inmediatamente después del par de llaves de apertura) hará una copia del texto de la plantilla y la colocará en la página, donde se podrá ver en la fuente. La plantilla ya no se incluye y los cambios futuros en la plantilla no cambiarán el texto. Como guía , este método debe usarse para cualquier mensaje temporal corto 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 use subst :.
Documentación
Debido a que las plantillas representan un paso adelante en la 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 formas diferentes de hacer esto:
Una alternativa es usar <noinclude> para agregar una descripción menor directamente en la plantilla, por ejemplo:
'' 'Este es un {{{1}}} artículo.' '' <noinclude> Coloque esta plantilla en cualquier artículo que requiera descripción. Eso 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 formal / doc para la documentación (preferida para plantillas con múltiples parámetros, etc.) y agregar 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) }} <noincluir> ...
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 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, generalmente debería serlo, ya que hay más usuarios con experiencia en la edición de plantillas.
Si un módulo está destinado a ser utilizado 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 #invoke
función de analizador. La documentación se encuentra principalmente en la página de la plantilla / doc, con la documentación del módulo apuntando a la plantilla y / o explicando más detalles técnicos que son innecesarios en la documentación de la plantilla principal.
Sin embargo, a veces hay razones para no usar un contenedor de plantilla, como causar problemas potenciales con los límites de la plantilla ; un contenedor de plantilla que pasa demasiados parámetros a un módulo es mucho menos eficiente en comparación con una invocación directa. Además, generalmente no es deseable utilizar envoltorios de plantilla en otras plantillas.
Historia
Históricamente, se tenía que 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 habí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 la 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 la plantilla", todos los mensajes que no son del sistema se movieron al nuevo espacio de nombres. El script de inicialización también reemplazó a MediaWiki: referencias en artículos con Plantilla: para omitir las redirecciones creadas por los movimientos.
Durante un breve período de 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 movieron al espacio Plantilla: en junio de 2004 y se denominaron "Plantilla: VfD- nombre del artículo ". Este uso está obsoleto ahora a 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 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, aún quedaban muchos problemas con la legibilidad y la complejidad de las plantillas ( en 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 representaciones de las plantillas, se habilitó Lua , creando un Módulo: espacio de nombres para que lo utilicen los programadores (las nuevas plantillas de Lua brindan páginas más rápidas y flexibles a su wiki ).
Buscando plantillas
Utilice este formulario para buscar en los espacios de nombres Template: o Template_talk:. Consulte Ayuda: búsqueda para obtener más información.
Páginas que contienen información sobre plantillas de uso común:
- Wikipedia: índice de plantilla para un índice de plantillas basadas en texto.
- Wikipedia: plantillas de navegación para una lista parcial de varios elementos de navegación de clases temáticas.
- Wikipedia: Lista de infoboxes para infoboxes, que son pequeños paneles que resumen las características clave del tema de la página.
- Wikipedia: categorización de plantillas utilizadas para categorías
- Wikipedia: Plantillas de citas para las plantillas que se utilizan para dar formato a las referencias y citas de artículos.
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
- Ayuda: Plantilla para obtener información sobre el desarrollo de plantillas y detalles de sintaxis.
- Ayuda: palabras mágicas para todos los modificadores de plantilla
- Ayuda: tablas condicionales
- Wikipedia: estandarización de plantillas
Notas
- ^ Los espacios de nombres desde los que no se permite la transclusión se especifican en un wiki mediante la variable $ wgNonincludableNamespaces