Plantilla:Ancla

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

La plantilla {{anchor}} inserta uno o más nombres de anclaje invisibles ( identificadores de fragmentos HTML ) en una página.

El formato básico es {{anchor|Anchor name}}. Para vincular a un ancla desde dentro de la misma página, use [[#Anchor name|display text]]. Para vincular a un ancla desde otra página, utilice [[Article name#Anchor name|display text]]. Consulte Ayuda: Enlace § Enlace de sección (anclajes) para obtener más detalles.

Tenga en cuenta que #Anchor name, utilizado por el software MediaWiki para (normalmente) dirigir a los usuarios a secciones dentro de una página, no es una directiva de wikitexto como #redirect.

Los anclajes son más útiles con las secciones, ya que los enlaces a una sección no funcionarán si se cambia el nombre de una sección. Sin embargo, los anclajes se pueden utilizar según sea necesario en cualquier parte de un artículo. El nombre del ancla puede ser arbitrario, pero la primera letra generalmente debe estar en mayúscula de acuerdo con el estilo del encabezado (consulte el Manual de estilo § Encabezados de sección para obtener más información).

Formato básico

Puede definir uno o más nombres de anclaje, separados por |. Esto puede resultar útil para grafías alternativas, como "humor" y "humor".

En general, si el objetivo previsto de un ancla es el título de una sección, entonces debe colocarse al final del encabezado de la sección mediante sustitución :
== Section header{{subst:anchor|Anchor name}} ==

que se guardará en el artículo como:
== Section header<span class="anchor" id="Anchor name"></span> ==

Los nombres de anclaje distinguen entre mayúsculas y minúsculas, por lo que [[#Anchor name]]y [[#Anchor Name]]no son equivalentes. Al crear un ancla, en general escriba en mayúscula la primera letra del nombre del ancla y siga las mismas pautas de uso de mayúsculas que los encabezados (consulte Manual de estilo: Encabezados para obtener más información).

Limitaciones

• Los nombres de anclaje que contienen cualquier carácter que se muestra en la tabla de la derecha no funcionarán como se esperaba. Sin embargo, cualquiera de estos caracteres se puede reemplazar con los códigos "&#" que se muestran aquí. O bien, el símbolo de barra vertical y el signo igual se pueden solucionar con {{ ! }} y {{ = }}, respectivamente. No se pueden utilizar códigos de marcado como <sup>y (superíndice y subíndice). <sub>La mayoría de los demás caracteres, incluidos los espacios en blanco y la puntuación, no son un problema.
• Los nombres de los anclajes deben ser únicos en una página y no deben duplicar ningún título de encabezado. Los anclajes duplicados no funcionarán como se esperaba ya que los #locationenlaces van al primer anclaje con ese nombre. Los anclajes duplicados dan como resultado HTML no válido; Puede comprobar si hay anclajes duplicados ejecutando la página a través del Servicio de validación de marcado del W3C .
• Los enlaces de anclaje distinguen entre mayúsculas y minúsculas en algunos navegadores, por lo tanto, trate todos los enlaces de anclaje con distinción entre mayúsculas y minúsculas al crear enlaces a ellos. Por ejemplo, si crea el ancla con === Baz{{subst:anchor|Bar}} ===, vincúlelo con [[pagename#Bar]], no con [[pagename#bAR]]. Sin embargo, debido a que algunos navegadores no distinguen entre mayúsculas y minúsculas, no cree títulos de sección ni anclajes que difieran solo en mayúsculas y minúsculas de otros en la página. Es decir, no cree ambos === Abcd{{subst:anchor|Baz}} ===y === Efgh{{subst:anchor|bAZ}} ===.
• Si una plantilla se deja sin sustituir dentro del título de una sección (lo que nunca se debe hacer), entonces el código de la plantilla aparecerá en la ventana de resumen de edición cada vez que comience una edición de esa sección, como en /* Limitations{{anchor|Issues}} */ New issue. El editor debe eliminar manualmente la plantilla de anclaje de la ventana de resumen de edición; de lo contrario, cuando guarde la sección, es posible que el navegador no regrese a la sección y el enlace de la sección de esa edición en la página del historial no funcionará.

Uso en tablas

Se pueden utilizar anclajes dentro de las mesas, sujeto a ciertas restricciones. La {{anchor}}plantilla se puede utilizar en el título y las celdas de una tabla, pero no en aquellas partes de una tabla que están fuera del título y las celdas. A diferencia de los títulos de las secciones, no es necesario sustituir la plantilla. Se utiliza en el título de la tabla de la siguiente manera:

|+ {{anchor|FooX}} Un título de tabla

y son válidas las siguientes formas de celda:

!{{anchor|Foo1}} Una celda de encabezado!estilo="fondo:blanco;" |{{anchor|Foo2}} Una celda de encabezado con estilo|{{anchor|Foo3}} Una celda de datos|rowspan=2 |{{anchor|Foo4}} Una celda de datos que abarca dos filas

Debe asegurarse de que {{anchor}}no esté en la parte del marcado destinada a las clases, estilos, etc. Por lo tanto, {{anchor}}no se puede colocar en ningún lugar de las líneas que comienzan con {|(inicio de la tabla) o |-(nueva fila), y las siguientes formas de celda no son válidos:

!{{anchor|Foo1}} |Una celda de encabezado!estilo="fondo:blanco;" {{anchor|Foo2}} |Una celda de encabezado con estilo|{{anchor|Foo3}} |Una celda de datos|rowspan=2 {{anchor|Foo4}} |Una celda de datos que abarca dos filas

Si es necesario que un ancla esté en alguna de estas posiciones, se utiliza una técnica diferente: el id=atributo. Esto se coloca en la parte del marcado donde se pueden usar las clases, estilos, etc., de la siguiente manera:

{| id=FooX clase=wikitable|- id=FooY!id=Foo1 |Una celda de encabezado!estilo="fondo:blanco;" id=Foo2 |Una celda de encabezado con estilo|id=Foo3 |Una celda de datos|rowspan=2 id=Foo4 |Una celda de datos que abarca dos filas

El id=atributo puede aparecer antes, entre o después de cualquier otro atributo que pueda estar presente, pero sólo se id=puede utilizar un atributo en cada una de estas áreas.

Si {{anchor}}se coloca al inicio de una celda centrada verticalmente (que es el valor predeterminado para las tablas), los enlaces al ancla saltarán al inicio del contenido mostrado y no a la parte superior de la celda. Esto puede requerir que el lector se desplace hacia arriba para ver completamente otras celdas en la fila. Se puede evitar colocándolo id=donde comienza el código de fila.

Justificación de la sustitución en el encabezado.

Los anclajes nunca deben dejarse sin sustituir dentro de un encabezado de sección, ya que esto viola MOS:HEADINGS y causa complicaciones técnicas. Más específicamente: si {{anchor}}se usa sin sustitución, el ancla se incluirá en el historial de edición de la página como parte del nombre de la sección (consulte MOS:SECTIONANCHOR para obtener más detalles).

Para mostrar por qué se prefiere la ubicación en el encabezado, se coloca el siguiente ancla en el encabezado de la sección Formato básico:
== Basic format<span class="anchor" id="Foo"></span><span class="anchor" id="In-Foo"></span> ==

Dado que el ancla se utiliza realmente en esta página de documentación, los enlaces #Formato básico, #Foo y #In-Foo funcionan y se pueden probar para ver el efecto.

Por el contrario, también se colocó un ancla llamada #Under-Foo debajo del encabezado de la sección de formato básico y se puede hacer clic en ella para ilustrar cómo esta ubicación oculta el título de la sección al saltar al destino vinculado en algunos navegadores web:
== Basic format ==
{{anchor|Under-Foo}}

Se ha colocado otro ancla llamada #Above-Foo encima del encabezado de la sección. Este ancla funciona correctamente, pero debido a que técnicamente el ancla no está en la sección sino antes de ella, hace que la edición sea contraintuitiva.
{{anchor|Above-Foo}}
== Basic format ==

Explicaciones y ejemplos.

Las razones por las que lo anterior es una mejor práctica se detallan en los siguientes ejemplos adicionales numerados, así como en la sección Limitaciones:

1. {{anchor|Foo}}
   podría vincularse [[#Foo|...]]desde dentro del mismo artículo (llamemos a este artículo "Qux"),
   o podría vincularse [[Qux#Foo|...]]desde otros artículos y desde redirecciones (donde los puntos suspensivos después de la palabra "Foo" aquí significan las palabras elegidas para representar ese enlace en el artículo de Wikipedia, que, por supuesto, podría ser cualquier cosa).
2. Los anclajes pueden ser más adecuados para la vinculación entre artículos que los títulos de las secciones, porque los anclajes son más estables. Por ejemplo, el título de una sección == Foo ==dentro de un artículo de Wikipedia titulado Qux: Aquí, los enlaces vía seguirían siendo válidos incluso si se cambiara el nombre de la sección. Un inconveniente de este enfoque (como se detalla en la sección Limitaciones) es que tener una plantilla en el encabezado de la sección causa problemas con el editar la ventana de resumen cada vez que se realiza una edición de sección para esta sección. La solución obvia es colocar el ancla antes del nombre de la sección. Esto también evita que los navegadores oculten el título de la sección cuando saltan al objetivo.
   == {{anchor|Foo bar}} Foo ==
[[Qux#Foo bar]]== {{anchor|Foo bar}} On foo and its many friends ==
   
   Nota: El nombre del ancla ( Foo bar) debe ser diferente de la sección ( Foo) para evitar HTML no válido.
3. Dentro de los títulos de las secciones, puede ser preferible simplemente usar HTML directo, lo que se puede lograr mediante una sustitución como esta: que se guarda en el artículo como: Esto proporciona un ancla estable y vinculable, pero sin el problema de edición. La nota anterior todavía se aplica. Consulte § Limitaciones para obtener más detalles.
   == Foo{{subst:anchor|Foo bar}} ==

== Foo<span class="anchor" id="Foo bar"></span> ==
   
   
4. La plantilla se puede utilizar para crear múltiples anclajes con una sola llamada. Por ejemplo, creará tres anclajes a los que luego se podrán vincular con y .
   {{anchor|Foo|Bar|baz}}
[[#Foo]][[#Bar]][[#baz]]
5. Aquí hay un ejemplo más literal:
   supongamos que escribió un artículo sobre una lengua indoeuropea recientemente descubierta llamada "Yish Yash". El título de su artículo probablemente sería "Lenguaje Yish Yash" (si ya existiera un artículo titulado "Yish Yash" que cubriera la cultura en general). Ahora digamos que dentro de su artículo desea tener una sección titulada "La ubicación de la lengua al producir sonidos vocálicos Yish Yash". Crearías un encabezado de sección que se vería así: Digamos que terminaste de escribir y guardaste el nuevo artículo. Ahora, supongamos que encontró otro artículo en Wikipedia titulado "Vocales protoindoeuropeas" que tenía una sección sobre la ubicación única de la lengua utilizada en Yish Yash. Decidiste que podría ser útil aquí para que los lectores puedan acceder rápidamente a la sección de tu artículo sobre la colocación de la lengua Yish Yash al formar vocales; sin embargo, no desea enviarlos al principio de todo el artículo sobre el idioma Yish Yash (quería dirigirse a ellos más específicamente). Así que creas un enlace en el artículo vocal protoindoeuropeo a la sección de tu artículo sobre la ubicación de la lengua en Yish Yash: puedes hacerlo editando el texto del artículo vocal protoindoeuropeo y agregando algo como esto a un lugar relevante dentro de él: Es un código realmente largo, pero crearía un enlace directo a la sección relevante del nuevo artículo sobre el idioma Yish Yash y se vería así en el artículo sobre las vocales protoindoeuropeas: " ... La ubicación de la lengua de Yish Yash es particularmente interesante..." Ahora digamos que aparece otro editor y desea cambiar el título de esta sección de su artículo por alguna razón legítima, tal vez a "Las vocales de Yish Yash y la lengua". Podrían hacerlo editando su artículo y haciendo que el encabezado de la sección se vea así: Sin que ese editor lo sepa, esto significaría que el enlace en el artículo sobre las vocales protoindoeuropeas que creó anteriormente ahora iría de manera predeterminada a la parte superior de ¡El artículo de Yish Yash en lugar de su subsección cuidadosamente elegida! Sin embargo, si se colocó un ancla dentro del encabezado de la sección del artículo de Yish Yash, ya sea cuando lo creó o cuando el otro editor apareció y lo cambió, tal vez algo como esto: o como esto: y el texto del artículo sobre Proto- Si usted hubiera cambiado las vocales indoeuropeas a algo como esto: entonces el enlace del artículo protoindoeuropeo continuaría apuntando a la sección correspondiente
   == The placement of the tongue when producing Yish Yash vowel sounds ==

[[Yish Yash language#The placement of the tongue when producing Yish Yash vowel sounds|Yish Yash tongue placement]] is particularly interesting.



== Yish Yash vowels and the tongue ==

== The placement of the tongue when producing Yish Yash vowel sounds{{subst:anchor|Tongue}} ==

== Yish Yash vowel–tongue interaction{{subst:anchor|Tongue}} ==

[[Yish Yash language#Tongue|Yish Yash tongue placement]] is particularly interesting.
   del artículo de Yish Yash, incluso si la redacción del título de la sección había cambiado por completo y sin que el lector tuviera que resolverlo por sí mismo. El uso de anclajes puede generar una experiencia de lectura de Wikipedia más limpia y eficiente cuando se cambian los títulos de las secciones, lo cual no es infrecuente.

Datos de plantilla

Estos son los TemplateData para esta plantilla utilizados por TemplateWizard, VisualEditor y otras herramientas. Vea un informe mensual de uso de parámetros para Plantilla:Ancla en artículos basados ​​en sus TemplateData.

Datos de plantilla para ancla

Agregue anclajes HTML a una página. Haz un enlace a tu ancla con [[#Anchor en la misma página]] o [[Página a la que estás enlazando#Anchor en esa página]]. Cada ancla en una página debe ser diferente. No utilice los caracteres " o # o | o =.

Ver también

• {{ Ancla visible }}
• {{ Lista anclada }}
• {{ Comentario ancla }}
• {{ Atajo }}
• WP: ANCLA
• WP: OBJETIVO
• {{ Enlace de sección }}

La documentación anterior está transcluida de Plantilla:Anchor/doc . ( editar | historial )
Los editores pueden experimentar en las páginas sandbox ( editar | diff ) y casos de prueba ( editar ) de esta plantilla .
Agregue categorías a la subpágina /doc . Subpáginas de esta plantilla .