Ayuda:Cita

This page is a translated version of the page Help:Cite and the translation is 100% complete.

Nota: Cuando editas esta página, aceptas liberar tu contribución bajo la licencia CC0. Para más información mira las páginas de ayuda de dominio público.
Algunas versiones antiguas de esta página fueron importadas bajo licencia CC BY-SA. Solo las contribuciones nuevas están en el dominio público (DP).

Cita permite añadir notas al pie de una página.

Consulta los detalles técnicos en la página de la Cite extension .

Uso

El concepto básico de la etiqueta ‎<ref> es que inserta el texto encerrado entre las etiquetas ref como una nota al pie en una sección designada que se indica con la etiqueta de espacio reservado ‎<references />. Este formato no se puede utilizar de forma intercambiable con el formato anterior: debes elegir entre uno o el otro.

Se pueden insertar etiquetas adicionales de espacio reservado ‎<references />, y todas las etiquetas ‎<ref> hasta ese punto, en ese grupo, se insertarán allí.

Si olvidas incluir ‎<references /> en el artículo, las notas al pie no desaparecerán, pero las referencias se mostrarán al final de la página.

Esta propia página utiliza notas al pie, como la que termina esta frase.^{[note 1]} Si consultas la fuente de esta página haciendo clic en «Editar esta página», podrás ver un ejemplo funcional de notas al pie.

Wikitexto	Representación
El Sol es bastante grande.<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> La Luna, sin embargo, no es tan grande.<ref>R. Smith, «Size of the Moon», ''Scientific American'', 46 (abril de 1978): 44–46.</ref> == Notas == <references />	El Sol es bastante grande.^[1] La Luna, sin embargo, no es tan grande.^[2] Notas ↑ E. Miller, The Sun, (Nueva York: Academic Press, 2005), 23–25. ↑ R. Smith, «Size of the Moon», Scientific American, 46 (abril de 1978): 44–46.

Reutilización de notas al pie

Para darle un identificador único a una nota al pie, utiliza ‎<ref name="name"> («nombre»). Luego podrás referirte a la misma nota al pie empleando una etiqueta ref con el mismo nombre. El texto en el interior de la segunda etiqueta no importa porque ya existe en la primera referencia. Puedes optar por copiar la nota al pie entera o por utilizar una etiqueta ref cerrada y vacía con este aspecto: ‎<ref name="name" />. Los nombres son únicos dentro de su grupo, no a nivel global; es decir, una referencia ‎<ref group="note" name="source-a">...‎</ref> solo se puede reutilizar como ‎<ref group="note" name="source-a" />.

En el siguiente ejemplo, se cita la misma fuente tres veces.

Wikitexto

Resultado

Este es un ejemplo de varias referencias a una misma nota al pie.<ref name="multiple">Recuerda que, al referirte a la misma nota al pie varias veces, se utilizará el texto de la primera referencia.</ref>

Este tipo de referencias son particularmente útiles a la hora de citar fuentes si hay varias declaraciones provenientes de la misma fuente.<ref name="multiple" /> Cualquier etiqueta reutilizada no debe incluir contenido adicional, ya que generará un error. Utiliza únicamente etiquetas vacías de esta manera.

Una forma concisa de crear referencias múltiples es mediante etiquetas ref vacías, que terminan con una barra oblicua.
Aunque esto puede reducir trabajo redundante, ten en cuenta que si un editor futuro elimina la primera referencia, esto resultará en la pérdida de todas las referencias que utilicen las etiquetas ref vacías.<ref name="multiple" />

== Notas ==
<references />

Este es un ejemplo de varias referencias a una misma nota al pie.^[1]

Este tipo de referencias son particularmente útiles a la hora de citar fuentes si hay varias declaraciones provenientes de la misma fuente.^[1] Cualquier etiqueta reutilizada no debe incluir contenido adicional, ya que generará un error. Utiliza únicamente etiquetas vacías de esta manera.

Una forma concisa de crear referencias múltiples es mediante etiquetas ref vacías, que terminan con una barra oblicua. Aunque esto puede reducir trabajo redundante, ten en cuenta que si un editor futuro elimina la primera referencia, esto resultará en la pérdida de todas las referencias que utilicen las etiquetas ref vacías.^[1]

