Guía de edición de Wikipedia y página de ayuda
La sustitución es una forma diferente de manejar plantillas que la que se hace normalmente en Wikipedia. Por lo general, las plantillas se transcluyen , lo que significa que si la plantilla cambia, cada página que la utilice se actualizará para cumplir con el cambio en cuestión. Este es el procedimiento utilizado para la mayoría de las plantillas. Sin embargo, algunas plantillas se sustituyen. Esto significa que si la plantilla cambia, la página que la utiliza no lo hará y seguirá mostrando la versión anterior de la plantilla. Algunas plantillas siempre deben sustituirse, mientras que la mayoría siempre deben transcluirse.
Para sustituirlo, agregue subst:después de las llaves de apertura, como en {{subst:page name}}. Por ejemplo: sustitución {{subst:Medicine}} en contraste con transclusión {{Medicine}} . El contenido de Plantilla:Medicina se ampliará (para cualquier plantilla) y se almacenará en cada punto donde se coloque "{{subst:Medicina}}" en una página. Tenga en cuenta que las etiquetas de referencia se niegan a ejecutar "subst:" a menos que se les cambie temporalmente el nombre a " <xref name=xx>" o similar (consulte el informe de error en T4700).
Esta página también enumera plantillas que siempre o nunca deben sustituirse, excepto en el espacio de nombres de Wikipedia. Las herramientas automatizadas (también conocidas como bots ) que realizan dichos reemplazos nunca se utilizarán en la plantilla original. Si va a utilizar un bot para sustituir plantillas, lea primero la página de discusión , ya que muchas están en disputa o cambian de estado con el tiempo, y la sustitución es permanente.
Acerca de la sustancia:
Definición
La subst:palabra clave (abreviatura de "sustitución") se utiliza dentro del código de la plantilla , colocada como prefijo antes del nombre de la plantilla pero entre llaves ( {{}}). Cambia la forma en que el software MediaWiki expande la plantilla.
Normalmente, una plantilla se ampliará "sobre la marcha"; es decir, el código de plantilla de una página llama a una página independiente cada vez que se representa. Aunque la mayoría de las vistas de páginas se proporcionan desde la memoria caché, las páginas deben representarse para obtener vistas previas y volver a representarse cuando la página cambia. Cuando alguien está editando una página con una llamada de plantilla normal, ve la llamada de plantilla.
Colocar "subst:" dentro de las llaves le indica al software que reemplace permanentemente la plantilla con el texto de la plantilla (es decir, el texto que está en la página del artículo de la plantilla cuando la plantilla se agrega a la página ). Por lo tanto, {{template}} se convierte en {{subst:template}}, hasta que guardes la página. El siguiente editor no ve la llamada de la plantilla, sino el texto de la plantilla cuando la guardó; no cambia incluso si se edita la plantilla original.
Uso
Puede sustituir una etiqueta de plantilla agregándole "subst:". Por ejemplo, utilice {{subst:test5}} en lugar de {{test5}}.
Cuando este es un componente importante de una edición, se recomienda encarecidamente que la plantilla se mencione en el resumen de la edición (por ejemplo, coloque "{{subst:test}}", "subst:test" o "test1 aplicado" en su resumen de edición) para que otros editores puedan ver fácilmente lo que ha hecho.
Además, al crear o editar plantillas que comúnmente se sustituyen, agregar un comentario oculto a la página de la plantilla ayuda a los editores de artículos a ver cómo se utilizan las plantillas (p. ej. ). Utilice {{ subst:html comment }} si desea escribir comentarios HTML que contengan expansiones de wikitexto.<!-- Substituted from Template:Documentation -->
Beneficios
- Si hay una plantilla que te gustaría modificar para una sola ocasión, pero no quieres modificar la plantilla para todas las páginas que la usan, y no quieres hacer una nueva plantilla, puedes sustituir la plantilla y luego con una segunda edición, realice las modificaciones. Por ejemplo, se podría utilizar una plantilla con todos los estados de Estados Unidos y con el Distrito de Columbia. Es posible que la plantilla esté redactada correctamente para los estados, pero no para DC. Para corregir la redacción, puede sustituir la plantilla y luego corregir la redacción.
- La sustitución de plantillas de uso frecuente, pero desprotegidas, limita el daño que puede causar que personas destrocen la plantilla. Ver plantillas de alto riesgo .
- Transcluir ciertas plantillas oculta el wikitexto a los recién llegados, mientras que sustituirlo hace que el wikitexto sea visible y les da la oportunidad de aprender su uso (por supuesto, hay un enlace "cómo editar" en la parte inferior de cada página de edición).
- La sustitución permite la evaluación recursiva a través de macroplantillas.
Neutral
- La sustitución en masa puede, en última instancia, acelerar el sitio, pero esta no es una razón para preferir la sustitución a la transclusión. No se preocupe por el rendimiento de los servidores de Wikipedia.
- Las plantillas suelen modificarse o eliminarse. Si una plantilla es texto repetitivo , considere si desea que varíe a medida que se modifica la plantilla. Si su respuesta es "no", se justifica la sustitución. Un ejemplo de esto es la plantilla {{ subst:welcome }}. Los archivos de la página de discusión de un usuario deben mostrar el mensaje de bienvenida real que recibió, no el mensaje de bienvenida actual.
Desventajas
- Una vez que se sustituye una plantilla, el resultado ya no está vinculado a la plantilla, lo que dificulta encontrar todas las páginas que muestran ese texto (aunque las categorías a veces pueden aliviar esto). El problema se puede solucionar fácilmente incluyendo un enlace a la plantilla en el código de la plantilla.
- Una plantilla sustituida no se actualizará cuando se corrijan los errores en la plantilla maestra.
- Si la plantilla se utiliza para estandarizar la apariencia de algo, probablemente no desee realizar una sustitución. Un ejemplo de esto es una tabla de contenido o un cuadro de navegación.
- La sustitución en masa (editar miles de artículos con bots) ralentiza temporalmente el sitio y desperdicia recursos del servidor innecesariamente.
- La sustitución aumenta el tamaño de los artículos en la base de datos y los volcados de la base de datos.
- Una plantilla sustituida puede agregar una gran cantidad de código wiki o HTML al artículo, perjudicando la accesibilidad para los menos inclinados a la técnica.
- La sustitución de plantillas impide que los recién llegados aprendan a utilizarlas y evita que los usuarios encuentren su documentación.
- Si la plantilla sólo se utiliza temporalmente, normalmente es mejor no sustituirla. Las plantillas sustituidas son mucho más difíciles de eliminar o modificar.
- Cuando se sustituye una plantilla vandalizada, es más difícil de reparar que el vandalismo normal debido a la falta de vínculos entre la plantilla y sus encarnaciones y la falta de capacidad de actualización.
- Algunas metaplantillas, como {{!}} y {{ (( }}, no funcionan si se sustituyen.
Plantillas que siempre deben ser sustituidas
Esta es una lista de plantillas que siempre deben sustituirse, organizadas por espacio de nombres . Cada lista está ordenada alfabéticamente con series agrupadas. Esta no es una lista comprensible ; Es posible que también sea necesario sustituir otras plantillas menos utilizadas; consulte la documentación de la plantilla para obtener más detalles.
Espacio de nombres del artículo
- {{ No más enlaces }}, al sustituir esto se inserta un comentario que solo es visible en el modo de edición, con una breve explicación para desalentar el envío de enlaces no deseados.
charla del artículo
Espacio de nombres de conversación de usuario
Se deben sustituir todas las plantillas enumeradas en Categoría:Plantillas de advertencia para el usuario y Categoría:Plantillas de bienvenida . Esto no se aplica a las plantillas en la página de usuario.
Espacio de nombres de archivos
Varios. plantillas
- Las plantillas de firma de usuario, si se transcluyen, causan una tensión excesiva en el servidor, ya que los cambios en una plantilla de usuario menor deben propagarse ampliamente. Si se utilizan, se deben sustituir las plantillas de firma de usuario. (Cabe señalar, sin embargo, que no se recomiendan las plantillas de firma de usuario ).
Sugerencias sin categoría
Plantillas que deben ser sustituidas
Estas plantillas tienen un propósito y/o una sintaxis que requiere su sustitución.
- {{ afd }}, o el enlace a "la entrada de este artículo" no funciona.
- {{ cfd }}, {{ cfr }}, {{ cfm }}, que insertan comentarios que sirven como colas para Cydebot , que se utiliza para cambiar el nombre o fusionar categorías.
- {{ copyvio }}, para los artículos que se enumeran en problemas de derechos de autor , generará un mensaje de error si se transcluyen.
- {{ nld }}, para imágenes sin información sobre el estado de los derechos de autor, agrega {{ no licence }} con la fecha de hoy completada automáticamente.
- {{ nrd }}, para imágenes sin justificación de uso legítimo , agrega {{ sin justificación }} con la fecha de hoy completada automáticamente.
- {{ nsd }}, para imágenes sin información de fuente, agrega {{ di-no source }} con la fecha de hoy completada automáticamente.
- {{ orfud }}, para imágenes huérfanas de uso legítimo "genéricas", agrega {{ uso legítimo di-orphaned }} con la fecha de hoy completada automáticamente.
- {{ or-fu-re }}, para imágenes de uso legítimo que han quedado huérfanas a favor de otra imagen, agrega {{ di-orphaned fair use }} con la fecha de hoy completada automáticamente (toma el nombre de la imagen de reemplazo como parámetro ).
- {{ eliminación propuesta }}, para la eliminación propuesta, agrega {{ eliminación propuesta/fecha }} con la fecha de hoy completada automáticamente.
- {{ movimiento solicitado }}, para solicitar movimientos de página
- {{ rfd }}, redirecciones para discusión
- {{ rfu }}, para imágenes de uso legítimo que debería ser posible reemplazar con una imagen con licencia gratuita, agrega {{ replacementable fair use }}, con la fecha de hoy completada automáticamente.
- {{ refu-c }}, utilizado en los títulos de imágenes marcadas como uso legítimo reemplazable, agrega {{ rfu-c }} con la "fecha de vencimiento" (hoy + 7 días) calculada y completada automáticamente.
- {{ OnProd }}, que inserta el nombre dependiente de la fecha de hoy de la página de categoría a la que se agregó el artículo cuando se nominó para su eliminación.
Plantillas que no deben ser sustituidas
Técnicamente, no se deben sustituir plantillas que:
- contener llamadas a ParserFunctions (
#if, #switch, etc.), a menos que, cuando sea posible, estas también se sustituyan (ver mw:Manual:Substitution#Multilevel substitution) - Deje algunos parámetros con sus valores predeterminados sin especificarlos, a menos que se utilice el mecanismo predeterminado alternativo.
- contener enlaces externos ya que el formato de la URL para realizar consultas o búsquedas puede cambiar
Esto se debe a que estas construcciones no se reemplazan en el código wiki generado (la sustitución de un solo nivel del caso (A) deja las construcciones #ifo #switchtextualmente en la ubicación sust y (B) deja construcciones como {{{1|default value}}}).
Si hay un consenso específico para eliminar una llamada particular de dicha plantilla, se puede usar Special:ExpandTemplates para expandir esa llamada a una sintaxis wiki simple.
Lista
Esta es una lista de plantillas que no deben sustituirse. Esto se debe a que contienen código de formato estándar, código complejo o código que se rompe si se sustituye.
- {{ Cita necesaria }}, contiene código complejo.
- Varias plantillas de citas/referencias que contienen código condicional muy complejo (ver: WP:CITET ).
- {{ cleanup }}, {{ merge }}, {{ trivia }} y otras plantillas de limpieza . Los bots dependen de ellos, la sustitución desordena el texto del artículo y rompe la clasificación de limpieza por fecha de mes.
- {{ Curlie }}, URL que consulta directorios web externos (antiguo DMOZ).
- Plantillas de cuadro de información , varias para facilitar la identificación de bots y la coherencia.
- {{ Javadoc:EE }}, {{ Javadoc:SE }}, {{ Javadoc:SE-guide }}, plantillas condicionales cuya finalidad es actualizar los enlaces cuando se actualiza la plantilla maestra.
- {{ ISP }}, {{ Openproxy }}, {{ repetir vandal }}, {{ SharedIP }}, {{ SharedIPEDU }}, {{ s/wnote }}, no mensajes a los usuarios (por lo que no es problema si cambian de su forma original), por lo que no hay motivo para sustituirlo, pero se aplican los motivos estándar para no sustituirlo.
- {{ ln }}, {{ lnt }}, código complejo
- {{ Principal }}, mantiene el estándar de formato.
- {{ switch }}, también plantillas condicionales; sustitución del uso de descansos
- {{ Ver también }}, formato estándar para ver también la lista
- {{ selfref }}, no funciona cuando se sustituye, ya que está destinado a contener código diferente en espejos.
- {{ Signpost-subscription }}, debe actualizarse semanalmente.
- {{ stub }} plantillas, varias para simplificar el uso y la eliminación
- {{ talkarchive }}, {{ archivo }}
- {{ tl }}, {{ tlp }}, {{ ttl }}, {{ ti }}, {{ tic }}, {{ tls }}, {{ cl }}, {{ ccl }}, muchos muy ampliamente utilizado, {{ tl }} con más de 6.950.000 transclusiones en el último recuento. Es más rápido escribir que sus sustituciones, y no sustituirlas permite a los nuevos wikipedistas aprender sobre ellas y poder utilizarlas.
- {{ sockpuppet }} y plantillas similares destinadas a colocarse en la página de nivel superior en el espacio del usuario. (Nota: se deben sustituir las advertencias y avisos en el espacio de conversación del usuario).
Tenga en cuenta también que algunas cosas pueden parecer plantillas pero en realidad son palabras mágicas , como {{!}} y {{noexternallanglinks}} . Sustituirlos no producirá nada o sustituirá una plantilla que los sombree (como la obsoleta Plantilla:! ).
Plantillas de títulos incorrectas
Estas plantillas, utilizadas en el espacio principal, agregan un comentario sobre por qué un artículo tiene un nombre incorrecto. Es posible que se eliminen a medida que mejoren las funciones de titulación de MediaWiki y que la redacción o el diseño cambien.
Relacionado con la eliminación
La mayoría de las plantillas relacionadas con el cambio de nombre o la eliminación de páginas se utilizan temporalmente y, por lo tanto, no es necesario sustituirlas (simplemente eliminarlas hace más trabajo).
- Excepciones
Se deben sustituir las siguientes plantillas para que funcionen correctamente:
- {{ afd }} {{ afd2 }} {{ afd3 }}
- {{ cfd }} {{ cfm }} {{ cfr }} {{ cfr-speedy }}
- {{ nld }} {{ nsd }}
- {{ prod }}
- {{ rfd }}
- {{ tfd2 }} {{ tfdnotice }}
Además, se deben sustituir aquellas plantillas que documenten un proceso de eliminación finalizado ({{ afd top }}, etc.).
Bajo debate
Ver también
