Bibliografia vazia

Caminho, backend, citação ausente, printbibliography versus bibliography.

Bibliografia vazia

O sintoma

O seu documento compila sem erro fatal, mas a seção de Referências está totalmente ausente, ou o título aparece sem nada embaixo. Muitas vezes, ao mesmo tempo, cada \cite no texto aparece como um ponto de interrogação em negrito. Nada travou, então não há um erro óbvio para perseguir, e é isso que torna este problema frustrante.

Por que acontece

A bibliografia não é produzida só pelo LaTeX. Primeiro o LaTeX grava a lista de chaves citadas em um arquivo auxiliar. Um programa de backend separado (bibtex ou biber) lê o seu banco de dados .bib e formata as entradas correspondentes. Por fim, o LaTeX lê esse resultado formatado de volta na passada seguinte. Uma bibliografia vazia significa que esse fluxo quebrou em algum ponto: o backend nunca rodou, rodou mas não encontrou o banco de dados, encontrou o banco de dados mas nenhuma chave foi solicitada, ou o documento está pedindo o resultado com o comando errado.

Percorra as causas em ordem

Primeiro, confirme que o arquivo do banco de dados existe onde o documento diz que ele está. \bibliography{refs} e \addbibresource{refs.bib} procuram refs.bib em relação ao arquivo principal, então um arquivo que mora em uma subpasta bib/ precisa ser referenciado como bib/refs ou bib/refs.bib. Um caminho errado falha em silêncio.

Segundo, garanta que o backend realmente rodou. Uma única compilação nunca basta; o ciclo completo é LaTeX, depois bibtex ou biber, depois LaTeX mais duas vezes. O Oleafly cuida das passadas de compilação por você (escolha o TinyTeX ou um motor TeX do sistema para um projeto com Biber), mas uma compilação conduzida à mão ou uma cadeia de ferramentas do editor mal configurada pode pular a etapa do meio, e o resultado é exatamente uma lista de referências vazia.

Terceiro, verifique se há pelo menos um comando \cite. O backend só formata as entradas que o documento solicita, então um rascunho ainda sem citações recebe uma lista vazia por definição. Durante os primeiros rascunhos, você pode forçar a inclusão de tudo com \nocite{*}, que solicita todas as entradas do banco de dados sem imprimir nada no texto.

Quarto, use o comando certo para o sistema. Os documentos com BibTeX clássico terminam com \bibliographystyle{...} e \bibliography{refs}. Os documentos com biblatex carregam o banco de dados no preâmbulo com \addbibresource{refs.bib} e o imprimem com \printbibliography. Misturar os dois, por exemplo carregar o biblatex mas ainda chamar \bibliography, produz exatamente esta falha. O mesmo vale para rodar o backend errado: o biblatex precisa do biber, e alimentá-lo com o bibtex clássico não rende nada.

Leia o log do próprio backend

O backend escreve suas reclamações em um arquivo .blg ao lado do seu documento, e é ali que aparecem entradas malformadas, chaves duplicadas e mensagens como “I couldn’t open database file”. Se os passos acima parecem certos mas a lista continua vazia, o log .blg quase sempre aponta o verdadeiro culpado. Para os pontos de interrogação que persistem depois que a própria bibliografia aparece, veja Acabando com as marcas misteriosas de citação.

Voltar para Alfabetização em registros