Generalmente se utiliza en listas para proporcionar un enlace anotado utilizando la descripción breve de la página enlazada. Por ejemplo: en las secciones Ver también "los editores deben proporcionar una breve anotación cuando la relevancia de un enlace no es inmediatamente evidente, cuando el significado del término puede no ser conocido generalmente o cuando el término es ambiguo". De forma predeterminada, la descripción breve de la página enlazada se derivará de la plantilla responsable de configurar la descripción breve para esa página. Si no hay una plantilla presente en el wikitexto de la página, la descripción se derivará de Wikidata . Si no se puede obtener una descripción de Wikidata, no se agregará ninguna descripción breve. Este comportamiento se puede manipular y otras opciones de formato permiten la presentación de anotaciones útiles incluso sin una descripción breve, que aún puede estar disponible y, por lo tanto, mostrarse en una fecha posterior.{{short description}}
A algunas páginas se les asignan descripciones breves mediante métodos automáticos; las plantillas que generan descripciones breves incluyen cuadros de información que utilizan los datos proporcionados a sus parámetros para crear una descripción breve adecuada, que puede anular otras descripciones breves que existan para la página o en la misma. El módulo responsable de obtener la descripción actualmente no puede detectar ni determinar este tipo de descripción breve creada dinámicamente.
Esta plantilla no debe utilizarse para anotar enlaces en páginas de desambiguación. La discusión pertinente se encuentra en Wikipedia discusión:Desambiguación/Archivo 50 § Uso de enlaces anotados y concluye:
El uso más básico es:
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
{{ Annotated link | Wikipedia }}El texto que se muestra para el enlace se puede canalizar si se desea o se requiere:
{{ Annotated link | Wikipedia:Policies and guidelines | Policies and guidelines }}{{ Annotated link | Mona Lisa | ''Mona Lisa'' }}Hay opciones de formato en idioma extranjero disponibles para el texto del enlace; consulte a continuación.
Si el formato de la lista no es adecuado para separar con guiones el enlace de la descripción, se puede reemplazar por algo adecuado:
{{ Annotated link | Wikipedia:Policies and guidelines | Policies and guidelines | , }}Los ejemplos anteriores utilizan los parámetros 1 a 3 sin nombre. Los parámetros también pueden tener nombre o estar numerados explícitamente:
{{ Annotated link | 1=Wikipedia:Policies and guidelines | 2=Policies and guidelines | 3=, }}{{ Annotated link | name=Wikipedia:Policies and guidelines | display=Policies and guidelines | dash=, }}Hay muchas configuraciones posibles más allá de esto, como se describe a continuación, y la mayoría de los parámetros tienen alias.
Hay muchos parámetros disponibles, desglosados en las siguientes secciones:
Los enlaces a las plantillas se formatearán automáticamente como se espera de {{ template link }} :
{{ Annotated link | Template:Annotated link }}El formato esperado se puede aplicar agregando :{{template link expanded}}|template_link=code
{{ Annotated link | Template:Annotated link | template_link=code }}{{Annotated link}} – plantilla utilizada para mostrar y anotar un wikilink utilizando la descripción corta de la página vinculadaSi se determina que este formato no es apropiado para las circunstancias, utilice |template_link=nopara desactivarlo:
{{ Annotated link | Template:Annotated link | template_link=no }}Si el formato del enlace de plantilla está deshabilitado, use el segundo parámetro |2=o |display=para afectar la visualización del texto:
{{ Annotated link | Template:Annotated link | Annotated link | template_link=no }}Algunos títulos de obras , como los títulos de canciones , deben ir entre comillas dobles; este formato se puede aplicar utilizando |quote=yes:
{{ Annotated link | The Partisan | quote=yes }}Si se desea , se puede añadir una abreviatura entre paréntesis después del enlace utilizando |abbr=:
{{ Annotated link | London Academy of Music and Dramatic Art | abbr=LAMDA }}Se puede proporcionar un título para la abreviatura, |abbr_title=si es adecuado:
{{ Annotated link | London Academy of Music and Dramatic Art | abbr=LAMDA | abbr_title=London Academy of Music and Dramatic Art }}Se puede agregar un nombre alternativo para la entidad vinculada después del enlace (y una abreviatura si también se agregó) utilizando |aka=si se desea; el nombre alternativo se antepondrá con ", también conocido como":
{{ Annotated link | Royal National Theatre | aka=the National Theatre of Great Britain }}Hay opciones de formato de idioma extranjero disponibles para este parámetro; consulte a continuación.
Se puede incluir incluso más información entre la información indicada anteriormente y la de la siguiente descripción; utilice |wedge=para agregarla si lo desea:
{{ Annotated link | Grape | wedge=can be used to make wine }}Hay opciones de formato de idioma extranjero disponibles para este parámetro; consulte a continuación.
El texto en idioma extranjero debe formatearse de acuerdo con MOS:OTHERLANG ; esta plantilla proporciona todas las opciones necesarias para controlar el formato. El módulo invocado por esta plantilla utiliza Module:Lang (el módulo que alimenta a ) para realizar el formato, y todas las opciones se describen en detalle en sus páginas de documentación.{{lang}}
Si el texto del enlace está en un idioma extranjero (el criterio del editor determina si esto es apropiado); controle el formato con: |link_lang=<language code>, |link_lang_italic=, |link_lang_nocat=, |link_lang_size=, |link_lang_cat=y|link_lang_rtl=
Si el |aka=texto es de un idioma extranjero (de nuevo, a discreción del editor); controle el formato con: |aka_lang=<language code>, |aka_lang_italic=, |aka_lang_nocat=, |aka_lang_size=, |aka_lang_cat=,|aka_lang_rtl=
Si el |wedge=texto es de un idioma extranjero (de nuevo, a discreción del editor); controle el formato con: |wedge_lang=<language code>, |wedge_lang_italic=, |wedge_lang_nocat=, |wedge_lang_size=, |wedge_lang_cat=,|wedge_lang_rtl=
Esta plantilla invoca el módulo Module:Annotated link , que a su vez utiliza el módulo Module:GetShortDescription para (como sugiere el nombre) obtener la descripción corta. Puede devolver una descripción de Wikidata en un idioma extranjero (es decir, no en ) (de nuevo, a discreción del editor). Si se muestra, el código de idioma apropiado se establecerá automáticamente, pero todos los demás parámetros de {{lang}}están disponibles para afectar el formato de la descripción devuelta:
Utilice |desc_lang_italic=, |desc_lang_nocat=, |desc_lang_size=, |desc_lang_cat=y |desc_lang_rtl=. Si el editor determina que {{lang}}el formato de la descripción no es apropiado, se puede desactivar con |desc_lang_no=yes.
Aunque éste no es un ejemplo realista, proporciona una descripción general de este manejo:
{{ Annotated link | Template:GetShortDescription/explicit short description | La page de test de Fred | aka=フレッドのテストページ | aka_lang=ja | link_lang=fr | wedge=Leathanach tástála Fred | wedge_lang=ga |template_link=no }}Si se proporciona un valor para |only=o , |prefer=la búsqueda se realizará solo o con preferencia por la descripción indicada. Si no se encuentra ninguna descripción, el resultado será que no se agregará ninguna descripción al enlace (ni a ninguna otra información proporcionada), a menos que se proporcione una alternativa.
Al indicar |only=explicitse limitará la búsqueda únicamente a descripciones breves establecidas mediante el uso de {{short description}}la página vinculada.
{{ Annotated link | Wikipedia | only=explicit }}Al indicarlo |only=wikidatase limitará la búsqueda únicamente a las descripciones de Wikidata.
{{ Annotated link | Wikipedia | only=wikidata }}Indica |prefer=explicitque se debe utilizar la descripción corta explícita si está disponible, o intenta utilizar la descripción de Wikidata si no está disponible.
{{ Annotated link | Wikipedia | prefer=explicit }}Indica |prefer=wikidataque se utilizará la descripción de Wikidata si está disponible, o intenta usar una descripción breve y explícita si no la tienes.
{{ Annotated link | Wikipedia | prefer=wikidata }}Si |fallback=se proporciona un valor y la ruta expresada no encuentra ninguna descripción, la descripción adjunta será el valor de respaldo indicado.
{{ Annotated link | Example | only=explicit | fallback=a fallback description }}Las descripciones breves en Wikipedia deben tener la primera letra en mayúscula. De forma predeterminada, las descripciones breves recuperadas por esta plantilla se muestran tal como se escriben en la página de la que se extraen, pero esto se puede anular si es necesario utilizando |desc_first_letter_case=uppero |desc_first_letter_case=lower.
TemplateData para enlace anotado
El módulo GetShortDescription puede generar advertencias sobre problemas detectados con {{short description}}las configuraciones, que se muestran sobre el contenido de la vista previa durante la edición. Estas advertencias no se refieren a la página que se está editando, sino a las páginas para las que se están creando los enlaces anotados. Si se muestran advertencias de vista previa, considere visitar las páginas indicadas para analizar y posiblemente solucionar los problemas.
También puede mostrar mensajes alarmantes (son de color rojo pero no necesariamente errores) sobre su función. Si no está claro cómo solucionar el problema indicado, no continúe intentando anotar el enlace con esta plantilla, ya que los mensajes serán visibles para todos los lectores de Wikipedia. Si se muestran mensajes alarmantes en páginas guardadas como resultado de problemas, la página que muestra esos mensajes se agregará a la categoría de mantenimiento:Páginas que muestran mensajes alarmantes sobre Módulo:GetShortDescription .
Módulo:Enlace anotado también puede mostrar mensajes alarmantes sobre su función y, de la misma manera, agregará páginas a Categoría:Páginas que muestren mensajes alarmantes sobre Módulo:Enlace anotado .
Existen otras categorías de mantenimiento para posibles problemas con las anotaciones:
|space_cat=noa {{annotated link}}para desactivar la categorización. Si la descripción no es adecuada, el editor interesado puede intentar corregirla en la fuente, utilizar |only=para seleccionar potencialmente otra descripción o eliminar el uso de esta plantilla y crear una anotación personalizada para el enlace manualmente.|only=wikidatao |prefer=wikidata). Pueden ser adecuadas o no y este es un tema de constante consideración y discusión. Considere revisar las instancias.Está disponible una herramienta útil para encontrar intersecciones de categorías.
{{AnnotatedListOfLinks}}– envuelve {{ Annotated link }} alrededor de varios enlaces a la vez{{Annotated biography link}}– una versión de esta plantilla diseñada para listas de biografías{{laal}}– muestra los enlaces a las páginas de un artículo junto con su breve descripción