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. LDR se implementó en septiembre de 2009 como una forma de hacer que las referencias a artículos sean más fáciles y menos desordenadas.

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 allí se explican, como las características de <ref>...</ref>las etiquetas y el parámetro.<ref name="REFNAME" />

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; usando {{ reflist }}

{{ volver a listar | refs =  < ref nombre = "nombre1" > referencia </ ref > < ref nombre = "nombre2" > referencia2 </ ref > }}   

Alternativamente, las referencias se pueden definir usando la plantilla contenedora de 'referenciación' {{ r }} (para mayor brevedad, 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 }}

{{ volver a listar | referencias =  {{ r | nombre = "nombre1" | ref = referencia }}  {{ r | nombre = "nombre2" | ref = referencia2 }} }}

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

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

• Los nombres distinguen entre mayúsculas y minúsculas. Por favor no utilice mayú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 lo ignorará "31337"(puramente numérico).
• Los nombres deben tener valor semántico, para que los editores humanos que miran el wikitext puedan distinguirlos más fácilmente entre sí. Esto significa que se prefieren nombres de referencia como "Nguyen 2010"a nombres como ":31337".
• Los nombres deben ser únicos. No podrá utilizar el mismo nombre para definir diferentes grupos o notas al pie. Trate de evitar elegir un nombre que otra persona probablemente 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 en inglés estándar . Si se utilizan espacios, se vuelven relevantes 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 ( "), que sin embargo pueden incluirse escapando como <y "respectivamente.
  • Las comillas deben ser comillas dobles, rectas y estándar ( "); Las comillas rizadas u otras se analizarán como parte del nombre de referencia.
• Opcionalmente, puede proporcionar nombres de referencia incluso cuando el nombre de referencia no sea necesario. Esto facilita la reutilización posterior de la referencia obtenida.

Pautas

• Todas las referencias definidas por lista deben tener nombre . Se puede utilizar cualquier nombre que cumpla con las limitaciones técnicas anteriores; sin embargo, deben ser coherentes para que otros usuarios puedan editarlos. Una práctica muy utilizada es fecha de autor, título de autor o fecha de publicación.
• Además, cualquier referencia no utilizada generará un error . Todas las referencias definidas por lista deben usarse en el cuerpo y viceversa, todas <ref name="ABC">...</ref>las etiquetas deben tener información de definición.
• Las referencias definidas por lista y las referencias definidas en el cuerpo del artículo se pueden mezclar en una página; esto no es una limitación técnica de la plantilla. Sin embargo, esto puede resultar confuso para los editores actuales y debe normalizarse a un solo estilo, según WP:CITEVAR .
• Las listas de referencias pueden ordenarse 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 lista significa que durante la edición, todas las referencias y notas al pie formateadas de esta manera se insertan en la sección fuente donde se encuentra la plantilla. Esto es principalmente un cambio en el código fuente y no afecta la visualización del artículo al lector. Los efectos principales son para editores, como se describe a continuación.{{reflist|refs= }}

El método LDR elimina cualquier detalle de cita o nota que pueda interrumpir la ventana de edición mientras se edita el cuerpo del texto, lo cual es 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 alguna de las entradas de citas necesita modificación, lo que puede ser especialmente útil si se intenta modificar una referencia que se utiliza varias veces, evitando la necesidad de buscarla en toda la fuente.

Un inconveniente 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 alternativamente usar un procedimiento de dos pasos, ingresando primero el identificador en el texto principal y luego abriendo la sección de lista de referencias para ingresar la fuente o nota a pie de página como . Otra ventaja de este enfoque es que la lista al final del artículo debe organizarse de modo que un editor pueda encontrarlos fácilmente; lo más probable es que estén ordenados alfabéticamente en la ventana de edición por nombre de referencia, ya que es más probable que esto conserve la integridad y utilidad de la fuente. , incluso si se cambian las secciones del texto.<ref name="name" /><ref name="name">content</ref>

Si bien suele ser más ordenado eliminar todas las citas del texto fuente, un compromiso aceptable (especialmente para artículos pequeños) podría ser usar LDR solo para citas utilizadas varias veces. Esto se debe a que ya usan el código de nombre de referencia para que puedan estar en varios lugares; un simple movimiento del código fuente de la referencia desde su primera aparición a la lista de referencia 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 hacerlas más fáciles de encontrar y modificar puede ser muy útil. Finalmente, esto también mantiene la integridad del código fuente si la primera instancia de la referencia cambia, como se señaló anteriormente.

Además, un script creado por el usuario Usuario : 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 borre 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í solo, pero no está claro si puede realizar esta migración mientras edita.<ref name="name" />

Finalmente, existen algunas ideas erróneas 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 lista o en línea. Por ejemplo, en ambos casos se pueden designar notas como un grupo llamado "Nota" y separarlas de citas simples usando 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 arriba.)<ref group="Note" name="name" />
2. Otro concepto erróneo es que existe una opción de "uno u otro" entre el uso de notas al pie definidas por lista y notas al pie en línea, y que todas las citas en un artículo deben seguir solo uno de los estilos. De hecho, es totalmente compatible con el uso de notas a pie de página en línea en el formulario o . Aunque el uso de ambos sistemas en un mismo artículo puede parecer confuso o indeseable, es un hecho que los dos sistemas pueden mezclarse 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. Consulte Ayuda: citar errores para ayudar a diagnosticar y resolver estos errores. Alternativamente, verifique su código con el ejemplo anterior o con la documentación de la lista de referencias en Plantilla:Reflist § Referencias definidas por lista . En particular, los errores en la etiqueta de referencia nombrada o en el código de la lista de referencia pueden causar problemas, ya que se deben definir y utilizar entradas en ambos para que un LDR funcione.

Mudado

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

Editor visual

Puede editar referencias definidas por lista existentes en VisualEditor. No puede agregar ni eliminar referencias definidas por lista. Tampoco admite la modificación de referencias definidas por lista dentro de {{ reflist }}, solo <referencias/>.

Ver 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: use referencias definidas por lista : esta plantilla opcional se puede usar para indicar a los editores y herramientas que un artículo usa LDR
• 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 las plantillas de la 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 las 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. Úselo sólo si hay consenso .

Referencias

1. Copie el siguiente código, haga clic aquí y luego péguelo:
   {{subst:lusc|1=User:Cumbril/RefConsolidate_start.js}}