Wikipedia:Sustitución

Esta página documenta una guía de edición de Wikipedia en inglés . Los editores deberían seguirlo en general, aunque pueden aplicarse excepciones . Las modificaciones sustanciales a esta página deben reflejar el consenso . En caso de duda, debatir primero en la página de discusión de esta guía .

Atajos Página de inicio: TSUB WP:SUST.

Esta página en pocas palabras: La sustitución es la copia única y permanente del contenido de la plantilla en Wikipedia . Se diferencia de la transclusión , que se actualiza continuamente a medida que cambia el contenido vinculado.

La sustitución es una forma diferente de manejar las plantillas que la que se hace normalmente en Wikipedia. Normalmente, las plantillas se transcluyen , lo que significa que si la plantilla cambia, cada página que la use se actualizará para cumplir con el cambio en cuestión. Este es el procedimiento que se utiliza 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 usa 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 sustituir, agregue subst:después de las llaves de apertura, como en {{subst:page name}}. Por ejemplo: substitution {{subst:Medicine}} en contraste con transclusion {{Medicine}} . El contenido de Template:Medicine se expandirá (para cualquier plantilla) y se almacenará en cada punto donde se coloque "{{subst:Medicine}}" en una página. Tenga en cuenta que las etiquetas de referencia se niegan a ejecutar "subst:" a menos que se cambie temporalmente el nombre a " <xref name=xx>" o algo similar (consulte el informe de error en T4700).

Esta página también enumera las plantillas que siempre o nunca deben sustituirse, excepto en el espacio de nombres Wikipedia. Las herramientas automatizadas (también conocidas como bots ) que realizan tales 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.

La subst:palabra clave (abreviatura de "sustitución") se utiliza dentro del código de la plantilla , se coloca como prefijo antes del nombre de la plantilla pero dentro de las llaves ( {{}}). Cambia la forma en que el software MediaWiki expande la plantilla.

Por lo general, una plantilla se expandirá "sobre la marcha", es decir, el código de plantilla de una página llama a una página separada cada vez que se renderiza. Aunque la mayoría de las vistas de página se proporcionan desde la memoria caché, las páginas deben renderizarse para obtener vistas previas y renderizarse nuevamente cuando la página cambia. Cuando alguien está editando una página con una llamada de plantilla normal, ve la llamada de plantilla.

Al colocar "subst:" dentro de las llaves, se le indica al software que reemplace permanentemente la plantilla con el texto de la plantilla (es decir, el texto que se encuentra en la página del artículo de la plantilla cuando se agrega la plantilla a la página ). Por lo tanto, {{template}} se convierte en {{subst:template}}, hasta que guarde la página. El próximo editor no ve la llamada a la plantilla, sino el texto de la plantilla cuando la guardó; no cambia incluso si se edita la plantilla original.

Puedes sustituir una etiqueta de plantilla añadiéndole "subst:". Por ejemplo, utiliza {{subst:test5}} en lugar de {{test5}}.

Cuando este es un componente importante de una edición, se recomienda enfáticamente que se mencione la plantilla 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 se suelen sustituir, agregar un comentario oculto a la página de plantillas ayuda a los editores de artículos a ver cómo se utilizan las plantillas (por ejemplo, ). Use {{ subst:html comment }} si desea escribir comentarios HTML que contengan expansiones de wikitexto.<!-- Substituted from Template:Documentation -->

• Si hay una plantilla que desea modificar para una sola ocasión, pero no desea modificarla para todas las páginas que la utilizan y no desea crear una nueva plantilla, puede sustituirla y, luego, con una segunda edición, realizar las modificaciones. Por ejemplo, una plantilla podría utilizarse con todos los estados de los Estados Unidos y con el Distrito de Columbia. La plantilla podría estar redactada correctamente para los estados, pero no para DC. Para corregir la redacción, puede sustituir la plantilla y, luego, corregir la redacción.
• Sustituir plantillas que se usan con frecuencia pero que no están protegidas limita el daño que puede causar la vandalización de la plantilla. Ver plantillas de alto riesgo .
• La transclusión de ciertas plantillas oculta el wikitexto a los recién llegados, mientras que la sustitución 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 plantillas macro.

• La sustitución en masa puede, en última instancia, acelerar el sitio, pero esto no es motivo para preferir la sustitución a la transclusión. No se preocupe por el rendimiento de los servidores de Wikipedia.
• Las plantillas se modifican o eliminan con frecuencia. Si una plantilla es un 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.