Notas

↑ ^1.0 ^1.1 ^1.2 Recuerda que, al referirte a la misma nota al pie varias veces, se utilizará el texto de la primera referencia.

Ten en cuenta que los identificadores utilizados en el atributo name requieren caracteres alfabéticos; si solo empleas números, se generará un mensaje de error. Se recomienda el uso de comillas para los nombres, y es obligatorio cuando el nombre incluye un espacio, un signo de puntuación u otra marca. Se recomienda utilizar nombres sencillos y restringidos al conjunto de caracteres ASCII.

La etiqueta `‎<references />`

La etiqueta ‎<references /> inserta el texto de todas las citas que se hayan definido en etiquetas ‎<ref> hasta ese punto de la página. Por ejemplo, basándonos en las citas anteriores, debería haber una referencia para el grupo note.

Wikitexto	Resultado
<references group="note"/>	↑ Esta nota al pie se emplea a modo de ejemplo en la sección «Uso».

La lista de referencias puede tener un ancho dinámico (mostrándose en algunos casos las referencias en varias columnas). En ese caso, se utiliza el atributo responsive para configurar dicho comportamiento. En los wikis con la configuración por defecto, esto sucederá en cada página; en los demás, tendrás que activarlo.

Si una página incluye más de una lista ‎<references />, cada lista incluirá las etiquetas ‎<ref> definidas después de la lista anterior de referencias. Si estas listas de referencias están producidas por plantillas, cada una contendrá las etiquetas ref definidas antes de la primera lista de referencias, y habrá un mensaje de error que dice que hay una etiqueta ref pero no una lista de referencias.

Agrupación de referencias

Esto se puede deshabilitar mediante $wgAllowCiteGroups = false; si se desea.

El siguiente ejemplo genera listas separadas de referencias para citas y notas al pie variadas:

Wikitexto

Resultado

Según los científicos, el Sol es bastante grande.<ref>E. Miller, ''The Sun'', (Nueva York: Academic Press, 2005), 23–25.</ref> De hecho, es muy grande.<ref group="footnotes"> Confía en su palabra. ¡No mires directamente al Sol!</ref>

== Notas ==
<references group="footnotes" />

== Referencias ==
<references />

Según los científicos, el Sol es bastante grande.^[1] De hecho, es muy grande.^{[footnotes 1]}

Notas

↑ Confía en su palabra. ¡No mires directamente al Sol!

Referencias

↑ E. Miller, The Sun, (Nueva York: Academic Press, 2005), 23–25.

El grupo anónimo funciona como antes, mientras que las referencias destinadas al grupo nombrado solo se mostrarán en el elemento designado ‎<references />.

Ten en cuenta que los identificadores utilizados en el atributo group requieren caracteres alfabéticos; si solo empleas números, se generará un mensaje de error. Se recomienda el uso de comillas para los nombres, y es obligatorio cuando el nombre incluye un espacio, un signo de puntuación u otra marca. Se recomienda utilizar nombres sencillos y restringidos al conjunto de caracteres ASCII.

Se puede personalizar la presentación de un grupo dado a nivel de wiki creando MediaWiki:Cite_link_label_group-<name> y enumerando los signos utilizados en orden de aparición y separados por espacios o saltos de línea.

Por ejemplo, si se crea MediaWiki:Cite_link_label_group-lower-alpha con el contenido

a b c d e f g h i j k l m n o p q r s t u v w x y z

entonces el primer <ref group="lower-alpha">...</ref> se mostrará como ^[a], el segundo como ^[b], etc., y el 26.º se mostrará como

a b c d e f g h i j k l m n o p q r s t u v w x y z

6

Es un error utilizar más notas al pie en un grupo de presentación personalizada que el número de signos definidos, por lo que la 27.ª nota al pie de este grupo generará un error.

Los siguientes nombres de grupos a menudo se definen como grupos personalizados mediante los mensajes correspondientes:

