Bibliographie vide
Chemin, moteur bibliographique, citation manquante, printbibliography ou bibliography.
Bibliographie vide
Le symptôme
Votre document se compile sans erreur fatale, mais la section Références est absente, ou son titre apparaît sans rien dessous. Souvent, tous les \cite du texte s’affichent en même temps comme des points d’interrogation en gras. Rien n’a planté, donc il n’y a pas d’erreur évidente à traquer, ce qui rend ce problème frustrant.
Pourquoi cela arrive
La bibliographie n’est pas produite par LaTeX seul. LaTeX écrit d’abord la liste des clés citées dans un fichier auxiliaire. Un programme séparé, le moteur bibliographique (bibtex ou biber), lit votre base .bib et met en forme les entrées correspondantes. Enfin, LaTeX relit ce résultat mis en forme à la passe suivante. Une bibliographie vide signifie que cette chaîne s’est rompue quelque part : le moteur bibliographique n’a jamais tourné, il a tourné mais n’a pas trouvé la base de données, il a trouvé la base mais aucune clé n’était demandée, ou le document réclame le résultat avec la mauvaise commande.
Passez en revue les causes dans l’ordre
Premièrement, vérifiez que le fichier de base de données existe là où le document le dit. \bibliography{refs} et \addbibresource{refs.bib} cherchent tous deux refs.bib relativement au fichier principal, donc un fichier qui se trouve dans un sous-dossier bib/ doit être désigné par bib/refs ou bib/refs.bib. Un mauvais chemin échoue en silence.
Deuxièmement, assurez-vous que le moteur bibliographique a bien tourné. Une seule compilation ne suffit jamais ; le cycle complet est LaTeX, puis bibtex ou biber, puis LaTeX deux fois de plus. Oleafly gère les passes de compilation pour vous ; choisissez TinyTeX ou un moteur TeX du système pour un projet Biber. En revanche, une compilation pilotée à la main ou une chaîne d’outils d’éditeur mal configurée peut sauter l’étape du milieu, et le résultat est précisément une liste de références vide.
Troisièmement, vérifiez qu’au moins une commande \cite est présente. Le moteur bibliographique ne met en forme que les entrées que le document demande, donc un brouillon qui n’a pas encore de citations obtient par construction une liste vide. Pendant la rédaction initiale, vous pouvez tout forcer avec \nocite{*}, qui demande chaque entrée de la base sans rien imprimer dans le texte.
Quatrièmement, accordez la commande au système. Les documents BibTeX classiques se terminent par \bibliographystyle{...} et \bibliography{refs}. Les documents biblatex chargent la base dans le préambule avec \addbibresource{refs.bib} et l’impriment avec \printbibliography. Mélanger les deux, par exemple charger biblatex mais appeler encore \bibliography, produit exactement cet échec. Il en va de même quand on lance le mauvais moteur bibliographique : biblatex a besoin de biber, et lui fournir le bibtex classique ne donne rien.
Lisez le journal du moteur bibliographique
Le moteur bibliographique écrit ses plaintes dans un fichier .blg à côté de votre document, et c’est là qu’apparaissent les entrées mal formées, les clés en double et les messages « I couldn’t open database file ». Si les étapes ci-dessus semblent correctes mais que la liste reste vide, le journal .blg désigne presque toujours le vrai coupable. Pour les points d’interrogation qui persistent après que la bibliographie elle-même est apparue, voir Faire disparaître les marques de citation mystérieuses.