• Una vez que se sustituye una plantilla, el resultado ya no está vinculado a ella, lo que dificulta encontrar todas las páginas que muestran ese texto (aunque a veces las categorías pueden solucionar este problema). El problema se puede solucionar fácilmente incluyendo un vínculo a la plantilla en el código de la plantilla.
• Una plantilla sustituida no se actualizará cuando se corrijan 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 contenidos o un cuadro de navegación.
• Sustituir 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 de los volcados de base de datos.
• Una plantilla sustituida puede agregar mucho código wiki o HTML al artículo, perjudicando la accesibilidad para aquellos con menos conocimientos técnicos.
• 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 se va a utilizar solo temporalmente, normalmente es mejor no sustituirla, ya que las plantillas sustituidas son mucho más difíciles de eliminar o modificar.
• Cuando se sustituye una plantilla vandalizada, es más difícil repararla que un 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.

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 completa ; es posible que también sea necesario sustituir otras plantillas menos utilizadas; consulte la documentación de la plantilla para obtener más detalles.

• {{ No more links }} , al sustituir esto se inserta un comentario visible solo en el modo de edición, con una breve explicación para desalentar el envío de enlaces spam.

• {{ tmdesde }} , {{ tmhasta }}

Se deben sustituir todas las plantillas que aparecen en la categoría: Plantillas de advertencia para usuarios y la categoría: Plantillas de bienvenida . Esto no se aplica a las plantillas de la página de usuario.

Esta sección está vacía. Puedes colaborar con tus aportaciones.

• Las plantillas de firma de usuario, si se transcluyen, generan una carga excesiva en el servidor, ya que los cambios en una plantilla de usuario menor deben propagarse ampliamente. Si se utilizan, se deben sustituir por plantillas de firma de usuario. (Sin embargo, se debe tener en cuenta que no se recomiendan las plantillas de firma de usuario ).

Esta sección está vacía. Puedes colaborar con tus aportaciones.

Estas plantillas tienen un propósito y/o sintaxis que requieren que sean sustituidas.

• {{ afd }} , de lo contrario 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 renombrar o fusionar categorías.
• {{ copyvio }} , para que los artículos se incluyan en la lista de problemas de derechos de autor , se generará un mensaje de error si se incluye.
• {{ nld }} , para imágenes sin información sobre el estado de los derechos de autor, agrega {{ no license }} con la fecha de hoy completada automáticamente.
• {{ nrd }} , para imágenes sin justificación de uso justo , agrega {{ no reasone }} con la fecha de hoy completada automáticamente.
• {{ nsd }} , para imágenes sin información de origen, agrega {{ di-no source }} con la fecha de hoy completada automáticamente.
• {{ orfud }} , para imágenes de uso justo huérfanas "genéricas", agrega {{ di-orphaned fair use }} con la fecha de hoy completada automáticamente.
• {{ or-fu-re }} , para imágenes de uso justo que han quedado huérfanas en 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).
• {{ propuesta de eliminación }} , para la propuesta de eliminación, agrega {{ propuesta de eliminación/fechada }} con la fecha de hoy completada automáticamente.
• {{ movimiento solicitado }} , para solicitar movimientos de página
• {{ rfd }} , redirecciona para discusión
• {{ rfu }} , para imágenes de uso justo que deberían poder reemplazarse con una imagen con licencia gratuita, agrega {{ replaceable fair use }} , con la fecha de hoy completada automáticamente.
• {{ refu-c }} , utilizado en subtítulos de imágenes marcadas como uso justo 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 fue nominado para su eliminación.

Técnicamente no se deben sustituir plantillas que:

1. contienen llamadas a ParserFunctions ( #if, #switch, etc.), a menos que, cuando sea posible, estas también se sustituyan (ver mw:Manual:Substitution#Sustitución multinivel)
2. dejar algunos parámetros con sus valores predeterminados sin especificarlos, a menos que se utilice el mecanismo predeterminado alternativo
   
3. Contiene 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 #ifor #switchtextualmente en la ubicación subst y (B) deja construcciones como {{{1|default value}}}). Si el consenso
específico es eliminar una llamada particular de dicha plantilla, se puede usar Special:ExpandTemplates para expandir esa llamada a sintaxis wiki simple.

Esta es una lista de plantillas que no se deben sustituir, ya que contienen código de formato estándar, código complejo o código que falla si se sustituye.

• Varias plantillas de citas/referencias que contienen código condicional muy complejo (ver: WP:CITET ).
• {{ Curlie }} , consultas URL de directorios web externos (antes DMOZ).
• Plantillas de infobox , varias para facilitar la identificación de bots y la coherencia.
• {{ Javadoc:EE }} , {{ Javadoc:SE }} , {{ Javadoc:SE-guide }} , plantillas condicionales cuyo propósito es actualizar los enlaces cuando se actualiza la plantilla maestra.
• {{ ISP }} , {{ Openproxy }} , {{ repeat vandal }} , {{ SharedIP }} , {{ SharedIPEDU }} , {{ s/wnote }} , no mensajes a los usuarios (por lo que no hay problema si cambian de su forma original), por lo que no hay razón para sustituir, pero se aplican las razones estándar para no sustituir.
• {{ ln }} , {{ lnt }} , código complejo
• {{ Main }} , mantiene el formato estándar.
• {{ switch }} , también plantillas condicionales; la sustitución interrumpe el uso
• {{ Véase también }} , formato estándar para la lista véase también
• {{ selfref }} , no funciona cuando se sustituye, ya que está destinado a contener código diferente en los espejos.
• {{ Signpost-subscription }} , debe actualizarse semanalmente.
• Plantillas {{ stub }} , varias para simplificar su uso y eliminación
• {{ talkarchive }} , {{ archivo }}
• {{ tl }} , {{ tlp }} , {{ ttl }} , {{ ti }} , {{ tic }} , {{ tls }} , {{ cl }} , {{ ccl }} , muchas de ellas muy utilizadas, {{ tl }} con más de 7.190.000 transclusiones según el último recuento. Son más rápidas de escribir que sus sustituciones y, al no sustituirlas, los nuevos wikipedistas pueden aprender sobre ellas y poder usarlas.
• {{ sockpuppet }} y plantillas similares destinadas a ubicarse en la página de nivel superior en el espacio de usuario. (Nota: las advertencias y avisos en el espacio de discusión del usuario deben reemplazarse).

Tenga en cuenta también que algunas cosas pueden parecer plantillas, pero en realidad son palabras mágicas , como {{!}} y {{noexternallanglinks}} . Sustituirlas no generará ningún resultado o sustituirá una plantilla que las oculte (como la obsoleta Template:! ).

Estas plantillas, que se utilizan en el espacio principal, añaden un comentario sobre el motivo por el cual un artículo tiene un nombre incorrecto. Es posible que se eliminen a medida que mejoren las funciones de títulos de MediaWiki y que cambie la redacción y el diseño.

• {{ título correcto }}
• {{ minúscula }}

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 (sólo genera más trabajo eliminarlas).

• {{ catfd }}
• {{ ifd }} {{ ifd2 }} {{ idw }} {{ idw-uo }} {{ idw-cp }}
• {{ aviso de cfd }}
• {{ sfd-t }} {{ sfd-r }} {{ sfr-t }}
• {{ prod-2 }}
• y todo en la categoría:Plantillas de eliminación rápida
• {{ editprotected }} no está relacionado con la eliminación, pero también es temporal

Excepciones

Las siguientes plantillas deben sustituirse para que funcione correctamente:

• {{ afd }} {{ afd2 }} {{ afd3 }}
• {{ cfd }} {{ cfm }} {{ cfr }} {{ cfr-speedy }}
• {{ nld }} {{ nsd }}
• {{ prod }}
• {{ rfd }}
• {{ tfd2 }} {{ tfdnotice }}

Además, se deben sustituir aquellas plantillas que documentan un proceso de eliminación finalizado ( {{ afd top }} , etc.).

• {{ col-begin }} {{ col-2 }} { { col-3 }} {{ col-4 }} {{ col-end }}
• {{ Borrar }} , {{ Borrar izquierda }} {{ Borrar derecha }}
• {{ ed }} {{ ed2 }} {{ ed right }} {{ edit }} , simplifica la adición de un enlace de edición a las plantillas.
• {{ archivo superior }} {{ archivo inferior }} , {{ discusión superior }} {{ discusión inferior }}

Esta página está referenciada en el Glosario de Wikipedia .

• Ayuda:Sustitución
• meta:Ayuda:Sustitución, una página de ayuda más extensa y técnica en Meta
• Especial:ExpandTemplates (coloque la plantilla con los corchetes {{ }} en el cuadro "texto de entrada").
• Categoría:Plantillas sustituidas de Wikipedia
• {{ Subst only }} (ubicado en la {{ subpágina de documentación }} , no en las páginas de plantillas, de plantillas que necesitan ser sustituidas en lugar de transcluidas)
• AnomieBOT , un bot aprobado para sustituir ciertas plantillas.