Cuando se sustituye, AnnotatedListOfLinks envuelve la plantilla alrededor de los enlaces wiki no anotados en una lista. Está diseñado para evitar saturar las descripciones existentes, de modo que se pueda colocar alrededor de contenido mixto sin demasiadas preocupaciones. Una excepción notable es la pérdida de comentarios de estilo HTML. El uso común esperado es actualizar rápidamente las secciones "Ver también" asegurándose de respetar las ediciones manuales anteriores. {{Annotated link}}
Uso
{{ subst : AnnotatedListOfLinks | <!-- wikitexto mixto (incluye encabezados, comentarios, plantillas) -->== Ver también =={{ Portal | ejemplo }}
* [[ Enlaces estándar ]]
* [[ Enlaces canalizados | Canalizadores ]]
* [[ Enlaces genéricos ]] - enlaces que requieren más contexto que solo el texto* {{ Enlace anotado | Buenos artículos }}
* [[ Más enlaces ]]
* [[ Archivo : Some_photo_from_1944 ]] <!-- aunque el ejemplo de Archivo: sería inusual -->
Prosa de seguimiento con [[ enlaces incrustados ]] a otras cosas. }}Cuando se aplica como se indica arriba, el wikitexto resultante es el siguiente:
== Ver también == {{ Portal | ejemplo }} * {{ Enlace anotado | Enlaces estándar }} * {{ Enlace anotado | Enlaces canalizados | Canalizadores }} * [[ Enlaces genéricos ]] - enlaces que requieren más contexto que solo el texto * {{ Enlace anotado | Buenos artículos }} * {{ Enlace anotado | Más enlaces }} * [[ Archivo : Some_photo_from_1944 ]]
Prosa de seguimiento con [[ enlaces integrados ]] a otras cosas.El resultado neto es que se han actualizado tres enlaces para utilizar la plantilla, se han eliminado dos comentarios de estilo HTML y el otro wikitexto ha permanecido sin cambios.{{Annotated link}}
Consejos
- Mantenga las actualizaciones limitadas
- No rodee una página entera si no es necesario. Si hay errores imprevistos (como comentarios importantes perdidos), serán más limitados si usa esta opción solo donde sea realmente necesaria. Mantener las actualizaciones limitadas también acelera un poco las cosas. Además, no existe un equivalente de edición inversa para cambiar los enlaces anotados a enlaces de corchetes normales, lo que significa que la forma más rápida de deshacer el daño accidental causado con esta plantilla es una reversión.
- Vista previa y mostrar cambios
- Es posible que no te des cuenta de lo que estás cambiando y lo que no sin echar un vistazo rápido a los resultados de "Mostrar cambios" que muestran los cambios del wikitexto que se deben realizar. Vuelve a comprobarlo y obtén una vista previa de la página para estar seguro.
- Deje un resumen de edición útil
- Esta plantilla no explica el motivo de los cambios que realiza; ese es tu trabajo. Puede que te resulte útil incluir un enlace a uno o más de estos, según tu criterio: Template:Anl , WP:WPSD , WP:HOWTOSD .
- Escribe las descripciones que faltan
- Después de usar esta plantilla, considere visitar las páginas que no muestran una descripción WP:Short a pesar de que ya están envueltas con . Completar las descripciones faltantes es una manera fácil de ayudar a otros editores a comprender lo que hace la plantilla. También ayuda mucho a WP:WPSD .
{{Annotated link}}
Qué actualiza
Esta plantilla solo actualiza un enlace si se cumplen todos estos criterios
- El enlace es un elemento de lista desordenada que puede estar sangrado o no.
- Lo único que hay en el elemento de la lista es un enlace wiki entre corchetes que puede canalizarse.
- El enlace no tiene un identificador de espacio de nombres (es decir,
[[Special: Random]]no se cambiará). - El enlace no hace uso de trucos de Pipe
- El título vinculado tiene más de un carácter (es decir, no es un enlace al artículo titulado
[[T]])
Los enlaces que cumplen con esos criterios se actualizan independientemente de si el artículo de destino ya tiene un WP:WPSD o no, con el entendimiento de que cuando se agrega uno, la plantilla lo representará correctamente. Esto significa que algunas ediciones con esta plantilla inicialmente parecerán no tener efecto. Puede solucionar esto visitando cualquier artículo que necesite una descripción y escribiéndola para la página de destino. También tenga en cuenta que los enlaces que apuntan a páginas de redireccionamiento se actualizarán, pero pueden mostrar un WP:WPSD diferente al de la página de destino, ya que cada uno puede tener su propia descripción. Esto puede ser confuso para los editores que verifican la coherencia de la descripción general entre los enlaces anotados y su destino, pero generalmente no es un problema para los lectores, ya que los artículos no incluyen la descripción como parte del contenido representado. Los lectores, en otras palabras, solo verán la descripción general de la página de redireccionamiento, no de la página de destino.{{Annotated link}}
- Comentarios en estilo HTML
Los comentarios que se envíen a través de esta plantilla se eliminarán y deberán volver a agregarse manualmente en una edición posterior si se desea. Alternativamente, reubique los comentarios importantes fuera de la plantilla antes de la sustitución para conservarlos.
Lo que NO actualiza
Es poco probable que esto cambie
- Todo lo que esté en la misma línea que esta llamada de plantilla: en general, mantenga la llamada de apertura a esta plantilla y la llamada de cierre en dos líneas separadas y dedicadas encima y debajo del wikitexto que debe actualizarse.
- Listas ordenadas : actualmente se evitan por precaución. El orden implica que los editores han hecho un esfuerzo para gestionar la presentación de la lista, por lo que esta plantilla intenta no interferir.
- Enlaces redireccionados (tipo de): Esta plantilla envolverá los enlaces a las redirecciones pero no los redireccionará al destino (es decir, no inyectará el nombre canónico apropiado) y no extraerá el WP:WPSD del destino de la redirección si difiere del SD en la página de redirección en sí, incluso si la página de redirección tiene una descripción vacía. Las redirecciones pueden tener sus propias descripciones WP:Short y esa descripción naturalmente se vería favorecida si el editor que escribió el enlace eligiera usar un título redirigido en lugar del título canónico del destino.
- Enlaces que apunten fuera del espacio de nombres del artículo: aunque las descripciones breves de WP se utilizan de forma limitada en otros espacios de nombres, el contenido del artículo no debería vincularse normalmente a esas páginas. En los pocos casos en los que sí lo hace, es probable que no sean necesarias las descripciones breves.
- Enlaces que contienen dos puntos (
:) en el texto de destino o sustituido: buscar dos puntos es el mecanismo utilizado para evitar cambiar los enlaces de espacios de nombres que no sean de artículos. - Enlaces que comparten la ubicación de un elemento de lista con cualquier otra cosa: esto incluye el formato wiki, como los enlaces en negrita, pero de todos modos rara vez son coherentes con WP:MOS . También incluye enlaces que usan extensiones como Vintage cars (observe la "s" agregada al final) y líneas con más de un enlace.
- Enlaces que utilizan el truco de la tubería o el truco de la tubería inversa: las pruebas parecen indicar que los trucos de la tubería se sustituyen cuando se guardan las ediciones. Si es así, la única vez que deberías encontrarte con estos es cuando intentas sustituir esta plantilla y utilizar trucos de la tubería dentro del wikitexto adjunto. Una forma sencilla de evitarlo es separar tus ediciones en dos: una para añadir un enlace con truco de la tubería y una continuación para anotar todos los enlaces de la lista.
¿Por qué debería sustituirse esto?
La transclusión de esta plantilla no tiene ningún efecto. Sería técnicamente posible escribir la plantilla de tal manera que lograra lo mismo utilizando la transclusión, pero esto se evitó principalmente en un esfuerzo por tomar prestado el WP:Principio del menor asombro para su uso en el contexto de la edición de wikitexto. Es inusual que las plantillas realicen un análisis selectivo del wikitexto, que es esencialmente lo que hace esta: se analizan ciertos enlaces y otros no. Esto puede llevar a que los editores modifiquen el wikitexto utilizado dentro de la plantilla y vean resultados inesperados. El uso de la sustitución permite que el código de la plantilla coloque las plantillas específicamente donde se necesitan, dejando en claro qué partes de la fuente del wikitexto se están complementando y cuáles no. {{Annotated link}}
Otro beneficio de la sustitución es la coherencia de visualización con la plantilla "Enlace anotado". La transclusión requeriría volver a implementar la representación de las descripciones de WP:Short en la salida HTML y, a largo plazo, podría generar ligeras diferencias entre los enlaces representados con esta plantilla y con los enlaces anotados individuales. La sustitución evita esa posible desviación.
Por último, la sustitución reduce la carga de familiaridad que supone para los futuros editores de wikitexto. La sustitución de la plantilla no deja rastro del nombre de la misma en la edición posterior. Aunque suene problemático, en realidad tiene un beneficio sutil: aunque los editores que utilizan esta plantilla necesitan saber lo que hace, los editores que se encuentran con los resultados de esta plantilla sólo necesitan tener conocimiento de ella para entender el resultado final. En efecto, ayuda a dirigir a otros editores de wikitexto a esa plantilla en lugar de a esta. {{Annotated link}}
Limitaciones
- Los comentarios de estilo HTML se eliminarán. Es posible que esto no cambie nunca. Tenga cuidado al colocar esta plantilla cerca de comentarios útiles en el wikitexto, ya que se eliminarán. Es particularmente difícil ver esto, ya que los comentarios no aparecen en la página en modo de vista previa por diseño . Sin embargo, puede ver este cambio antes de que sea definitivo utilizando el botón "Mostrar cambios" en el editor de wikitexto.
- Solo funciona en la Wikipedia en inglés. No intentes usar esta plantilla en otra wiki que no sea la Wikipedia en inglés (es decir, copiar el código allí), ya que no tendrá ningún efecto a menos que WP:Short descriptions se vuelva de uso común allí. Hasta entonces, solo estás perdiendo el tiempo.
- Hay algunas cosas mencionadas anteriormente que esta plantilla no actualizará.
Solución de problemas
- El artículo de destino tiene un WP:WPSD pero no se muestra
- Probablemente se trate de un caso de enlace redirigido. En el caso de los enlaces redirigidos, la descripción general del artículo de destino no se recupera automáticamente mediante . La página de redirección real también debe tener su propia descripción o se registrará como en blanco. Generalmente, esto es lo que se prefiere porque las descripciones pueden variar levemente en la elección de palabras que mejor describen el mismo tema con nombres alternativos.
{{Annotated link}} - ¿Por qué no actualizó algún enlace?
- Si no está cubierto anteriormente, puede ser útil revisar los casos de prueba del módulo .
Historia
- En una discusión relevante de mayo de 2021 sobre la extensión de las descripciones breves se abordó su utilidad en las secciones "Ver también" de la enciclopedia. Véase: Wikipedia discusión:Descripción breve/Archivo 9#Pero ¿qué pasa con wp:think of the reader?
- Esta fue la primera edición en vivo realizada con esta plantilla (alojada en el espacio del usuario en ese momento). Esta edición no tuvo un efecto visible en el contenido de la página renderizada porque ninguna de las páginas vinculadas tenía descripciones breves escritas. Sin embargo, sigue siendo una edición útil y productiva porque las futuras descripciones breves se expondrán automáticamente en el artículo de destino sin actualizaciones adicionales.
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}