Por que você compila mais de uma vez

Arquivos aux, passagens da bibliografia e por que as referências aparecem como ?? na primeira execução.

Por que você compila mais de uma vez

Mais cedo ou mais tarde você vai compilar um documento, abrir o PDF e encontrar ?? onde deveria estar o número de uma figura ou uma citação. Nada está quebrado. Uma única compilação é uma passada pelo seu arquivo, e algumas informações realmente não podem ser conhecidas em uma só passada.

Eis o problema em miniatura. Na página 2 você escreve “veja a Figura \ref{fig:results}”, mas essa figura cai na página 7. Quando o motor compõe a página 2, ainda não chegou à página 7, então não faz ideia de que número a figura terá. O mesmo vale para o sumário, que precisa do número de página de cada seção antes mesmo de a primeira página estar pronta.

Como o motor resolve isso

Um motor LaTeX lê o seu arquivo .tex, resolve cada macro e escreve um PDF. Junto com o PDF, ele também escreve pequenos arquivos auxiliares: .aux para rótulos e citações, .toc para o sumário, .bbl para a bibliografia formatada. Esses arquivos são anotações que o motor deixa para si mesmo no futuro.

  1. Na primeira passada, o motor compõe o seu texto e grava no arquivo .aux cada \label e \cite que encontra, imprimindo ?? em todo lugar onde precisa de um número que ainda não conhece.
  2. Se você cita algo, uma ferramenta de bibliografia (bibtex ou biber) lê então o arquivo .aux, procura cada citação no seu banco de dados .bib e grava a lista de referências formatada em um arquivo .bbl.
  3. Na segunda e, às vezes, na terceira passada, o motor lê de volta esses arquivos auxiliares, e assim as referências cruzadas, as entradas do sumário e os rótulos das citações finalmente se resolvem em números reais.

As configurações modernas executam essas passadas para você automaticamente, então na prática você raramente digita os comandos. Mas conhecer o ciclo explica o sintoma: um ?? novo depois de adicionar um rótulo ou uma citação significa apenas que os arquivos auxiliares ainda não se atualizaram, e mais uma compilação resolve.

Os motores em uma linha cada

Vários programas podem fazer o papel de “o motor”. O pdfLaTeX é a escolha clássica, com o maior suporte entre periódicos. O XeLaTeX acrescenta Unicode completo e permite usar fontes instaladas no seu sistema. O LuaLaTeX também entende Unicode e embute uma linguagem de script para pacotes avançados. O Tectonic é um motor moderno que baixa pacotes sob demanda na primeira vez que você precisa deles. O Oleafly o traz embutido, de modo que um projeto novo compila sem você instalar antes uma distribuição TeX.

Para a maioria dos documentos, as diferenças quase não importam; escolha o que o seu modelo ou veículo espera e siga em frente. Veja motores comparados quando precisar escolher com critério.

Quando algo realmente falha

Uma compilação que falha despeja um log longo, e o instinto natural é lê-lo de baixo para cima. Resista a isso. Leia o primeiro erro do log e corrija só ele; os erros seguintes são, muito frequentemente, ruído em cascata causado pelo primeiro. Se as referências ainda saírem como ?? depois de duas compilações bem-sucedidas seguidas, o culpado de sempre é um erro de digitação no nome do \label ou do \ref, e não uma passada faltando.

Voltar para Abra o ciclo