La plantilla {{ r }} ( referencias ) 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 muy corta y fácil de recordar, reduciendo una gran cantidad de desorden en el código fuente del artículo, lo que facilita su lectura y mantenimiento.
{{ r }} proporciona medios para que los enlaces a referencias contengan 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 esa enfoque como la capa adicional de dirección indirecta de enlaces, el espacio ocupado, así como la cantidad de espacio en blanco creado por esa sección, y el sistema de enlaces propietario, a menudo poco confiable, con enlaces ambiguos o colgantes, así como la falta de vínculos de retroceso de las citas completas. a las referencias abreviadas). Su sistema de anotaciones se puede utilizar para enriquecer la cita completa con información proporcionada cuando se invoca una referencia, para agrupar múltiples citas en una entrada o para agrupar subreferencias bajo la referencia completa correspondiente (es decir, para implementar citas abreviadas estilo r).
Al utilizar la Extensión MediaWiki:Cite internamente (en lugar de establecer un sistema de enlace independiente (es decir, WP:CITEREF ) encima de él), {{ r }} también sigue siendo totalmente compatible con otros sistemas de referencias y aprovechará cualquier mejora futura de el sistema subyacente.
Se puede utilizar con definiciones de texto sin formato para las referencias y también combinarse con otras plantillas de citas (como CS1 / CS2 ).
En su formato básico, la plantilla proporciona una abreviatura compacta para las etiquetas de citas <ref name="RefName" />, simplificando la sintaxis y eliminando el desorden de códigos.
También se puede utilizar para definir referencias en línea y/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 (incluida información sobre el 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 inespecíficos para la cotización, opcionalmente se puede proporcionar un número de página adicional solo para la cotización. El número de página se mostrará como superíndice inmediatamente después del enlace de referencia; el resto de la información relacionada está disponible como información sobre herramientas al pasar el cursor sobre ese superíndice. Los parámetros de página plural tienen soporte especial para listas y rangos, convirtiendo automáticamente guiones en guiones; también se admite el marcado aceptar esto como está escrito para anular la conversión automática.
La plantilla permite la definición de anotación de referencia, que se recopilará y adjuntará al final de la cita completa definida anteriormente. Esto se puede utilizar para acumular notas adicionales (incluidos números de página y citas de las invocaciones), permite agrupar citas definidas en diferentes ubicaciones y residir en una sola entrada, o agrupar subreferencias bajo la referencia completa correspondiente.
Los parámetros de la plantilla pueden tomar información de texto sin formato, pero también son compatibles con etiquetas simples de MediaWiki y HTML, lo que permite el uso de enlaces y plantillas en los parámetros de la plantilla. Dichas marcas se eliminarían automáticamente para mostrar información sobre herramientas, pero se pasarían para otros fines (sistema de anotaciones).
Se pueden habilitar anclajes de enlaces personalizados para los enlaces de referencia, así como para definiciones de referencias y diversas anotaciones, lo que permite integrarse sin problemas con otros sistemas de citas utilizados en la misma página, o crear esquemas de enlaces sofisticados con enlaces a contenidos individuales y vínculos de retroceso a enlaces de referencia (es decir, que actúan como referencias abreviadas).
La plantilla permite definir y mostrar una sección de contexto en la prosa del artículo para indicar qué declaraciones específicas en el artículo están respaldadas por la referencia, si esto no es obvio desde donde se ubica 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 que faltan 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á información sobre herramientas por sí sola explicando la información truncada de la página/ubicación 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 las definiciones CSS correspondientes están activadas.
La plantilla optimiza el interletraje visual en el superíndice 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 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 aún más simplificada y más poderosa a la plantilla principal {{ r }} . Para obtener el máximo compatibilidad futura, use {{ rr }} cuando use parámetros enumerados (para admitir múltiples citas en una llamada) o use parámetros sin nombre).
Por ejemplo:
{{r}}
y <ref>
pueden coexistir en la misma página, y me gusta <ref>
, {{r}}
se pueden usar con o sin referencias definidas por lista . Además, un parámetro |page=
o |p=
agrega la funcionalidad de {{ rp }} :
La ubicación en el origen de una fuente se puede especificar con |page=
/ |p=
(para una sola página), con |pages=
/ |pp=
(para páginas en plural) o con // |location=
para otras ubicaciones en el origen.|loc=
|at=
Los números de página especificados pueden ser un único 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 los mismos. No agregue "Página", "páginas", etc., solo los números.
También se puede utilizar otra información sobre la ubicación de 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 vídeo.
Elija uno de los parámetros de plantilla anteriores según el tipo de página o ubicación de origen especificada.
Si bien normalmente solo se proporciona uno de estos tres tipos de parámetros, también es posible combinarlos para adaptarse a casos de uso más especiales. Si se proporcionan parámetros de página singular y plural al mismo tiempo, se supone que la información de la página plural es el intervalo del artículo, mientras que la información de la página singular se considera la página dentro de ese intervalo que respalda la declaración. La plantilla indicará esto enmarcando la página singular entre corchetes después de la información de la página plural. Si se proporciona una ubicación en el origen además de la información de la página, la plantilla asume que detalla más la información de la página anterior en lugar de representar algún tipo de información de ubicación en el origen independiente.
No intente utilizar varios alias de un parámetro al mismo tiempo. Sólo se elegirá uno y los demás podrán ignorarse sin mensaje de error.
Los nombres de las referencias pueden definirse dentro de una {{ reflist }} (como se ilustra a continuación) o (de la forma más habitual) dispersos por todo el texto del artículo utilizando, por ejemplo, <ref name="RefName">Reference text</ref>
o .{{refn|name=RefName|Reference text}}
===Notas=== {{ lista de referencia | grupo = "Notas" | refs = < nombre de referencia = "NtName" > Texto de nota. </ ref > < ref name = "NtCam" > Texto de nota de cámara. </ref> } } ===Referencias=== {{ lista de referencia | refs = < nombre de referencia = "Nombre de referencia" > Texto de referencia. </ ref > < ref name = "Bam" > Texto de referencia de Bam. </ ref > < ref name = "Bar" > Texto de referencia de la barra. </ ref > < ref name = "Bas" > Texto de referencia Bas. </ ref > < ref name = "Bahía" > Texto de referencia de la bahía. </ 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 del propio {{ r }} : [1] [2] [3] [4] [5] [6] [NB 1] [NB 2]
===Notas=== {{ lista de referencia | grupo = "NB" | referencias = {{ r | g = NB | NtNombre | r = Texto de nota. }} {{ r | g = NB | NtCam | r = Texto de nota de cámara. }} }}===Referencias=== {{ lista de referencia | referencias = {{ r | Nombre de referencia | r = Texto de referencia. }} {{ r | Bam | r = texto de referencia de Bam. }} {{ r | Barra | r = Texto de referencia de la barra. }} {{ r | Bajo | r = Texto de referencia básico. }} {{ r | Bahía | r = Texto de referencia de la bahía. }} {{ 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 vínculos retroactivos o cruzados agrupados bajo su cita completa correspondiente. Hay muchas variantes posibles, algunas se ilustran a continuación:
Ejemplo 1 (con vínculos de retroceso 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 reseña. {{ r | norte = C2 | pag = 70 }}| ID de enlace = L2 }}{{ r | norte = C3 | r = Cita 3 }}===Referencias=== {{ lista de referencia }}
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 revisión. {{ r | norte = C2 | pag = 70 }}| identificación = P2 | ID de enlace = L2B }}{{ r | norte = C3 | r = Cita 3 }}===Referencias=== {{ lista de referencia }}
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 | norte = C2 | pag = 70 }}| a = q | inicio = < br />[[# L2C | ^ ]] págs . | identificación = P2C | ID de enlace = L2C }}{{ r | norte = C3 | r = Cita 3 }}===Referencias=== {{ lista de referencia }}
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 en la página 56 de la revisión. [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/información de ubicación, |wrap=forced
se pueden usar en su lugar (sin embargo, si esto realmente da como resultado saltos de línea, también depende del navegador, CSS y el skin seleccionado).
Según MOS:DASH , los rangos de páginas normalmente deben declararse con un ndash ( {{r|name=RefName|pages=27–29}}
→ [1] : 27–29 ) en lugar de un guión. Herramientas como WP:AWB convertirán automáticamente guiones en guiones en tales casos. Para los parámetros de página en plural |pages=
y |pp=
los |quote-pages=
alias, {{ r }} traducirá automáticamente los guiones a ndashes para fines de visualización. (Esto no se aplica a los parámetros singulares y otros en la ubicación de origen |page=
, |p=
, |at=
, |loc=
y |quote-page=
alias). Si realmente se desea el guión por cualquier motivo, el marcado " aceptar esto como está escrito " (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 ) se pueden usar para indicar esto ( {{r|name=RefName|pages=((27-29)), 41}}
→ [ 1] : 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 del artículo no funcionan dentro de un conjunto de <ref>...</ref>
etiquetas, incluidos, entre otros, el truco de canalización , la sustitución de plantillas<ref>...</ref>
y otro conjunto de 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 una etiqueta <ref> le falta el cierre </ref> (consulte 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 {{ extracto }} . {{ r }} no debe usarse en secciones que serán transcluidas por {{ extracto }} .
Datos de plantilla para R
Proporciona un contenedor simple para hasta nueve etiquetas de cita <ref name=RefName/> consecutivas que minimiza el impacto visual en el texto y que, junto con una sintaxis más simple, aumenta la legibilidad del código y la facilidad de edición.