Ayuda: Referencias definidas por lista

Las referencias definidas por lista (LDR) son referencias que se definen en el marcado de la lista de referencias, en lugar de estar definidas en el cuerpo del artículo. Las LDR se implementaron en septiembre de 2009 como una forma de facilitar la referencia de artículos y despejar el desorden.

Esta página es una continuación de una sección de Ayuda:Notas al pie . Esta guía supone que está familiarizado con las herramientas que se explican allí, como las características de <ref>...</ref>las etiquetas y el parámetro.<ref name="REFNAME" />

LDR dificulta la visualización y edición de referencias para los usuarios del editor visual . Es posible que desee considerar esto antes de implementarlo.

Descripción general

LDR utiliza referencias con nombre donde cada referencia individual tiene un nombre único y se define dentro del marcado de la lista de referencias:

< referencias >  < ref nombre = "nombre1" > referencia </ ref > < ref nombre = "nombre2" > referencia2 </ ref > </ referencias >   

O bien; usando {{ reflist }}

{{ reflist | refs =  < ref nombre = "nombre1" > referencia </ ref > < ref nombre = "nombre2" > referencia2 </ ref > }}   

Como alternativa, las referencias se pueden definir utilizando la plantilla contenedora 'referencia' {{ r }} (para abreviar, los nombres de los parámetros |name=y |ref=se pueden abreviar como |n=y |r=):

< referencias >  {{ r | nombre = "nombre1" | ref = referencia }}  {{ r | nombre = "nombre2" | ref = referencia2 }} </ referencias >

O; con {{ reflist }}

{{ reflist | refs =  {{ r | nombre = "nombre1" | ref = referencia }}  {{ r | nombre = "nombre2" | ref = referencia2 }} } }

Cada referencia se invoca en el cuerpo del texto utilizando <ref name="name1" />o .{{r|name}}

Los nombres de las notas a pie de página y de los grupos deben seguir estas reglas:

• Los nombres distinguen entre mayúsculas y minúsculas. No utilice mayúsculas y minúsculas aleatorias.
• Los nombres no deben ser puramente numéricos; el software aceptará algo como ":31337"(que es puntuación más un número), pero ignorará "31337"(puramente numérico).
• Los nombres deben tener un valor semántico, de modo que los editores humanos que consulten el wikitexto puedan distinguirlos más fácilmente entre sí. Esto significa que "Nguyen 2010"se prefieren nombres de referencia como ":31337".
• Los nombres deben ser únicos. No se puede utilizar el mismo nombre para definir diferentes grupos o notas al pie. Trate de evitar elegir un nombre que probablemente otra persona elija para una nueva cita, como ":0"o "NYT".
• Considere mantener los nombres de referencia breves, simples y restringidos al alfabeto y los números estándar del inglés. Si se utilizan espacios, se aplican las siguientes restricciones técnicas:
  • Se prefieren las comillas, pero son opcionales si los únicos caracteres utilizados son letras A–Z, a–zdígitos 0–9y símbolos !$%&()*,-.:;<@[]^_`{|}~. Es decir, todos los caracteres ASCII imprimibles excepto #"'/=<>?\el espacio.
  • La inclusión de cualquier otro carácter, incluidos los espacios , requiere que el nombre de referencia esté entre comillas; por ejemplo, name="John Smith". Pero los nombres de referencia entre comillas no pueden incluir un signo menor que ( <) o un símbolo de comillas dobles rectas ( "), que sin embargo pueden incluirse mediante el método de escape como <y "respectivamente.
  • Las comillas deben ser comillas dobles rectas estándar ( "); las comillas curvas o de otro tipo se analizarán como parte del nombre de referencia.
• Opcionalmente, puede proporcionar nombres de referencia incluso cuando no sean necesarios. Esto facilita la reutilización posterior de la referencia de la fuente.

Pautas

• Todas las referencias definidas en listas deben tener un nombre . Se puede utilizar cualquier nombre que cumpla con las limitaciones técnicas mencionadas anteriormente; sin embargo, deben ser coherentes para que otros usuarios puedan editarlos. Una práctica muy utilizada es la de autor-fecha, autor-título o publicación-fecha.
• Además, cualquier referencia no utilizada generará un error . Todas las referencias definidas por listas deben usarse en el cuerpo y viceversa, todas <ref name="ABC">...</ref>las etiquetas deben tener información de definición.
• Las referencias definidas en listas y las referencias definidas en el cuerpo del artículo pueden mezclarse en una página (no se trata de una limitación técnica de la plantilla). Sin embargo, esto puede resultar confuso para los editores habituales y debería normalizarse en un único estilo, según WP:CITEVAR .
• Las listas de referencias se pueden ordenar de cualquier manera (por ejemplo, alfabéticamente por nombre de referencia), pero la lista generada estará en el orden en que se invocan las referencias.

Ejemplos

Notas de uso

El uso de referencias definidas por listas significa que, durante la edición, las referencias y las notas al pie formateadas de esta manera se insertan en la sección de origen donde se encuentra la plantilla. Esto es principalmente un cambio en el código fuente y no afecta la visualización del artículo para el lector. Los efectos principales son para los editores, como se describe a continuación.{{reflist|refs= }}

El método LDR elimina los detalles o notas de las citas que podrían interrumpir la ventana de edición mientras se edita el cuerpo del texto, lo que resulta especialmente útil si son verticales o abarcan varias líneas. Además, esta sección de lista de referencias centralizada se puede abrir por sí sola si es necesario modificar alguna de las entradas de citas, lo que puede resultar especialmente útil si se intenta modificar una referencia que se utiliza varias veces, lo que evita la necesidad de buscarla en toda la fuente.

Una desventaja de este enfoque es que estas referencias pueden ser más difíciles de insertar en la fuente, porque están separadas del texto. El editor debe abrir el documento completo para ver la fuente tanto del texto como de la lista de referencias, o bien utilizar un procedimiento de dos pasos, introduciendo primero el identificador en el texto principal y luego abriendo la sección de lista de referencias para introducir la fuente o la nota al pie como . Otro inconveniente de este enfoque es que la lista al final del artículo debe estar organizada de forma que un editor pueda encontrarla fácilmente; lo más probable es que se ordene alfabéticamente en la ventana de edición por nombre de referencia, ya que es más probable que esto conserve la integridad y la utilidad de la fuente, incluso si se modifican las secciones del texto.<ref name="name" /><ref name="name">content</ref>

Aunque suele ser más ordenado eliminar todas las citas del texto fuente, un compromiso aceptable (especialmente para artículos pequeños) podría ser utilizar LDR solo para citas utilizadas varias veces. Esto se debe a que ya utilizan el código de nombre de referencia, por lo que pueden estar en varios lugares: un simple traslado del código fuente de la referencia desde su primera aparición a la lista de referencias es un cambio menor. Además, es más probable que estas citas necesiten revisión o modificación, porque son más importantes para el artículo y contienen más detalles, y hacer que sean más fáciles de encontrar y modificar puede ser muy útil. Finalmente, esto también mantiene la integridad de la fuente si cambia la primera instancia de la referencia, como se señaló anteriormente.

Además, un script creado por el usuario, User:PleaseStand/References segregator, le permite separar automáticamente las citas de la ventana de edición y recopilarlas temporalmente en una ventana separada de "citas en línea". En este formato, las citas se pueden insertar manualmente en la lista de referencias. Esto puede tener algunos de los beneficios de las LDR permanentes cuando su uso no es práctico o va en contra del consenso. Sin embargo, tenga en cuenta que antes de guardar la página, cualquier contenido de esta ventana se reemplazará en la fuente de texto principal en la primera etiqueta coincidente a menos que se vacíe manualmente. Como se describe en su página y a continuación, tiene un script de conversión automática que puede procesar citas existentes en una lista de referencias por sí mismo, pero no se sabe si puede hacer esta migración durante la edición.<ref name="name" />

Por último, existen algunos conceptos erróneos sobre las notas al pie definidas por listas:

1. Una de ellas es que la creación de listas de notas al pie separadas requiere el uso de notas al pie definidas por listas. Sin embargo, el uso de un nombre de "grupo" para diferenciar varios tipos de notas al pie está disponible independientemente de si se utilizan notas al pie definidas por listas o notas al pie en línea. Por ejemplo, en ambos casos se pueden designar notas como un grupo llamado "Nota" y separarlas de las citas simples mediante el uso de la etiqueta en línea (la explicación completa del uso de nombres de grupo se ilustra en el segundo ejemplo de la sección inmediatamente anterior).<ref group="Note" name="name" />
2. Otro error es pensar que existe una opción entre utilizar notas al pie definidas por listas y notas al pie en línea, y que todas las citas de un artículo deben seguir solo uno de los estilos. De hecho, es totalmente compatible con el uso de notas al pie en línea en la forma o . Aunque el uso de ambos sistemas en el mismo artículo puede parecer confuso o indeseable, es un hecho que los dos sistemas se pueden mezclar indiscriminadamente con la plantilla .{{reflist|refs= }}<ref>content</ref><ref name="name">content</ref>{{reflist|refs= }}

Errores

A veces, las referencias pueden producir errores que aparecen en texto rojo. Consulta Ayuda:Errores de citas para diagnosticar y resolver estos errores. Como alternativa, compara tu código con el ejemplo anterior o la documentación de la lista de referencias en Plantilla:Reflist § Referencias definidas por listas . En particular, los errores en la etiqueta de referencia nombrada o en el código de la lista de referencias pueden causar problemas, ya que se deben definir y utilizar entradas en ambos para que funcione una lista de referencias definidas por listas.

Mudado

Los estilos de referencia se pueden convertir desde o hacia referencias definidas en listas, siguiendo las mismas reglas para otros cambios importantes en el estilo de cita, en WP:CITEVAR . User:PleaseStand/segregate-refs.js tiene una opción para ayudar con la conversión.

Editor visual

Puede reutilizar las referencias definidas por listas existentes en el Editor visual para obtener citas adicionales, pero no puede agregar ni eliminar referencias definidas por listas. Tampoco admite la modificación de referencias definidas por listas dentro de {{ reflist }} , solo <references/>. Esto perjudicará a los usuarios del Editor visual y es posible que desee considerar estas limitaciones si está interesado en agregar referencias definidas por listas.

Véase también

• Plantilla:R – esta plantilla reduce el texto necesario para definir e invocar referencias nombradas, <ref name="foo"/> se convierte en {{r|foo}}
• Plantilla: Utilizar referencias definidas por lista : esta plantilla opcional se puede utilizar para indicar a los editores y herramientas que un artículo utiliza referencias definidas por lista.
• Organizador de referencia ^[1] ( fuente )– es una herramienta que presenta todas las referencias en una interfaz gráfica de usuario, donde puede elegir si las referencias deben definirse en el cuerpo del artículo o en la(s) plantilla(s) de lista de referencias (formato definido por lista). La elección se puede aplicar a todas las referencias, a todas las referencias con un cierto número de usos (citas) o marcando referencias individualmente. También puede ordenar las referencias de varias maneras (y mantener el orden de clasificación en la plantilla de lista de referencias) y cambiarles el nombre. Utilícela solo si hay consenso .

Referencias

1. Copia el siguiente código, edita tu JavaScript de usuario y luego pégalo:
   {{subst:lusc|1=User:Cumbril/RefConsolidate_start.js}}