nombre del grupo	mensaje
`upper-alpha`	MediaWiki:Cite link label group-upper-alpha
`lower-alpha`	MediaWiki:Cite link label group-lower-alpha
`upper-roman`	MediaWiki:Cite link label group-upper-roman
`lower-roman`	MediaWiki:Cite link label group-lower-roman
`lower-greek`	MediaWiki:Cite link label group-lower-greek

Las páginas Cite link label group no están creadas por defecto. Si un wiki no las configura, un marcado tal como <ref group="lower-alpha">...</ref> se mostrará como ^{lower-alpha 1}.

Citar distintas partes de la misma fuente

Al utilizar varias partes de una misma obra como referencias en un artículo, puedes agruparlas en la sección de referencias. Esto proporciona a los lectores una forma de identificar qué referencias provienen de una misma fuente. También te permite citar distintas partes de una misma fuente sin tener que repetir la fuente entera cada vez.

Wikitexto

Resultado

Según los científicos, el Sol es bastante grande.<ref name="Miller">E. Miller, ''The Sun'', (Nueva York: Academic Press, 2005), 23–25.</ref> De hecho, es muy grande.<ref extends="Miller">p. 123</ref> Confía en su palabra. ¡No mires directamente al Sol!<ref extends="Miller">p. 42</ref>

== Referencias ==
<references />

Según los científicos, el Sol es bastante grande.^[1] De hecho, es muy grande.^[1.1] Confía en su palabra. ¡No mires directamente al Sol!^[1.2]

Referencias

1. E. Miller, The Sun, (Nueva York: Academic Press, 2005), 23–25.
1.1 ↑ p. 123
1.2 ↑ p. 42

Esta característica aún no funciona en los wikis fuera del clúster beta, por eso el ejemplo anterior es una simulación. Puedes seguir la actualización del proyecto en m:Deseos técnicos de WMDE/Referenciar libros.

Separar las referencias del texto

Las referencias dentro del texto hace que sea fácil copiar el texto a otra página, aunque por otra parte hacen que sea más difícil de leer. Las referencias que contienen muchos datos, citas o plantillas elaboradas de cita pueden suponer una fracción significativamente mayor de la fuente que el texto realmente visible. Para evitarlo, las versiones más recientes de la extensión permiten trasladar algunas o todas las referencias a la sección ‎<references />, al lugar donde se mostrarán al lector.

Wikitexto

Resultado

Según los científicos, el Sol es bastante grande.<ref name="miller" /> La Luna, sin embargo, no es tan grande.<ref name="smith" />

== Notas ==
<references>
<ref name="miller">E. Miller, ''The Sun'', (Nueva York: Academic Press, 2005), 23–25.</ref>
<ref name="smith">R. Smith, «Size of the Moon», ''Scientific American'', 46 (abril de 1978): 44–46.</ref>
</references>

Según los científicos, el Sol es bastante grande.^[1] La Luna, sin embargo, no es tan grande.^[2]

Notas

↑ E. Miller, The Sun, (Nueva York: Academic Press, 2005), 23–25.
↑ R. Smith, «Size of the Moon», Scientific American, 46 (abril de 1978): 44–46.

Así, el código anterior tendrá la misma salida que el primer ejemplo más arriba, aunque la numeración y el orden de las referencias en general no será el mismo.

Si un grupo está definido con ‎<references group>, no necesita ser especificado también en cada hijo ‎<ref />.

Funciones de sustitución y funciones integradas del analizador sintáctico

