Eliminando as marcas misteriosas de citação

Erros de digitação, passagens que faltaram, caminho errado e incompatibilidade entre BibTeX e Biber.

Eliminando as marcas misteriosas de citação

O sintoma

O documento compila, mas, onde deveria aparecer uma citação, você vê um ponto de interrogação em negrito, [?], e o log contém linhas como LaTeX Warning: Citation 'knuth84' undefined. Às vezes todas as citações são afetadas, às vezes só uma ou duas. Como isso é um aviso e não um erro, o PDF ainda é gerado, e as marcas passam facilmente despercebidas até que um leitor as aponte.

Por que acontece

O LaTeX não resolve as citações diretamente. Na primeira passagem, ele registra cada chave solicitada num arquivo auxiliar. Um programa de backend (bibtex ou biber) procura então essas chaves no seu banco de dados .bib e escreve as entradas formatadas. Mais duas passagens do LaTeX incorporam os resultados. Um ponto de interrogação significa que, no momento da passagem final, não existia entrada formatada para aquela chave. Toda causa desse sintoma é alguma forma de quebrar esse pipeline.

Percorra as causas em ordem

Verifique primeiro a própria chave. \cite{knuth84} e @article{knuth1984,...} são strings diferentes, e a correspondência é exata, inclusive quanto a maiúsculas e minúsculas. Procure no seu arquivo .bib a chave citada no aviso; um erro de digitação em qualquer dos lados é o culpado mais comum, e o primeiro aviso de chave ausente no log é o que deve ser perseguido.

A seguir, certifique-se de que o ciclo completo de compilação foi executado. A sequência é LaTeX, depois bibtex ou biber, depois LaTeX mais duas vezes. Uma única compilação nunca resolve as citações, porque o backend ainda não rodou. O Oleafly gerencia as passagens de compilação; use o TinyTeX ou um motor TeX do sistema quando a bibliografia exigir o Biber, mas uma compilação manual ou um editor mal configurado pode parar depois da primeira passagem.

Em terceiro lugar, confira o caminho do banco de dados. \bibliography{refs} e \addbibresource{refs.bib} são resolvidos em relação ao arquivo principal, então um banco de dados numa subpasta deve ser escrito como bib/refs ou bib/refs.bib. Um caminho errado falha em silêncio e, em geral, leva junto a lista inteira de referências; veja Bibliografia vazia para essa falha maior.

Por fim, case o backend com o sistema. Um documento que carrega o biblatex precisa ser processado com o biber. Alimentá-lo com o bibtex clássico não produz saída utilizável, e toda citação continua sendo um ponto de interrogação, por mais vezes que você recompile.

Se nada mais funcionar

Arquivos auxiliares obsoletos podem manter um estado antigo e quebrado. Apague os arquivos .aux, .bbl e .blg ao lado do documento e recompile do zero. Vale a pena ler o arquivo .blg antes de apagá-lo: é o log do próprio backend, e ele cita explicitamente bancos de dados ausentes e entradas malformadas.

Voltar para Cite suas fontes