Normalmente 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 sea evidente de inmediato, cuando el significado del término no sea generalmente conocido o cuando el término sea ambiguo". De forma predeterminada, la descripción breve de la página vinculada se derivará de la plantilla responsable de configurar la descripción breve para esa página. Si una plantilla no está en uso en la página, la descripción se derivará de Wikidata . Si no se puede obtener una descripción de Wikidata, no se adjuntará ninguna descripción breve. Este comportamiento se puede manipular y otras opciones de formato permiten la presentación de anotaciones útiles incluso sin una breve descripción, que aún pueden estar disponibles 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 existen para o en la página. 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 usarse para anotar enlaces en páginas de desambiguación. La discusión relevante está en la charla de Wikipedia: 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 es necesario:
{{ Annotated link | Wikipedia:Policies and guidelines | Policies and guidelines }}{{ Annotated link | Mona Lisa | ''Mona Lisa'' }}Hay opciones de formato de idioma extranjero disponibles para el texto del enlace; vea abajo.
Si el formato de la lista no es adecuado para separar el enlace de la descripción con guiones , se puede reemplazar por algo adecuado:
{{ Annotated link | Wikipedia:Policies and guidelines | Policies and guidelines | , }}Los ejemplos anteriores utilizan los parámetros sin nombre 1–3. Los parámetros también se pueden nombrar o numerar 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 esta, que se describen a continuación, y la mayoría de los parámetros tienen alias.
Hay muchos parámetros disponibles, divididos en las siguientes secciones:
Los enlaces a las plantillas tendrán el formato automático esperado por {{ template link }}:
{{ Annotated link | Template:Annotated link }}Se puede aplicar el formato esperado agregando :{{template link expanded}}|template_link=code
{{ Annotated link | Template:Annotated link | template_link=code }}{{Annotated link}} – plantilla utilizada para mostrar y anotar un enlace wiki utilizando la breve descripción de la página vinculadaSi se determina que este formato es inadecuado para las circunstancias; utilizar |template_link=nopara desactivarlo:
{{ Annotated link | Template:Annotated link | template_link=no }}Si el formato del enlace de la 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 usando |quote=yes:
{{ Annotated link | The Partisan | quote=yes }}Se puede agregar una abreviatura entre paréntesis siguiendo el enlace usando, |abbr=si lo desea:
{{ Annotated link | London Academy of Music and Dramatic Art | abbr=LAMDA }}|abbr_title=Si procede, se podrá proporcionar un título para la abreviatura :
{{ 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 siguiendo el vínculo (y una abreviatura si también se agrega) usando |aka=si se desea; el nombre alternativo irá precedido de ", 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; vea abajo.
Es posible que haya aún más información intercalada entre la información indicada anteriormente y la de la descripción potencialmente siguiente; use |wedge=para agregar lo que desee:
{{ Annotated link | Grape | wedge=can be used to make wine }}Hay opciones de formato de idioma extranjero disponibles para este parámetro; vea abajo.
El texto en idioma extranjero debe tener el formato 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 ) para realizar el formateo, y todas las opciones se describen detalladamente en sus páginas de documentación.{{lang}}
Si el texto del enlace es de un idioma extranjero (el editor determina si esto es apropiado); controlar 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 (nuevamente, a discreción del editor); controlar 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 (nuevamente, a discreción del editor); controlar 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 Module:Annotated link , que a su vez utiliza Module:GetShortDescription para (como sugiere el nombre) obtener la descripción breve. Puede devolver una descripción de Wikidata en un idioma extranjero (es decir, no en ) (nuevamente, 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 {{lang}}están disponibles para afectar el formato de la descripción devuelta:
Utilice |desc_lang_italic=, |desc_lang_nocat=, y .|desc_lang_size= Si el editor determina que el formato de la descripción no es apropiado; se puede desactivar con .|desc_lang_cat=|desc_lang_rtl={{lang}}|desc_lang_no=yes
Aunque este no es un ejemplo realista; proporciona una descripción general de este manejo:
{{ Annotated link | User:Fred Gandt/sandbox/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 }}Proporcionar un valor para |only=o |prefer=afectará la búsqueda para que sea 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 un recurso alternativo.
Indicar |only=explicitlimitará la búsqueda solo a descripciones breves establecidas mediante el uso de {{short description}}en la página vinculada.
{{ Annotated link | Wikipedia | only=explicit }}La indicación |only=wikidatalimitará la búsqueda solo a descripciones de Wikidata.
{{ Annotated link | Wikipedia | only=wikidata }}Indique |prefer=explicitutilizar la descripción breve explícita si está disponible, o intente con la descripción de Wikidata si no.
{{ Annotated link | Wikipedia | prefer=explicit }}Indique |prefer=wikidatautilizar la descripción de Wikidata si está disponible, o intente obtener una descripción breve explícita si no está disponible.
{{ Annotated link | Wikipedia | prefer=wikidata }}Si |fallback=se proporciona un valor y no se encuentra ninguna descripción en la ruta expresada, la descripción adjunta será el valor alternativo indicado.
{{ Annotated link | Example | only=explicit | fallback=a fallback description }}Las descripciones breves en Wikipedia deben formatearse con una primera letra mayúscula, pero la aplicación típica de esta plantilla requerirá que el primer carácter esté en minúscula. Por defecto; el módulo invocado por esta plantilla garantizará que todas las descripciones breves recuperadas por Module:GetShortDescription se transformen para comenzar con una primera letra minúscula, pero esto puede anularse si es necesario usando |desc_first_letter_case=uppero |desc_first_letter_case=lower.
TemplateData para enlace anotado
Módulo:GetShortDescription puede crear advertencias sobre problemas detectados con {{short description}}las configuraciones, que se muestran encima del 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 crean los enlaces anotados. Si se muestra alguna advertencia de vista previa; considere visitar las páginas indicadas para analizar y posiblemente solucionar los problemas.
También puede mostrar mensajes alarmantes (son rojos pero no necesariamente errores) sobre su funcionamiento. Si no queda claro cómo solucionar el problema indicado; No sigas 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 el 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 muestran 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 deshabilitar la categorización. Si la descripción no es apropiada; el editor interesado puede intentar arreglarlo en la fuente, usarlo |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 adecuados o no y esto es una cuestión de consideración y discusión continua. Considere revisar las instancias.Está disponible una herramienta útil para encontrar intersecciones de categorías.
{{AnnotatedListOfLinks}}– envuelve {{ Enlace anotado }} alrededor de varios enlaces a la vez{{laal}}– muestra los enlaces de página de un artículo junto con su breve descripción