Plantilla:Enlace anotado

Documentación de plantilla [ ver ] [ editar ] [ historial ] [ purgar ]

Esta plantilla se utiliza en aproximadamente 10 000 páginas y los cambios pueden notarse ampliamente. Pruebe los cambios en las subpáginas /sandbox o /testcases de la plantilla , o en su propia subpágina de usuario . Considere discutir los cambios en la página de discusión antes de implementarlos.

Esta plantilla utiliza Lua :

Módulo: Enlace anotado ( sandbox )

Atajos

{{ anl }}
{{ anli }}

Uso

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 evidente de inmediato, cuando el significado del término puede no ser conocido por todos 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 de 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 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 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:

Contienen un formato que no está en línea con el formato establecido desde hace tiempo para las entradas de desambiguación en MOS:DAB .
El texto de las descripciones con frecuencia no es óptimo para las páginas de desambiguación, ya que puede no ser distintivo ni conciso.
Eliminarían el control del texto de la propia página de desambiguación y permitirían que las páginas de desambiguación se modificaran sin que aparecieran en el historial de edición de la propia página o en las notificaciones relacionadas con la página. (Esta razón no se puede solucionar y es razón suficiente para no utilizar la plantilla ni ninguna modificación de la misma).

Básico

El uso más básico es:

Margen: {{Annotated link|Wikipedia}}

Resultado: Wikipedia – Enciclopedia gratuita en línea de colaboración colectiva

El texto que se muestra para el enlace se puede canalizar si se desea o se requiere:

Margen: {{Annotated link|Wikipedia:Policies and guidelines|Policies and guidelines}}

Resultado: Políticas y directrices – Política de procedimiento de Wikimedia

Margen: {{Annotated link|Mona Lisa|''Mona Lisa''}}

Resultado: Mona Lisa – Pintura de Leonardo da Vinci

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:

Margen: {{Annotated link|Wikipedia:Policies and guidelines|Policies and guidelines|,}}

Resultado: Políticas y directrices , Política de procedimiento de Wikimedia

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:

Margen: {{Annotated link|1=Wikipedia:Policies and guidelines|2=Policies and guidelines|3=,}}

Margen: {{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.

Extendido

Hay muchos parámetros disponibles, desglosados en las siguientes secciones:

Enlaces de plantilla

Los enlaces a las plantillas se formatearán automáticamente como se espera de {{ template link }} :

Margen: {{Annotated link|Template:Annotated link}}

Resultado: {{Enlace anotado}} – plantilla utilizada para mostrar y anotar un enlace wiki utilizando la descripción breve de la página vinculadaPáginas que muestran descripciones de wikidata como alternativa

El formato esperado se puede aplicar agregando :{{template link expanded}}|template_link=code

Margen: {{ Annotated link | Template:Annotated link | template_link=code }}

Resultado: {{Annotated link}} – plantilla utilizada para mostrar y anotar un enlace wiki utilizando la descripción corta de la página vinculadaPáginas que muestran descripciones de wikidata como alternativa

Si se determina que este formato no es apropiado para las circunstancias, utilice |template_link=nopara desactivarlo:

Margen: {{ Annotated link | Template:Annotated link | template_link=no }}

Resultado: Plantilla:Enlace anotado: plantilla utilizada para mostrar y anotar un enlace wiki utilizando la descripción breve de la página vinculada.Páginas que muestran descripciones de wikidata como alternativa

Si el formato del enlace de plantilla está deshabilitado, use el segundo parámetro |2=o |display=para afectar la visualización del texto:

Margen: {{ Annotated link | Template:Annotated link | Annotated link | template_link=no }}

Resultado: Enlace anotado: plantilla utilizada para mostrar y anotar un enlace wiki utilizando la descripción breve de la página vinculadaPáginas que muestran descripciones de wikidata como alternativa

Citando títulos de enlaces

Algunos títulos de obras , como los títulos de canciones , deben ir entre comillas dobles; este formato se puede aplicar utilizando |quote=yes:

Margen: {{ Annotated link | The Partisan | quote=yes }}

Resultado: « The Partisan » – canción de 1943 de Anna Marly y Emmanuel d'Astier, popularizada por Leonard Cohen en 1969

Abreviatura adicional

Si se desea, se puede añadir una abreviatura entre paréntesis después del enlace utilizando |abbr=:

Margen: {{ Annotated link | London Academy of Music and Dramatic Art | abbr=LAMDA }}

Resultado: London Academy of Music and Dramatic Art ( LAMDA ) – Escuela de arte dramático en Hammersmith, Londres

Se puede proporcionar un título para la abreviatura, |abbr_title=si es adecuado:

Margen:

{{ Annotated link | London Academy of Music and Dramatic Art | abbr=LAMDA | abbr_title=London Academy of Music and Dramatic Art }}

Resultado: London Academy of Music and Dramatic Art ( LAMDA ) – Escuela de arte dramático en Hammersmith, Londres

Nombre alternativo adicional

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":

Margen: {{ Annotated link | Royal National Theatre | aka=the National Theatre of Great Britain }}

Resultado: Royal National Theatre , también conocido como Teatro Nacional de Gran Bretaña – Teatro en Londres, Inglaterra

Hay opciones de formato de idioma extranjero disponibles para este parámetro; consulte a continuación.

Información adicional

Se puede incluir incluso más información entre la información indicada anteriormente y la de la siguiente descripción; utilice el siguiente método |wedge=para agregarla si lo desea:

Margen: {{ Annotated link | Grape | wedge=can be used to make wine }}

Resultado: Uva , que se puede utilizar para hacer vino – Fruto que crece en vides leñosas en racimos

Hay opciones de formato de idioma extranjero disponibles para este parámetro; consulte a continuación.

Texto en idioma extranjero

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}}

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:

