Bibliografía e índices: síntesis y desafíos

Resumen

Esta clase cierra la sexta unidad del curso, dedicada a la bibliografía y a los índices. Reconstruye la cadena de principios y mecanismos que va de la ficha bibliográfica al glosario, señalando en cada eslabón qué principio se usa y en qué clase se establece; sitúa lo logrado respecto del plan del curso y precisa qué cuestiones, apenas anticipadas, quedan para la unidad siguiente; repite en su evaluación de salida las destrezas de la evaluación de entrada; y termina con seis desafíos, de dificultad superior a la de los problemas de las clases, que exigen combinar varias de ellas para pasar un artículo de un estilo de cita a otro, diagnosticar una lista de referencias que compila sin aviso con cuatro defectos, predecir las notas de un ensayo sobre Platón, componer un índice de nombres que concuerde con la bibliografía, reconstruir el ciclo de compilación de una tesis y preparar una base que sirva a la vez a bibtex y a biber.

Objetivos de aprendizaje

Reconstruir el orden de los mecanismos de la unidad, identificando el principio en que se apoya cada uno.
Explicar por qué los defectos de una base bibliográfica, de una cita o de un índice compilan casi siempre sin aviso, y dónde buscar su huella: en el resultado, en la salida de biber, en el informe de makeindex o en el registro.
Distinguir lo que la unidad estableció de lo que solo anticipó y que la unidad siguiente desarrollará.
Predecir lo que imprimen una base, un estilo y una secuencia de citas, de índices y de siglas, y corregir la fuente para que imprima lo que se quería.
Ordenar los programas que intervienen en la compilación de un documento con bibliografía, índice y glosario, y saber cuáles se ejecutan solos.

Lo logrado en la unidad

La unidad se propuso que las fuentes de un trabajo se citen desde una base de datos, de modo que las citas y la lista se compongan solas con el estilo de cada disciplina, y que el documento tenga los índices y los glosarios que permiten consultarlo. El propósito se ha cumplido apoyándose en lo que la introducción declaró por sabido de las unidades anteriores: las pasadas, en las que el motor escribe en una compilación lo que lee en la siguiente; el marcado lógico, que dice qué es cada cosa y deja su forma a una decisión tomada en otro lugar; y las notas y las comillas de la unidad segunda. Con ello, el camino recorrido puede leerse como una sola cadena en cuatro tramos.

La base bibliográfica

La clase sobre la base bibliográfica separó los datos de una obra del estilo con que se cita, y aplicó a las referencias el principio del marcado lógico: el archivo .bib dice qué es cada obra, y el estilo decide cómo se escribe. Describió las entradas, sus tipos, sus claves, que deben ser únicas y deducibles, y sus campos; mostró que biber entiende los nombres de campo de biblatex y los clásicos, mientras bibtex solo los clásicos; estableció las reglas mecánicas con que biber divide los nombres, and entre personas, la coma entre apellido y nombre, la partícula en minúscula y las llaves dobles de las instituciones, cuyo error solo se ve en el resultado; protegió con llaves las mayúsculas que un estilo clásico cambiaría; explicó por qué bibtex ordena las letras con tilde después de la zeta y biber según el idioma; presentó la exportación desde Zotero; y enseñó a buscar los errores de la base en la salida de biber, no en el registro del documento.

Citar con biblatex

La clase sobre citar con biblatex cargó el paquete con backend=biber, la base con \addbibresource y su extensión, y csquotes, que biblatex pide junto a babel. Precisó el ciclo: el motor anota las claves en el .bcf, biber las busca y escribe el .bbl, y la pasada siguiente lo compone; sin biber, las citas quedan como claves en negrita, y el botón de bibliografía de Texmaker ejecuta bibtex por omisión. Eligió la instrucción de cita por su función en la oración, \textcite para la narrativa, \parencite para la parentética y \autocite para la que decide el estilo, con notas previas y posteriores; comparó los estilos autor-año, numérico, numérico compacto y alfabético, en los que los números siguen el orden de la lista y no el de las citas salvo con sorting=none; y compuso la lista con su título, su encabezado y sus filtros.