Dado que la etiqueta ‎<ref> de Cita se analiza antes de las funciones de análisis sintático (como {{#ifexpr:…}}) y las variables de MediaWiki (como {{PAGENAME}}) y antes de subst:, no funcionará dentro de referencias de cita. En lugar de ello, tendrás que utilizar la palabra mágica {{#tag:…}}.

Wikitexto

Resultado

Foo<ref>Esto no funciona, consulta {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}</ref> bar baz…
Foo{{#tag:ref|Mientras que esto sí, consulta {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}}} bar baz…
<references />

Foo^[1] bar baz… Foo^[2] bar baz…

↑ Esto no funciona, consulta "Search" . Retrieved on [[{{subst:#time:Y-m-d|now}}]].
↑ Mientras que esto sí, consulta "Search" . Retrieved on 2021-03-11.

Añadir un encabezado automático antes de la lista de referencias

Hasta MediaWiki 1.28, se podía utilizar el mensaje de sistema MediaWiki:Cite references prefix para definir un encabezado a nivel de wiki que se insertaría automáticamente antes de cada lista de referencias. En MediaWiki 1.29, se retiró este mensaje de sistema. Un apaño actual para introducir un encabezado consiste en añadir el siguiente código a MediaWiki:Common.js:

$(document).ready(function(){
    $('.mw-references-wrap').before('<h2>Referencias</h2>');
});

En en cuenta que esto añade el encabezado incondicionalmente, es decir, si ya tienes el encabezado, se vuelve a añadir creándose así encabezados duplicados.

Si solo necesitas un encabezado textual (sin enlace ni otros elementos activos), puedes añadir lo siguiente a MediaWiki:Common.css (Chrome 4, IE9, FF 3.5, Safari 3.1, Opera 7):

.mw-references-wrap::before {
  content: "Blue references";
  color: #0645ad;
  text-decoration: none;
  background: none;
  font-style: italic;
  font-size: 100%;
  font-weight: bold;
  line-height: 1.6;
  direction: ltr;
  font-family: sans-serif;
}

Fusionar dos textos en una sola referencia

Un problema habitual en Wikisource son referencias que se abarcan varias páginas en el material fuente. Estas se pueden fusionar utilizando una etiqueta ‎<ref name="name"> para la primera parte de la referencia, y etiquetando las partes siguientes con una etiqueta ‎<ref follow="name"> con el mismo nombre.

Ejemplo:

Wikitexto

Resultado

Este es un ejemplo de fusionar varios textos en una misma nota al pie.<ref name="main">Recuerda que todos los textos se incluirán en la referencia que contenga el atributo name="…".</ref>

<ref follow="main">Simplemente incluye el texto adicional en una etiqueta con el atributo follow="…" que coincida con el nombre del primer ref.</ref>

== Referencias ==
<references/>

Este es un ejemplo de fusionar varios textos en una misma nota al pie.^[1]

Referencias

↑ Recuerda que todos los textos se incluirán en la referencia que contenga el atributo name="…". Simplemente incluye el texto adicional en una etiqueta con el atributo follow="…" que coincida con el nombre del primer ref.

Al utilizar esta sintaxis, procura que la parte «follow» de la nota al pie esté incluida en la misma página que la primera parte de la referencia.

Ten en cuenta que los nombres de referencia no pueden comenzar con un número, así que incluye siempre algún texto tal como <ref name="p32"> y <ref follow="p32">.

Personalización

El formato de la salida de ‎<ref> y ‎<references> es personalizable casi por completo mediante mensajes de MediaWiki que se pueden modificar, por ejemplo, a través del espacio de nombres MediaWiki, dependiendo de la configuración del wiki.

Para una lista de mensajes que controlen la salida de ‎<ref> y ‎<references> y los valores, si los hay, que se les pasan ($1, $2, $3, etc.), consulta una lista actualizada de los valores por defecto que se puede obtener directamente desde MediaWiki.

Lista incompleta

cite_reference_link_key_with_num
1. clave
2. número
cite_reference_link_prefix
cite_reference_link_suffix
cite_references_link_prefix
cite_references_link_suffix
cite_reference_link
1. identificador de la referencia
2. identificador del retroenlace
3. contador mostrado
cite_references_link_one
- Utilizado para dar formato a la lista de fuentes generada por ‎<references />; configura tres elementos: identificador del retroenlace, identificador de referencia y texto de la nota.
1. identificador del retroenlace — Utilizado para crear el orden numérico de la lista de fuentes.
2. identificador de la referencia — Utilizado para enlazar de vuelta a la referencia real en el texto; aquí se configura el símbolo ^.
3. texto de la nota — texto utilizado antes para describir la información de la fuente
cite_references_link_many
1. identificador del retroenlace
2. lista de enlaces
3. texto de la nota
cite_references_link_many_format
1. identificador de la referencia
2. valor numérico que utilizar como retroenlace
3. valor personalizado (definido en cite_references_link_many_format_backlink_labels para utilizar como retroenlace)
cite_references_link_many_format_backlink_labels
cite_references_link_many_sep
cite_references_link_many_and
cite_references_suffix

Establecer que las referencias utilicen ^ y letras

Para reemplazar la flecha hacia arriba por defecto (↑) por un circunflejo (^), modifica el siguiente mensaje de sistema. Todas estas páginas se pueden encontrar en Special:AllMessages.

MediaWiki:Cite reference backlink symbol

Antes	Después
↑	^

MediaWiki:Cite references link many format

Reemplazar $2 por $3 cambia los enlaces de 1.0, 1.1, 1.2 a a, b, c, etc...

Antes	Después
<sup>[[#$1\|$2]]</sup>	<sup>[[#$1\|$3]]</sup>

Al buscar estas páginas por primera vez, no se devolverá ningún resultado. Simplemente haz clic en «Crear esta página» para editar el código. Los cambios no se mostrarán hasta que se haya reconstruido una página con referencias.

Establecer un resaltado para la referencia y el número de referencia

Desde MediaWiki 1.26, los selectores de resaltado están incorporados en Cite/modules/ext.cite.css. Por lo tanto, ya no es necesario añadir a mano el siguiente código CSS.

Añade el siguiente código a la página MediaWiki:Common.css.

/* hace que la lista de referencias de la extensión Cita se vea más pequeña y resalta en azul la referencia sobre la que se ha hecho clic */
ol.references { font-size: 90%; }
ol.references li:target { background-color: #ddeeff; }
sup.reference:target { background-color: #ddeeff; }

Referencias rotas

Si se utiliza incorrectamente la etiqueta ‎<ref> o ‎<references />, la extensión Cita añadirá a la página un mensaje de error así como la categoría «Páginas con errores en las referencias». Estos mensajes de error se mostrarán en el idioma de la interfaz del usuario, ya sea en el contenido del artículo o en la sección Referencias. Por ejemplo:

Wikitexto	Resultado
Este es un ejemplo de mensaje de error en las referencias.<ref broken>Texto previsto.</ref> == Notas == <references />	Este es un ejemplo de mensaje de error en las referencias.Cite error: Invalid parameter in `<ref>` tag Notas

Consulta la especificación de la representación de errores de Cita en Parsoid.

Véase también

Ayuda:Etiquetas de enlaces de Cita

[2] E. Miller, The Sun, (Nueva York: Academic Press, 2005), 23–25.

[3] R. Smith, «Size of the Moon», Scientific American, 46 (abril de 1978): 44–46.

[multiple-4] 1.0 ^1.1 ^1.2 Recuerda que, al referirte a la misma nota al pie varias veces, se utilizará el texto de la primera referencia.

[1] Esta nota al pie se emplea a modo de ejemplo en la sección «Uso».

[6] Confía en su palabra. ¡No mires directamente al Sol!

[5] E. Miller, The Sun, (Nueva York: Academic Press, 2005), 23–25.

[miller-7] E. Miller, The Sun, (Nueva York: Academic Press, 2005), 23–25.

[smith-8] R. Smith, «Size of the Moon», Scientific American, 46 (abril de 1978): 44–46.

[9] Esto no funciona, consulta "Search" . Retrieved on [[{{subst:#time:Y-m-d|now}}]].

[10] Mientras que esto sí, consulta "Search" . Retrieved on 2021-03-11.

[main-11] Recuerda que todos los textos se incluirán en la referencia que contenga el atributo name="…". Simplemente incluye el texto adicional en una etiqueta con el atributo follow="…" que coincida con el nombre del primer ref.

[note 1]

[1]

[2]

[1]

[1]

[footnotes 1]

[1]

[2]

[1]

[2]

[1]

Uso

Reutilización de notas al pie

La etiqueta ‎<references />

Agrupación de referencias

Citar distintas partes de la misma fuente

Separar las referencias del texto

Funciones de sustitución y funciones integradas del analizador sintáctico

Añadir un encabezado automático antes de la lista de referencias

Fusionar dos textos en una sola referencia

Personalización

Establecer que las referencias utilicen ^ y letras

Establecer un resaltado para la referencia y el número de referencia

Referencias rotas

Véase también

La etiqueta `‎<references />`