Margen:

{{ 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 }}

Resultado: La página de test de Fred , también conocida comoフレッドのテストページ, Leathanach tástála Fred – Breve descripción explícita

Controlar la búsqueda de una descripción breve

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}}en la página vinculada.

Margen: {{ Annotated link | Wikipedia | only=explicit }}

Resultado: Wikipedia – Enciclopedia gratuita en línea de colaboración colectiva

Al indicarlo |only=wikidatase limitará la búsqueda únicamente a las descripciones de Wikidata.

Margen: {{ Annotated link | Wikipedia | only=wikidata }}

Resultado: Wikipedia – enciclopedia libre multilingüe en línea

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.

Margen: {{ Annotated link | Wikipedia | prefer=explicit }}

Resultado: Wikipedia – Enciclopedia gratuita en línea de colaboración colectiva

Indica |prefer=wikidataque se utilizará la descripción de Wikidata si está disponible, o intenta utilizar una descripción breve y explícita si no la tienes.

Margen: {{ Annotated link | Wikipedia | prefer=wikidata }}

Resultado: Wikipedia – enciclopedia libre multilingüe en línea

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.

Margen: {{ Annotated link | Example | only=explicit | fallback=a fallback description }}

Resultado: Ejemplo : una descripción alternativa

Controlar el uso de mayúsculas y minúsculas del primer carácter de una descripción breve

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.

Parámetros

Estos son los TemplateData de esta plantilla que utilizan TemplateWizard, VisualEditor y otras herramientas. Consulte un informe de uso de parámetros mensual para el enlace Template:Annotated en artículos según sus TemplateData.

TemplateData para enlace anotado

Tabla de todos los parámetros de plantilla, alias, valores esperados y requeridos

un enlace creado y anotado usando una breve descripción y otras adiciones opcionales

