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.
- Na primeira passada, o motor compõe o seu texto e grava no arquivo
.auxcada\labele\citeque encontra, imprimindo??em todo lugar onde precisa de um número que ainda não conhece. - 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.bibe grava a lista de referências formatada em um arquivo.bbl. - 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.