Citar en las humanidades

La clase sobre citar en las humanidades automatizó la regla de economía de la cita por notas: la primera cita es completa, las siguientes breves, y las abreviaturas latinas, ibíd., óp. cit. y loc. cit., las calcula el estilo, de modo que no se vuelven falsas al mover una cita. Recorrió la familia verbose; devolvió la llamada a su lugar español, antes de la puntuación, con \DeclareAutoCiteCommand; citó los clásicos por su referencia canónica en la posnota, que biblatex imprime sin «pág.» cuando no es un número, y con \nopp cuando lo parece; introdujo las siglas de shorthand y su lista; registró las traducciones y su original mediante una entrada relacionada, porque los estilos estándar no imprimen origdate; y separó las fuentes de la bibliografía secundaria con palabras clave.

Índices y glosarios

La clase sobre los índices y los glosarios trasladó el mismo ciclo a otro programa: el motor escribe las entradas en el .idx, makeindex las ordena en el .ind, e imakeidx lo ejecuta por sí solo salvo con nonewpage o noautomatic. Enseñó las subentradas con !, la clave de orden con @, las remisiones y los formatos con |, y los rangos; mostró que makeindex compara bytes y lleva al final las palabras que empiezan con tilde, y que upmendex ordena en español; mantuvo varios índices con nombre; y compuso con glossaries los términos y las siglas, que se desarrollan en su primera mención, con makeglossaries entre las pasadas.

La figura siguiente reúne los cuatro tramos en una sola cadena. Cada nudo de la columna es un mecanismo o una regla, numerado según el orden en que se apoyan unos en otros y unido por un arco a los eslabones anteriores que usa; alrededor flotan los apoyos, es decir, los principios a los que la cadena recurre una y otra vez, cada uno unido con un trazo firme a los eslabones que se apoyan en él y con uno punteado al eslabón donde se establece, salvo los que se establecieron en unidades anteriores, que se dibujan como anillos. Al pulsar un apoyo se destacan todos los eslabones que lo usan, y cada eslabón remite a la clase en que se estudia.

Apoyos de la cadena

APasadas. El motor anota en los archivos auxiliares lo que calcula en una pasada, y lo usa en la siguiente. Se establece en la primera unidad y se precisa en la tercera. Se admite sin demostración en esta unidad.
BQué es, no cómo se ve. El marcado lógico dice qué es cada elemento y deja su forma a una decisión tomada en otro lugar. Se establece en la segunda unidad. Se admite sin demostración en esta unidad.
CDecidir una vez. Lo que se decide en un solo lugar (un estilo, una opción del preámbulo, una instrucción propia, una ficha) cambia en todo el documento al cambiarlo allí; lo que se copia a mano deja de concordar. Se establece en las unidades anteriores. Se admite sin demostración en esta unidad.
DLo que pone babel. El idioma de babel fija las palabras que el documento escribe por sí solo: títulos, conjunciones, abreviaturas y rótulos. Se establece en la segunda unidad. Se admite sin demostración en esta unidad.
ELo válido no avisa. El motor y sus programas solo avisan de lo que no pueden procesar; una fuente válida que no dice lo que el autor quería compila sin aviso, y el defecto solo se ve en el resultado. Se establece en la unidad anterior. Se admite sin demostración en esta unidad.
FOrdenar bytes o letras. bibtex y makeindex comparan los códigos de los caracteres y llevan las letras con tilde después de la zeta; biber y upmendex ordenan según las reglas del idioma. Se establece en: 3. Campos, llaves y tildes.
GMarcar, ordenar, componer. El autor marca en el texto lo que se cita o se indiza; un programa externo lo ordena entre dos pasadas del motor; la pasada siguiente lo compone. Se establece en: 6. El ciclo con biber.

