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 los artículos de referencia sean más fáciles y con menos desorden.
Esta página es una continuación de una sección de Ayuda: notas al pie . Esta guía asume que está familiarizado con las herramientas que se explican allí, como las características de las ...
etiquetas y el parámetro."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:
- O; usando {{ reflist }}
Cada referencia se invoca en el cuerpo del texto usando o .
{{r|name}}
Los nombres de las notas al pie y los grupos deben seguir estas reglas:
- Los nombres distinguen entre mayúsculas y minúsculas. No utilice mayúsculas raNdOM.
- Los nombres no deben ser puramente numéricos; el software aceptará algo como
":1"
(que es puntuación más un número), pero lo ignorará"1"
(puramente numérico). - Los nombres deben tener valor semántico, de modo que los editores humanos que estén mirando el wikitexto puedan distinguirlos más fácilmente entre sí. Esto significa que los nombres de referencia como
"Nguyen 2010"
se prefieren a los nombres como":1"
. - Los nombres deben ser únicos. No puede usar el mismo nombre para definir diferentes grupos o notas al pie.
- Considere mantener los nombres de referencia simples y restringidos al alfabeto y números estándar en inglés . En su defecto, si se utilizan espacios, las siguientes restricciones técnicas cobran relevancia:
- Se prefieren las comillas pero opcional si los únicos caracteres que se utilizan son las cartas
A–Z
,a–z
, dígitos0–9
, y los símbolos!$%&()*,-.:;<@[]^_`{|}~
. Es decir, todos los caracteres ASCII imprimibles excepto#"'/=>?\
. - La inclusión de cualquier otro carácter, incluidos los espacios , requiere que el nombre de la referencia esté entre comillas; por ejemplo
name="John Smith"
,. - Las comillas deben ser comillas dobles, rectas y estándar (
"
); Las citas rizadas o de otro tipo se analizarán como parte del nombre de referencia. - Los nombres de referencia entre
<
comillas no pueden incluir un signo menor que ( ) o un símbolo de comillas dobles rectas ("
). Estos pueden escaparse con<
y"
, respectivamente.
- Se prefieren las comillas pero opcional si los únicos caracteres que se utilizan son las cartas
- Opcionalmente, puede proporcionar nombres de referencia incluso cuando el nombre de referencia no sea necesario. Esto facilita la reutilización posterior de la referencia de origen.
Pautas
- Se deben nombrar todas las referencias definidas por lista . 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 la fecha del autor, el título del autor o la 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 las
...
etiquetas deben tener información de definición. - Las referencias definidas por lista y las referencias definidas en el cuerpo del artículo pueden mezclarse 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 de
Notas de uso
El uso de referencias definidas por lista significa que durante la edición, 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 los 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í misma si alguna de las entradas de la cita 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 del 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 todo el documento para ver la fuente tanto del texto como de la lista de referencias, o alternativamente usar un procedimiento de dos pasos, primero ingresando el identificador en el texto principal y luego abriendo la sección de lista de referencias para ingresar la fuente o nota al pie como . Otro aspecto general de este enfoque es que la lista al final del artículo debe estar organizada para que un editor pueda encontrarla fácilmente; lo más probable es que esté ordenada alfabéticamente en la ventana de edición por nombre de referencia, ya que es más probable que conserve la integridad y la utilidad de la fuente. , incluso si se cambian las secciones del texto.content
Si bien a menudo es más ordenado eliminar todas las citas del texto fuente, un compromiso aceptable (especialmente para artículos pequeños) podría ser usar solo LDR para las citas que se usan varias veces. Esto se debe a que ya usan el código refname para que puedan estar en varios lugares; un simple movimiento del código fuente de la referencia desde su primera aparición a la reflist es un cambio menor. Además, es más probable que estas citas necesiten revisión o modificación, ya que son más importantes para el artículo y contienen más detalles, y facilitar su búsqueda y modificación puede ser muy útil. Finalmente, esto también mantiene la integridad de la fuente si cambia la primera instancia de la referencia, como se indicó anteriormente.
Además, un separador User: PleaseStand / References de script creado por el usuario 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 los 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 las citas existentes en una lista de referencia por sí mismo, pero no está claro si puede realizar esta migración mientras edita.
Por último, existen algunos conceptos erróneos sobre las notas al pie de página definidas por listas:
- Uno de ellos 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 uno puede designar notas como un grupo llamado "Nota", y separarlas de las citas simples usando la etiqueta en línea (La explicación completa del uso de nombres de grupo se ilustra en el segundo ejemplo en la sección inmediatamente arriba .)
- Otro concepto erróneo es que existe una opción de "una u otra" entre el uso de notas al pie de página definidas por lista y notas al pie de página en línea, y que todas las citas en un artículo deben seguir sólo 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 el mismo artículo puede parecer confuso o indeseable, es un hecho que los dos sistemas pueden mezclarse indiscriminadamente con la plantilla .
{{reflist|refs= }}
content
content
{{reflist|refs= }}
Errores
A veces, las referencias pueden producir errores que se muestran en texto rojo. Consulte Ayuda: cite errores para ayudar a diagnosticar y resolver estos errores. Alternativamente, verifique su código con el ejemplo anterior o la documentación de reflist en Plantilla: Reflist § Referencias definidas por lista . En particular, los errores en cualquiera de la etiqueta ref con nombre o el código reflist pueden causar problemas, como un entradas deben definirse y utilizarse tanto para un LDR al trabajo.
Mudado
Los estilos de referencia pueden convertirse desde o hacia referencias definidas por lista, siguiendo las mismas reglas para otros cambios importantes en el estilo de las citas, en WP: CITEVAR . Usuario: PleaseStand / segregate-refs.js tiene una opción para ayudar a la conversión.
Ver también
- Plantilla: R : esta plantilla reduce el texto necesario para hacer una referencia con nombre, se convierte en {{r | foo}}
- Organizador de referencia [1] ( fuente )- es una herramienta que presenta todas las referencias en la 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 las referencias individualmente. También puede ordenar las referencias de varias formas (y mantener el orden de clasificación en la plantilla de lista de referencias) y cambiarles el nombre. Úselo solo si hay consenso .
Referencias
- ^ Copie el siguiente código, haga clic aquí y luego péguelo:
{{subst:lusc|1=User:Cumbril/RefConsolidate_start.js}}