La plantilla {{ r }} ( referencia ) permite definir e invocar cualquier tipo de referencias completas o abreviadas (citas y notas a pie de página) en artículos de una manera muy intuitiva, utilizando una notación fácil de recordar y muy corta, reduciendo mucho desorden del código fuente del artículo, lo que hace que sea más fácil de leer y mantener.
{{ r }} proporciona medios para que los enlaces a referencias incluyan información adicional (como páginas, citas y otros comentarios) en un formato condensado, eliminando así la necesidad de una sección de artículo adicional para referencias abreviadas (y evitando así los problemas relacionados con ese enfoque, como la capa adicional de indirección de enlaces, el espacio ocupado por esa sección, así como la cantidad de espacio en blanco creado por ella, y el sistema de enlaces propietario a menudo poco fiable con enlaces ambiguos o colgantes, así como la falta de enlaces de retroceso desde las citas completas a las referencias abreviadas). Su sistema de anotación se puede utilizar para enriquecer la cita completa con información proporcionada donde se invoca una referencia, para agrupar varias citas en una entrada o para agrupar subreferencias bajo la referencia completa correspondiente (es decir, para implementar citas abreviadas de estilo r).
Al utilizar la extensión MediaWiki:Cite internamente (en lugar de establecer un sistema de enlaces independiente (es decir, WP:CITEREF ) sobre ella), {{ r }} también sigue siendo totalmente compatible con otros sistemas de referencia y aprovechará cualquier mejora futura del sistema subyacente.
Se puede utilizar con definiciones de texto sin formato para las referencias y también se puede combinar con otras plantillas de citas (como CS1 / CS2 ).
En su formato básico, la plantilla proporciona una abreviatura compacta para las etiquetas de cita <ref name="RefName" />, simplificando la sintaxis y reduciendo el desorden del código.
También se puede utilizar para definir referencias en línea o definidas por lista (LDR), incluidas notas al pie anidadas dentro de otras notas al pie (hasta cinco niveles de profundidad). Las citas se pueden proporcionar como citas de texto sin formato o mediante otras plantillas de citas (como el conjunto de plantillas de citas CS1 / CS2 ).
Opcionalmente, permite proporcionar y mostrar números de página individuales (u otra información de ubicación en la fuente) y citas (incluyendo información del idioma y traducciones) de la fuente junto con las invocaciones de una referencia (es decir, el enlace a la referencia). Si los números de página proporcionados son demasiado poco específicos para la cita, se puede proporcionar opcionalmente un número de página adicional solo para la cita. El número de página se mostrará como superíndice inmediatamente después del enlace de referencia, la otra información relacionada está disponible como información sobre herramientas al pasar el cursor sobre ese superíndice. Los parámetros de página en plural tienen soporte especial para listas y rangos, convirtiendo automáticamente guiones en barras finales; también se admite el marcado accept-this-as-written para anular la conversión automática.
La plantilla permite definir una anotación de referencia, que se recopilará y se agregará al final de la cita completa definida anteriormente. Esto se puede utilizar para acumular notas adicionales (incluidos los números de página y las citas de las invocaciones), permite agrupar citas definidas en diferentes ubicaciones y ubicarlas en una sola entrada, o agrupar subreferencias bajo la referencia completa correspondiente.
Los parámetros de plantilla pueden tomar información de texto sin formato, pero también son compatibles con el marcado HTML y MediaWiki simple, lo que permite el uso de enlaces y plantillas en los parámetros de plantilla. Dicho marcado se eliminaría automáticamente para la visualización de información sobre herramientas, pero se pasaría a otros fines (sistema de anotaciones).
Se pueden habilitar anclajes de enlaces personalizados para los enlaces de referencia, así como para las definiciones de referencia y varias anotaciones, lo que permite integrarlos sin problemas con otros sistemas de citas utilizados en la misma página o crear esquemas de enlaces sofisticados con enlaces a piezas individuales de contenido y vínculos de retroceso a enlaces de referencia (es decir, actuando como referencias abreviadas).
La plantilla permite definir y mostrar una sección de contexto en la prosa del artículo para indicar qué afirmaciones específicas del artículo están respaldadas por la referencia, si esto no resulta obvio desde el lugar donde se encuentra el enlace de referencia. La sección se puede dividir en varias partes y puede superponerse con otras secciones definidas para otras referencias.
Los números de página faltantes se pueden indicar de forma similar a {{ Página necesaria }} .
Mientras la función de información sobre herramientas no esté ocupada por la plantilla para mostrar citas, la plantilla proporcionará una información sobre herramientas por sí sola que explicará la información de página/ubicación truncada adjunta al enlace.
La plantilla es compatible con los nombres de parámetros de la mayoría de las otras plantillas de citas, y funciona tanto para citas normales como para cualquier tipo de grupo (es decir, para notas al pie, incluidas las predefinidas).
El soporte bidireccional (de izquierda a derecha, de derecha a izquierda) para citas está disponible si se activan las definiciones CSS correspondientes.
La plantilla optimiza el kerning visual en los superíndices y tiene soporte configurable para ajuste de línea después o dentro de los superíndices (con CSS correspondiente).
La plantilla es compatible con funciones de edición como el truco de la tubería y la sustitución de plantillas .
(La implementación actual admite múltiples citas, pero esta funcionalidad puede trasladarse a un contenedor como {{ rr }} en el futuro para introducir una convención de llamada más simplificada y poderosa en la plantilla principal {{ r }} . Para lograr la máxima compatibilidad futura, utilice {{ rr }} cuando utilice parámetros enumerados (para admitir múltiples citas en una llamada) o utilice parámetros sin nombre).
Por ejemplo:
{{r}}
y <ref>
pueden coexistir en la misma página y, al igual que <ref>
, {{r}}
se pueden usar con o sin referencias definidas por listas . Además, un parámetro |page=
or |p=
agrega la funcionalidad de {{ rp }} :
La ubicación dentro de la fuente se puede especificar con |page=
/ |p=
(para una sola página), con |pages=
/ |pp=
(para páginas plurales) o con |location=
/ |loc=
/ |at=
para otras ubicaciones dentro de la fuente.
Los números de página especificados pueden ser un solo número de página (287), una lista de varias páginas (xii, 287, 292, 418) o un rango de páginas (287–288) o cualquier combinación de estos. No agregue "Página", "pp.", etc., solo los números.
También se puede utilizar otra información de ubicación en la fuente para páginas no numéricas, por ejemplo: "f. 29", "A7" y "contraportada", etc., y también se puede utilizar para fuentes no paginadas, por ejemplo, "0:35:12" para una fuente de video.
Elija uno de los parámetros de plantilla anteriores según el tipo de página o la ubicación de origen especificada.
Aunque normalmente solo se proporciona uno de estos tres tipos de parámetros, también es posible combinarlos para que se adapten a casos de uso más especiales. Si se proporcionan al mismo tiempo los parámetros de página singular y plural, se supone que la información de página plural es el tramo del artículo, mientras que la información de página singular se considera la página dentro de ese tramo que respalda la declaración. La plantilla indicará esto enmarcando la página singular entre corchetes después de la información de página plural. Si se proporciona una ubicación en la fuente además de la información de la página, la plantilla asume que es para detallar aún más la información de la página anterior en lugar de representar algún tipo de información de ubicación en la fuente independiente.
No intente utilizar varios alias de un parámetro al mismo tiempo. Solo se seleccionará uno y los demás se pueden ignorar sin que aparezca ningún mensaje de error.
Los nombres de referencia pueden definirse dentro de una {{ reflist }} (como se ilustra a continuación) o (de la forma más habitual) dispersos a lo largo del texto del artículo utilizando, por ejemplo, <ref name="RefName">Reference text</ref>
o .{{refn|name=RefName|Reference text}}
===Notas=== {{ reflist | group = "Notas" | refs = < ref name = "NtName" > Texto de la nota. </ ref > < ref name = "NtCam" > Texto de la nota de la cámara. </ ref > }} ===Referencias=== {{ reflist | refs = < ref name = "RefName" > Texto de referencia. </ ref > < ref name = "Bam" > Texto de referencia de Bam. </ ref > < ref name = "Bar" > Texto de referencia de Bar. </ ref > < ref name = "Bas" > Texto de referencia de Bas. </ ref > < ref name = "Bay" > Texto de referencia de Bay. </ ref > < ref name = "Baz" > Texto de referencia de Baz. </ ref > }}
Resultando en:
Cita de la página 346
Cita de la página 346
Cita E
Alternativamente, las referencias se pueden definir a través de {{ r }} mismo: [1] [2] [3] [4] [5] [6] [NB 1] [NB 2]
===Notas=== {{ reflist | group = "NB" | refs = {{ r | g = NB | NtName | r = Texto de la nota. }} {{ r | g = NB | NtCam | r = Texto de la nota Cam. }} }}===Referencias=== {{ reflist | refs = {{ r | RefName | r = Texto de referencia. }} {{ r | Bam | r = Texto de referencia de Bam. }} {{ r | Bar | r = Texto de referencia de Bar. }} {{ r | Bas | r = Texto de referencia de Bas. }} {{ r | Bay | r = Texto de referencia de Bay. }} {{ r | Baz | r = Texto de referencia de Baz. }} }}
Resultando en:
El sistema de anotación de estilo {{ r }} se puede utilizar para crear subreferencias (como citas abreviadas) con enlaces hacia atrás o hacia atrás agrupados bajo su cita completa correspondiente. Hay muchas variantes posibles, algunas de las cuales se ilustran a continuación:
Ejemplo 1 (con backlinks y numeración automática de subreferencias, aquí también con citas anidadas):
Lorem ipsum {{ r | norte = C1 | r = Cita 1 }} dolor sit amet, {{ r | norte = C1 | pag = 23 | a = # [[# L1 | ^ ]] pág. 23: Cita de la página 23. | link-id = L1 }} conector adipisici elit, {{ r | norte = C2 | r = Cita 2 | p = 92 }} sed eiusmod tempor incidunt ut labore et dolore magna aliqua. {{ r | norte = C1 | páginas = 56, 59 | a = # [[# L2 | ^ ]] págs. 56, 59: comentario en la página 56 de la revisión. {{ r | norte = C2 | pag = 70 }}| ID de enlace = L2 }}{{ r | n = C3 | r = Cita 3 }}===Referencias=== {{ reflist }}
Resultando en:
Lorem ipsum [1] dolor sit amet, [1] : 23 consectetur adipisici elit, [2] : 92 sed eiusmod tempor incidunt ut labore et dolore magna aliqua. [1] : 56, 59 [3]
Ejemplo 2 (con enlaces cruzados, aquí también con citas anidadas):
Lorem ipsum {{ r | norte = C1 | r = Cita 1 }} dolor sit amet, {{ r | norte = C1 | pag = [[# P1 | 23 ]]| a = < br />[[# L1B | ^ ]] pág. 23: Cita de la página 23. | identificación = P1 | link-id = L1B }} conector adipisici elit, {{ r | norte = C2 | r = Cita 2 | p = 92 }} sed eiusmod tempor incidunt ut labore et dolore magna aliqua. {{ r | norte = C1 | pp = [[# P2 | 56 ]] , 59 | a = < br />[[# L2B | ^ ]] págs. 56, 59: comentario en la página 56 de la reseña. {{ r | n = C2 | p = 70 }}| id = P2 | link-id = L2B }}{{ r | n = C3 | r = Cita 3 }}===Referencias=== {{ reflist }}
Lorem ipsum [1] dolor sit amet, [1] : 23 consectetur adipisici elit, [2] : 92 sed eiusmod tempor incidunt ut labore et dolore magna aliqua. [1] : 56, 59 [3]
Ejemplo 3 (con enlaces cruzados y citas en línea integradas localmente para información sobre herramientas, aquí también con citas anidadas):
Lorem ipsum {{ r | norte = C1 | r = Cita 1 }} dolor sit amet, {{ r | norte = C1 | pag = [[# P1C | 23 ]]| qp = p | q = Cita de la página 23. | a = q | inicio = < br />[[# L1C | ^ ]] pág. | identificación = P1C | link-id = L1C }} conector adipisici elit, {{ r | norte = C2 | r = Cita 2 | p = 92 }} sed eiusmod tempor incidunt ut labore et dolore magna aliqua. {{ r | norte = C1 | pp = [[# P2C | 56 ]] , 59 | qpp = pp | q = Comentario en la página 56 de la revisión. {{ r | n = C2 | p = 70 }}| a = q | entrada = < br />[[# L2C | ^ ]] pp. | id = P2C | id-enlace = L2C }}{{ r | n = C3 | r = Cita 3 }}===Referencias=== {{ reflist }}
Lorem ipsum [1] dolor sit amet, [1] : 23 consectetur adipisici elit, [2] : 92 sed eiusmod tempor incidunt ut labore et dolore magna aliqua. [1] : 56, 59 [3]
Cita de la página 23.^
Comentario de la página 56 de la reseña. [2] : 70
Cuando aparecen varias citas en serie, {{ r }} evita los saltos de línea entre las citas. En este caso, |wrap=yes
se puede utilizar para permitir un salto de línea. Alternativamente, si se deben permitir saltos de línea también dentro de una página larga o información de ubicación, |wrap=forced
se puede utilizar en su lugar (sin embargo, si esto realmente da como resultado saltos de línea también depende del navegador, CSS y el tema seleccionado).
Según MOS:DASH , los rangos de páginas normalmente se deben declarar con un ndash ( {{r|name=RefName|pages=27–29}}
→ [1] : 27–29 ) en lugar de un guion. Herramientas como WP:AWB convertirán automáticamente los guiones en rayas en tales casos. Para los parámetros de página en plural |pages=
, |pp=
y |quote-pages=
y alias, {{ r }} traducirá automáticamente los guiones en ndashes para fines de visualización. (Esto no se aplica a los parámetros singulares y otros parámetros de ubicación en la fuente |page=
, |p=
, |at=
, y alias). Si realmente se desea el guion por cualquier razón, se puede usar el " |loc=
accept -this-as-written-markup " (que también es compatible con {{ rp }} y {{ ran }} , la familia de plantillas de estilo {{ sfn }} y {{ harv }} , y todas las plantillas de citas CS1/CS2 ) para indicarlo ( → [1] : 27–29, 41 ).|quote-page=
{{r|name=RefName|pages=((27-29)), 41}}
Debido a una limitación técnica, algunos de los elementos de marcado estándar de Wikipedia que se utilizan a menudo en la prosa de los artículos no funcionan dentro de un conjunto de <ref>...</ref>
etiquetas, incluidos, entre otros, el truco de la tubería , la sustitución de plantillas y otro conjunto de <ref>...</ref>
etiquetas "anidadas". Por ejemplo, lo siguiente no funciona como se esperaba:
<ref>[[Help:Footnotes| ]]
</ref>
(Genera: > en lugar de un wikilink)[[Help:Footnotes| ]]
<ref>{{SUBST:TODAY}}</ref>
(Genera: {{SUBST:TODAY}} en lugar de la fecha en que se realizó la edición)<ref>Explanatory footnote<ref>Citation</ref>
</ref>
(Genera: Error de cita: A la etiqueta <ref> le falta el cierre </ref> (ver la página de ayuda ). </ref>)Reemplazar el <ref>...</ref>
conjunto más externo con {{r|r=...}}
(o {{r|a=...}}
permite el uso de los elementos de marcado enumerados anteriormente.
Los problemas en esta plantilla la hacen incompatible con la plantilla {{ excerpt }} . {{ r }} no debe utilizarse en secciones que serán transcluidas por {{ excerpt }} .
Datos de plantilla para R
Proporciona un contenedor simple para hasta nueve etiquetas de citas <ref name=RefName/> consecutivas que minimiza el impacto visual en el texto, lo que, junto con la sintaxis más simple, aumenta la legibilidad del código y la facilidad de edición.