Tramo 1 La base bibliográfica
- Escribir entradas correctas, con su tipo, su clave y sus campos.
- Escribir los nombres de modo que se dividan como corresponde.
- Preparar una base para biber o para bibtex.
- Diagnosticar una base por la salida de biber.
1. Datos y estilo. Cada obra se describe una vez en una ficha .bib, con su tipo, una clave única que no se imprime y sus campos; el estilo decide la forma, y la lista contiene exactamente las obras citadas.
  Se apoya en: B (Qué es, no cómo se ve), C (Decidir una vez). Se demuestra en: La base bibliográfica.
2. Los nombres. and separa personas y la coma separa el apellido del nombre; sin coma, el apellido es la última palabra; las minúsculas iniciales son partícula; las llaves dobles impiden dividir el nombre de una institución. Ningún error da aviso.
  Usa: 1. Datos y estilo. Se apoya en: E (Lo válido no avisa). Se demuestra en: La base bibliográfica.
3. Campos, llaves y tildes. biber entiende journal, address y year y sus nombres nuevos; bibtex solo los clásicos, y con los nuevos pierde la revista y el año; las llaves protegen las mayúsculas; bibtex ordena las tildes después de la zeta, y biber según el idioma.
  Usa: 1. Datos y estilo. Se apoya en: F (Ordenar bytes o letras). Se demuestra en: La base bibliográfica.
4. Diagnosticar la base. Una coma que falta detiene a biber y vacía toda la lista; una clave repetida se ignora con una advertencia; un & sin escapar da un error de LuaLaTeX en la línea del documento que compone la lista.
  Usa: 2. Los nombres, 3. Campos, llaves y tildes. Se apoya en: E (Lo válido no avisa). Se demuestra en: La base bibliográfica.
Tramo 2 Citar con biblatex
- Cargar biblatex con biber y csquotes.
- Compilar el ciclo con biber, a mano, con latexmk o con Texmaker.
- Elegir la instrucción de cita según la oración.
- Predecir lo que imprime cada estilo y componer la lista con sus filtros.
1. Cargar biblatex. backend=biber y style en las opciones; \addbibresource con la extensión del archivo; csquotes después de babel, que biblatex recomienda con una advertencia.
  Usa: 1. Datos y estilo. Se apoya en: D (Lo que pone babel). Se demuestra en: Citar con BibLaTeX.
2. El ciclo con biber. El motor escribe las claves en el .bcf, biber escribe el .bbl y el motor lo compone; antes, las citas son claves en negrita; latexmk ejecuta biber solo, y el botón de Texmaker ejecuta bibtex si no se cambia.
  Usa: 5. Cargar biblatex. Se apoya en: A (Pasadas), G (Marcar, ordenar, componer). Se demuestra en: Citar con BibLaTeX.
3. La cita según la oración. \textcite para el autor que es parte de la oración, \parencite para el inciso, \autocite para la cita que decide el estilo; una nota posterior numérica recibe «pág.» por sí sola, y \citeauthor no remite a la lista.
  Usa: 6. El ciclo con biber. Se apoya en: D (Lo que pone babel), C (Decidir una vez). Se demuestra en: Citar con BibLaTeX.
4. El estilo decide. authoryear, numeric, numeric-comp y alphabetic cambian todas las citas y la lista con una opción; los números siguen el orden de la lista, por omisión alfabético, y sorting=none los pone en el orden de las citas.
  Usa: 7. La cita según la oración, 2. Los nombres. Se apoya en: B (Qué es, no cómo se ve), C (Decidir una vez). Se demuestra en: Citar con BibLaTeX.
5. La lista y sus filtros. \printbibliography fija título y encabezado; keyword y notkeyword dividen la lista sin perder obras; \nocite añade las no citadas; una lista sin obras no se imprime, con la advertencia «Empty bibliography».
  Usa: 8. El estilo decide. Se apoya en: E (Lo válido no avisa). Se demuestra en: Citar con BibLaTeX.
