Faire disparaître les points d’interrogation mystérieux des citations
Fautes de frappe, passes manquantes, mauvais chemin, incompatibilité entre BibTeX et Biber.
Faire disparaître les points d’interrogation mystérieux des citations
Le symptôme
Le document compile, mais à l’endroit où une citation devrait apparaître vous obtenez un point d’interrogation en gras, [?], et le journal contient des lignes comme LaTeX Warning: Citation 'knuth84' undefined. Parfois toutes les citations sont touchées, parfois seulement une ou deux. Comme il s’agit d’un avertissement et non d’une erreur, le PDF se génère quand même, et ces marques passent facilement inaperçues jusqu’à ce qu’un lecteur les signale.
Pourquoi cela arrive
LaTeX ne résout pas les citations directement. À la première passe, il consigne chaque clé demandée dans un fichier auxiliaire. Un programme de traitement de la bibliographie (bibtex ou biber) cherche ensuite ces clés dans votre base .bib et écrit les entrées mises en forme. Deux autres passes de LaTeX réintègrent les résultats. Un point d’interrogation signifie qu’au moment de la dernière passe, aucune entrée formatée n’existait pour cette clé. Toutes les causes de ce symptôme reviennent, d’une façon ou d’une autre, à briser cette chaîne.
Examinez les causes dans l’ordre
Vérifiez d’abord la clé elle-même. \cite{knuth84} et @article{knuth1984,...} sont deux chaînes différentes, et la correspondance est exacte, casse comprise. Cherchez dans votre fichier .bib la clé nommée dans l’avertissement ; une faute de frappe d’un côté ou de l’autre est la cause la plus fréquente, et c’est le premier avertissement de clé manquante du journal qu’il faut traquer.
Assurez-vous ensuite que le cycle de compilation complet a bien tourné. La séquence est LaTeX, puis bibtex ou biber, puis LaTeX encore deux fois. Une seule compilation ne peut jamais résoudre les citations, car le programme de bibliographie n’a pas encore tourné. Oleafly gère les passes de compilation ; utilisez TinyTeX ou un moteur TeX du système quand la bibliographie exige Biber, mais une compilation manuelle ou un éditeur mal configuré peut s’arrêter après la première passe.
Troisièmement, vérifiez le chemin de la base de données. \bibliography{refs} et \addbibresource{refs.bib} se résolvent par rapport au fichier principal, donc une base placée dans un sous-dossier doit s’écrire bib/refs ou bib/refs.bib. Un mauvais chemin échoue silencieusement et entraîne généralement toute la liste de références dans sa chute ; voir Bibliographie vide pour cet échec plus large.
Enfin, associez le bon programme au bon système. Un document qui charge biblatex doit être traité avec biber. Lui donner le bibtex classique ne produit aucune sortie exploitable, et chaque citation reste un point d’interrogation, quel que soit le nombre de recompilations.
Si rien ne marche
Des fichiers auxiliaires périmés peuvent conserver un ancien état défectueux. Supprimez les fichiers .aux, .bbl et .blg situés à côté de votre document et reconstruisez de zéro. Le fichier .blg mérite aussi d’être lu avant d’être supprimé : c’est le journal du programme de bibliographie lui-même, et il nomme explicitement les bases manquantes et les entrées mal formées.