Por qué se compila más de una vez

Archivos aux, pasadas de bibliografía y por qué las referencias salen como ?? en la primera ejecución.

Por qué se compila más de una vez

Tarde o temprano compilarás un documento, abrirás el PDF y encontrarás ?? donde debería ir el número de una figura o una cita. No se ha roto nada. Una sola compilación es una pasada por tu archivo, y cierta información sencillamente no se puede conocer en una sola pasada.

Este es el problema en miniatura. En la página 2 escribes «véase la Figura \ref{fig:results}», pero esa figura cae en la página 7. Cuando el motor compone la página 2, todavía no ha llegado a la página 7, así que no tiene idea de qué número tendrá la figura. Lo mismo pasa con el índice, que necesita el número de página de cada sección antes de haber terminado siquiera la primera página.

Cómo lo resuelve el motor

Un motor de LaTeX lee tu archivo .tex, resuelve cada macro y escribe un PDF. Junto con el PDF escribe además pequeños archivos auxiliares: .aux para las etiquetas y las citas, .toc para el índice, .bbl para la bibliografía formateada. Estos archivos son notas que el motor deja para su yo futuro.

  1. En la primera pasada, el motor compone tu texto y escribe en el archivo .aux cada \label y \cite que encuentra, e imprime ?? donde necesita un número que todavía no conoce.
  2. Si citas algo, una herramienta de bibliografía (bibtex o biber) lee entonces el archivo .aux, busca cada cita en tu base de datos .bib y escribe la lista de referencias formateada en un archivo .bbl.
  3. En la segunda pasada, y a veces en una tercera, el motor vuelve a leer esos archivos auxiliares, de modo que las referencias cruzadas, las entradas del índice y las etiquetas de las citas por fin se resuelven en números reales.

Las configuraciones modernas ejecutan estas pasadas por ti automáticamente, así que en la práctica rara vez escribes los comandos tú mismo. Pero conocer el ciclo explica el síntoma: un ?? nuevo tras añadir una etiqueta o una cita solo significa que los archivos auxiliares aún no se han puesto al día, y una compilación más lo arregla.

Los motores, en una línea cada uno

Varios programas pueden hacer de «motor». pdfLaTeX es la opción clásica y la de mayor compatibilidad con las revistas. XeLaTeX añade Unicode completo y te permite usar las fuentes instaladas en tu sistema. LuaLaTeX también habla Unicode e incorpora un lenguaje de scripts para paquetes avanzados. Tectonic es un motor moderno que descarga los paquetes bajo demanda la primera vez que los necesitas. Oleafly lo incluye, así que un proyecto nuevo compila sin tener que instalar antes una distribución de TeX.

En la mayoría de los documentos las diferencias apenas importan; elige lo que espere tu plantilla o tu congreso o revista y sigue adelante. Consulta los motores comparados cuando necesites elegir con criterio.

Cuando algo falla de verdad

Una compilación fallida vuelca un registro larguísimo, y el instinto natural es leerlo de abajo arriba. Resístete. Lee el primer error del registro y arregla solo ese; los errores posteriores suelen ser ruido en cascada causado por el primero. Si las referencias siguen saliendo como ?? tras dos compilaciones correctas seguidas, lo habitual es que haya un error tipográfico en el nombre del \label o del \ref, y no que falte una pasada.

Volver a Abrir el bucle