Tramo 3 Citar en las humanidades
- Elegir un estilo de notas y predecir sus abreviaturas.
- Poner la llamada antes de la puntuación, como pide el español.
- Citar los clásicos por su referencia canónica.
- Registrar traducciones y separar fuentes de estudios.
1. Completa y luego breve. La familia verbose da la referencia completa en la primera cita y la breve después; verbose-ibid escribe «Ibíd.» si repite la nota anterior en la misma página; los esquemas tradicionales añaden óp. cit. y loc. cit.
  Usa: 8. El estilo decide. Se apoya en: C (Decidir una vez). Se demuestra en: Citar en las humanidades.
2. La llamada en español. En modo de nota, \autocite pasa el signo de puntuación delante de la llamada; \DeclareAutoCiteCommand con [r] lo deja detrás, y un espacio antes de \autocite sirve a los dos sistemas.
  Usa: 10. Completa y luego breve, 7. La cita según la oración. Se apoya en: D (Lo que pone babel). Se demuestra en: Citar en las humanidades.
3. Referencias canónicas. La posnota que no es un número, como 514a o 980a21, se imprime sin «pág.»; la que lo parece pide \nopp; shorthand da una sigla, que prevalece sobre ibíd., y \printbiblist{shorthand} imprime su lista.
  Usa: 7. La cita según la oración, 10. Completa y luego breve. Se apoya en: E (Lo válido no avisa). Se demuestra en: Citar en las humanidades.
4. Traducciones y fuentes. translator y origlanguage nombran al traductor y la lengua; los estilos estándar no imprimen origdate, y el original se declara como entrada relacionada; keywords separa las fuentes de la bibliografía secundaria.
  Usa: 12. Referencias canónicas, 9. La lista y sus filtros. Se apoya en: E (Lo válido no avisa). Se demuestra en: Citar en las humanidades.
Tramo 4 Índices y glosarios
- Marcar entradas y compilar el índice con makeindex.
- Ordenar bien las palabras con tilde y escribir remisiones y rangos.
- Mantener una forma única para cada entrada y varios índices.
- Definir términos y siglas y prever cada mención.
1. El índice con imakeidx. \index escribe en el .idx, makeindex ordena en el .ind y \printindex lo compone; imakeidx ejecuta makeindex por sí solo, salvo con nonewpage o noautomatic.
  Usa: 6. El ciclo con biber. Se apoya en: A (Pasadas), G (Marcar, ordenar, componer). Se demuestra en: Índices y glosarios.
2. Subentradas, claves y remisiones. ! separa niveles, @ separa la clave de orden de la forma impresa, |see remite sin página y |( abre un rango; sin clave, las palabras con tilde inicial van al final.
  Usa: 14. El índice con imakeidx. Se apoya en: F (Ordenar bytes o letras), E (Lo válido no avisa). Se demuestra en: Índices y glosarios.
3. Una forma, varios índices. makeindex compara carácter por carácter, y dos escrituras de un término son dos entradas; una convención aplicada con una instrucción propia lo evita; name abre índices aparte, y un nombre mal escrito pierde la entrada.
  Usa: 15. Subentradas, claves y remisiones, 2. Los nombres. Se apoya en: C (Decidir una vez). Se demuestra en: Índices y glosarios.
4. Glosarios y siglas. glossaries define cada término una vez y \gls desarrolla una sigla en su primera mención; makeglossaries ordena entre las pasadas; un término con tilde inicial necesita sort, o el motor se detiene.
  Usa: 15. Subentradas, claves y remisiones. Se apoya en: G (Marcar, ordenar, componer), F (Ordenar bytes o letras). Se demuestra en: Índices y glosarios.

Hacia otros documentos. La cadena se detiene donde el trabajo académico está completo: texto, estructura, fórmulas, tablas, figuras, fuentes e índices, cada uno calculado desde su declaración. La unidad siguiente lleva la misma base y los mismos mecanismos a las presentaciones, a los pósteres y al trabajo compartido.