Parámetros de plantilla [ Editar datos de plantilla ]
Parámetro		Descripción	Tipo	Estado
Nombre de la página (incluido el espacio de nombres)	`1` `name` `title`	Título de la página que se vinculará y anotará	Nombre de la página	requerido
Texto de visualización del enlace	`2` `display` `disp`	El texto que se mostrará en el enlace Por defecto nombre	Línea	opcional
Separador	`3` `dash` `comma`	Reemplace el tablero con otra cosa Por defecto – Ejemplo ,	Línea	opcional
Formato de enlace de plantilla	`template_link` `template-link` `tl`	Deshabilitar el formato especial de los enlaces a páginas en el espacio de nombres de la plantilla Valores sugeridos `no` `code`	Línea	opcional
Enlaces de citas	`quote` `quote_link` `quote-link` `ql`	Doble cita del enlace Valores sugeridos `yes`	Línea	opcional
Abreviatura	`abbr` `abbreviation`	Abreviatura que se mostrará entre paréntesis después del enlace.	Línea	opcional
Título abreviado	`abbr_title` `abbr-title` `abbreviation_title` `abbreviation-title` `at`	Proporcionar un título para una abreviatura	Línea	opcional
También conocido como	`aka`	Nombres alternativos para mostrar después del enlace (y abreviatura si se proporciona)	Línea	opcional
Información adicional	`wedge` `insert` `extra`	Información adicional para mostrar después del enlace (y abreviatura y alias si se proporcionan)	Línea	opcional
Descripción primera letra en mayúscula	`desc_first_letter_case` `desc-first-letter-case` `desc_case` `desc-case` `case`	Control de mayúsculas y minúsculas de la primera letra de una descripción breve Valores sugeridos `upper` `lower` Por defecto más bajo	Línea	opcional
Categorización de descripciones sin espacio	`space_cat` `space-cat`	Deshabilitar la categorización de páginas que muestran descripciones que no contienen caracteres de espacio Valores sugeridos `no`	Línea	opcional
Búsqueda de descripción de límites	`only`	Dictar la única fuente para una descripción breve Valores sugeridos `explicit` `wikidata`	Línea	opcional
Preferencia de descripción	`prefer`	Sugiera una fuente preferida para una descripción breve Valores sugeridos `explicit` `wikidata` Por defecto explícito	Línea	opcional
Descripción de respaldo	`fallback`	Proporcionar una descripción alternativa en caso de que no haya otra disponible	Línea	opcional
Texto del enlace código de idioma extranjero	`link_lang` `link-lang` `ll`	Proporcionar un código de idioma para el texto del enlace en idioma extranjero Ejemplo Sí	Línea	opcional
Texto del enlace en idioma extranjero en cursiva	`link_lang_italic` `link-lang-italic` `lli`	Controlar la presentación en cursiva del texto del enlace en idioma extranjero Valores sugeridos `yes` `no` `unset` `invert` `default`	Línea	opcional
Texto del enlace de categorización de idioma extranjero	`link_lang_nocat` `link-lang-nocat` `llnc`	Dictar la categorización del texto del enlace en idioma extranjero Valores sugeridos `yes` `y` `true` `t` `on` `1`	Línea	opcional
Texto del enlace de categorización de idioma extranjero	`link_lang_cat` `link-lang-cat` `llc`	Dictar la categorización del texto del enlace en idioma extranjero Valores sugeridos `no` `n` `false` `f` `off` `0`	Línea	opcional
Tamaño del texto del enlace en idioma extranjero	`link_lang_size` `link-lang-size` `lls`	Controlar el tamaño de presentación del texto del enlace en idioma extranjero Ejemplo 1,5 em	Línea	opcional
Enlace de texto en idioma extranjero rtl	`link_lang_rtl` `link-lang-rtl` `llr`	Controlar la presentación RTL del texto del enlace en idioma extranjero Valores sugeridos `no` `yes` Por defecto No	Línea	opcional
También conocido como código de texto en idioma extranjero	`aka_lang` `aka-lang` `al`	Proporcionar un código de idioma para un idioma extranjero, también conocido como texto. Ejemplo Sí	Línea	opcional
También conocido como texto en cursiva en idioma extranjero	`aka_lang_italic` `aka-lang-italic` `ali`	Controlar la presentación en cursiva de un idioma extranjero, es decir, texto. Valores sugeridos `yes` `no` `unset` `invert` `default`	Línea	opcional
También conocida como categorización de texto en lengua extranjera	`aka_lang_nocat` `aka-lang-nocat` `alnc`	Dictar la categorización de un idioma extranjero, también conocido como texto. Valores sugeridos `yes` `y` `true` `t` `on` `1`	Línea	opcional
También conocida como categorización de texto en lengua extranjera	`aka_lang_cat` `aka-lang-cat` `alc`	Dictar la categorización de un idioma extranjero, también conocido como texto. Valores sugeridos `no` `n` `false` `f` `off` `0`	Línea	opcional
También conocido como tamaño de texto en idioma extranjero	`aka_lang_size` `aka-lang-size` `als`	Controlar el tamaño de presentación del idioma extranjero, es decir, el texto. Ejemplo 1,5 em	Línea	opcional
También conocido como texto en idioma extranjero rtl	`aka_lang_rtl` `aka-lang-rtl` `alr`	Controlar la presentación RTL de un idioma extranjero, también conocido como texto Valores sugeridos `no` `yes` Por defecto No	Línea	opcional
Información adicional código de idioma extranjero	`wedge_lang` `wedge-lang` `insert_lang` `insert-lang` `extra_lang` `extra-lang` `wl`	Proporcionar un código de idioma para el texto en cuña en idioma extranjero Ejemplo Sí	Línea	opcional
Información adicional en cursiva en idioma extranjero	`wedge_lang_italic` `wedge-lang-italic` `insert_lang_italic` `insert-lang-italic` `extra_lang_italic` `extra-lang-italic` `wli`	Controlar la presentación en cursiva del texto en cuña en un idioma extranjero Valores sugeridos `yes` `no` `unset` `invert` `default`	Línea	opcional
Información adicional sobre la categorización de lenguas extranjeras	`wedge_lang_nocat` `wedge-lang-nocat` `insert_lang_nocat` `insert-lang-nocat` `extra_lang_nocat` `extra-lang-nocat` `wlnc`	Dictar la categorización del texto en cuña en lengua extranjera Valores sugeridos `yes` `y` `true` `t` `on` `1`	Línea	opcional
Información adicional sobre la categorización de lenguas extranjeras	`wedge_lang_cat` `wedge-lang-cat` `insert_lang_cat` `insert-lang-cat` `extra_lang_cat` `extra-lang-cat` `wlc`	Dictar la categorización del texto en cuña en lengua extranjera Valores sugeridos `no` `n` `false` `f` `off` `0`	Línea	opcional
Información adicional tamaño idioma extranjero	`wedge_lang_size` `wedge-lang-size` `insert_lang_size` `insert-lang-size` `extra_lang_size` `extra-lang-size` `wls`	Controlar el tamaño de presentación del texto en cuña en idioma extranjero Ejemplo 1,5 em	Línea	opcional
Información adicional idioma extranjero rtl	`wedge_lang_rtl` `wedge-lang-rtl` `insert_lang_rtl` `insert-lang-rtl` `extra_lang_rtl` `extra-lang-rtl` `wlr`	Controlar la presentación RTL del texto en cuña en idioma extranjero Valores sugeridos `no` `yes` Por defecto No	Línea	opcional
Formato de descripción en idioma extranjero	`desc_lang_no` `desc-lang-no` `dlno`	Dictar si el texto de descripción en idioma extranjero debe tener formato Valores sugeridos `yes`	Línea	opcional
Descripción en idioma extranjero en cursiva	`desc_lang_italic` `desc-lang-italic` `dli`	Controlar la presentación en cursiva del texto de descripción en idioma extranjero Valores sugeridos `yes` `no` `unset` `invert` `default`	Línea	opcional
Categorización de descripciones en lenguas extranjeras	`desc_lang_nocat` `desc-lang-nocat` `dlnc`	Dictar la categorización del texto de descripción en lengua extranjera Valores sugeridos `yes` `y` `true` `t` `on` `1`	Línea	opcional
Categorización de descripciones en lenguas extranjeras	`desc_lang_cat` `desc-lang-cat` `dlc`	Dictar la categorización del texto de descripción en lengua extranjera Valores sugeridos `no` `n` `false` `f` `off` `0`	Línea	opcional
Tamaño de la descripción en idioma extranjero	`desc_lang_size` `desc-lang-size` `dls`	Controlar el tamaño de presentación del texto de descripción en idioma extranjero Ejemplo 1,5 em	Línea	opcional
Descripción en idioma extranjero rtl	`desc_lang_rtl` `desc-lang-rtl` `dlr`	Controlar la presentación RTL del texto de descripción en idioma extranjero Valores sugeridos `no` `yes` Por defecto No	Línea	opcional

