[1]
Esta documentación es para las plantillas {{ ref }} , {{ note }} , {{ ref label }} y {{ note label }} . Las plantillas de notas colocan notas en un artículo y las plantillas de referencias colocan referencias etiquetadas a las notas, con las etiquetas normalmente como hipervínculos para navegar desde una referencia a una nota correspondiente y viceversa. El par de plantillas de etiquetas es similar al par sin el nombre de etiqueta , pero con más funciones.
Los enlaces y los backlinks se identifican internamente mediante la combinación de los parámetros especificados. Las plantillas aceptan una serie de parámetros sin nombre identificados por su posición. También aceptan un parámetro con nombre (named noid ) que está en desuso desde su introducción.
El primer parámetro de {{ ref }} es una etiqueta que debe utilizarse para el parámetro de la {{ note }} correspondiente . La etiqueta se utiliza para formar el identificador de fragmento para el enlace de nota al pie y el enlace de retroceso. El segundo parámetro de {{ref}} es el marcador de referencia de nota al pie, que se muestra como un superíndice. La opción más sencilla es hacer que estos dos sean iguales, pero esto no es un requisito. Si no se proporciona el segundo parámetro, el marcador es un enlace externo en superíndice con la forma [ n ].
A continuación se ilustra la sintaxis general de cada plantilla:
{{ref|id|label|noid=noid}}
{{note|id|label|text}}
{{ref label|id|label|backlink|noid=noid}}
{{note label|id|label|backlink|text}}
La descripción de cada parámetro es la siguiente:
Identificador de una nota y su vínculo posterior (obligatorio). Este es el único parámetro obligatorio para una pareja {{ref}}
de notas {{note}}
y se puede utilizar para agregar notas al pie simples.
Nota importante: Cada par de {{ref}}
y {{note}}
, así como cada par de {{ref label}}
y {{note label}}
, deben tener identificadores únicos. Esto se aplica incluso si se desean múltiples referencias que apunten a la misma nota al pie. ( El método correcto para implementar esta característica, utilizando el parámetro de etiqueta , se ilustra más adelante ). Los identificadores duplicados generan código no válido, al que los navegadores web reaccionan de manera diferente. Algunos navegadores informan errores, mientras que otros pueden mantener un identificador al azar y descartar otros silenciosamente. En todos los casos, sin embargo, la navegación entre algunas marcas de notas al pie y sus textos del cuerpo no funciona como se desea. Consulte Ayuda:Validación de marcado .
Texto de etiqueta que se muestra donde se insertan estas plantillas (obligatorio para {{ref label}}
y {{note label}}
). A continuación se explica el comportamiento específico de las plantillas:
{{ref}}
, {{ref label}}
y {{note label}}
, la etiqueta aparece en superíndice ; en {{note}}
, la etiqueta aparece como texto en negrita de línea base de tamaño estándar.{{ref}}
, {{ref label}}
y {{note}}
, la etiqueta también tiene un hipervínculo y ayuda a navegar de ida y vuelta entre el marcador de nota al pie en línea (en la prosa) y el cuerpo del texto. {{note label}}
, sin embargo, no adjunta un hipervínculo a la etiqueta, sino que ignora este parámetro cuando el parámetro de vínculo de retroceso (explicado más adelante) está presente.{{ref label}}
, la etiqueta siempre está entre corchetes.Este parámetro es opcional en {{ref}}
y {{note}}
, por lo tanto:
{{ref}}
muestra un número único entre corchetes si se omite este parámetro. (Vea el ejemplo anterior).{{note}}
agrega esta etiqueta a un cursor con vínculo hacia atrás (^), por lo que si se omite, solo se muestra un cursor. (Vea el ejemplo anterior).No existe ninguna obligación de incluir este parámetro en la parte de referencia y en la parte de nota al mismo tiempo. De hecho, puede ser necesario hacer lo contrario. Este ejemplo muestra cómo utilizar {{ref}}
y {{note}}
vincular varios marcadores de nota al pie con la misma apariencia a la misma nota al pie.
Como se explicó anteriormente, {{note label}}
no se genera un vínculo de retroceso a partir del parámetro de etiqueta . Un parámetro único de {{ref label}}
– {{note label}}
, el vínculo de retroceso es un parámetro complementario que es parte id y parte etiqueta :
{{ref label}}
par {{note label}}
puede renunciar a este parámetro o ambos deben tenerlo.{{ref label}}
par {{note label}}
, ambos extremos deben tener el mismo valor de vínculo de retroceso . Además, en cualquier {{ref label}}
par {{note label}}
, la combinación de id y vínculo de retroceso debe ser única.{{note label}}
, este parámetro anula completamente el parámetro de etiqueta .Un sitio {{ref label}}
con un vínculo de retroceso no puede conectarse a un sitio {{note}}
. Del mismo modo, un sitio {{note label}}
con un vínculo de retroceso no puede conectarse a un sitio {{ref}}
.
Ejemplo:
Este parámetro ( backlink ) también acepta el valor especial "none" (sin comillas), lo que hace que aparezca un signo de intercalación donde {{note label}}
se coloca.
En todos los ejemplos anteriores, el texto del cuerpo de una nota al pie se insertó fuera {{note}}
de {{note label}}
la plantilla. Sin embargo, es posible insertar el texto del cuerpo dentro de la plantilla, en lugar del parámetro de texto . Todo lo que se coloca dentro del parámetro de texto se ilumina cuando el usuario hace clic en la marca de la nota al pie. En el ejemplo siguiente, intente hacer clic en S y T y observe la diferencia.
Dado que el texto del cuerpo de la nota al pie comienza sin un delimitador después de esta cadena, hay una salvedad: si el texto del cuerpo de la nota al pie comienza con una letra minúscula, la primera palabra puede ir adjunta al vínculo de retroceso. (Para obtener más información, consulte Ayuda:Wikilinks .)
Parámetro obsoleto : suprime los vínculos inversos del componente de nota a la referencia. En el caso de {{note}}
, sigue apareciendo un hipervínculo activo, aunque esté roto.
Este parámetro se pensó originalmente para aliviar el problema de conectar muchas etiquetas de referencia con el mismo ID a una etiqueta de nota con ese ID. Sin embargo, solo reemplaza una forma de código roto por otra. Considere usar {{note label}}
en su lugar, que no genera ningún vínculo de retroceso a menos que esté configurado para hacerlo. Siempre debe haber una y solo una plantilla de nota para cada plantilla de referencia con el mismo ID .
Como se explicó anteriormente, el parámetro id{{ref}}
de cada par de referencias {{note}}
debe ser único. El siguiente ejemplo muestra lo que sucede cuando dos referencias usan el mismo id . Intente navegar desde el texto con viñetas hasta las notas al pie y viceversa.
Una aplicación común de las plantillas de referencias y notas es colocar notas al pie debajo de las tablas, como en el siguiente ejemplo tomado del artículo Kent#Economy [sección]:
El gadget Reference Tooltips no funciona con estas plantillas. El uso de etiquetas ref/note no es la única forma de crear notas al pie . Cite.php (con el que Reference Tooltips funciona) es actualmente el método preferido para crear notas al pie, especialmente cuando aumenta la cantidad de notas al pie y el tamaño del artículo (o el área en la que se utilizan las notas al pie) crece. Ref Converter puede convertir las etiquetas ref/note al nuevo estilo Cite.php.
Los siguientes ejemplos comparan dos métodos y también muestran cómo se pueden combinar:
Véase también ejemplos y explicaciones en Wikipedia:Footnote3 .