Vista previa de advertencias y categorías de mantenimiento

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:

Categoría:Las páginas que muestran descripciones breves sin espacios mediante el enlace Módulo:Anotado se completarán con páginas en las que se haya invocado el módulo para proporcionar anotaciones que incluyan una descripción sin espacios. Si un editor interesado analiza una página de esta categoría y determina que la descripción es adecuada para su uso, agréguela |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.
Categoría:Las páginas que muestran descripciones de Wikidata como alternativa a través del enlace Módulo:Anotado se completarán con páginas en las que se haya invocado el módulo para proporcionar anotaciones que contengan descripciones de Wikidata que no se solicitaron explícitamente (con |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.
Categoría:Las páginas que muestran descripciones breves que coinciden con el nombre de la página a través del módulo:Enlace anotado se completarán con páginas en las que se haya invocado el módulo para proporcionar anotaciones que contengan descripciones que tengan (sin distinguir entre mayúsculas y minúsculas) la misma equivalencia que el nombre de la página vinculada, es decir, "artículo de Wikipedia" con una descripción breve de "artículo de Wikipedia". Considere revisar las instancias.

Está disponible una herramienta útil para encontrar intersecciones de categorías.

Véase también

{{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
Wikipedia:Descripción breve : información general sobre descripciones breves
WP:HOWTOSD : guía detallada sobre cómo escribir descripciones breves

La documentación anterior se transcluye desde Plantilla:Enlace anotado/doc .
Los editores pueden experimentar en las páginas de sandbox y casos de prueba de esta plantilla .
Agregue categorías a la subpágina /doc . Subpáginas de esta plantilla .