Aller au contenu
Topos Uranos
Français

Citer avec BibLaTeX

Résumé

Cette leçon enseigne à citer les ouvrages d’une base bibliographique et à composer avec eux la liste des références. Elle présente le chargement de BibLaTeX avec Biber comme programme auxiliaire, ainsi que celui de csquotes, que BibLaTeX réclame à côté de babel ; elle explique le cycle de compilation, dans lequel Biber s’exécute entre deux passes du moteur, quel fichier produit chaque programme et comment latexmk parcourt ce cycle tout seul ; elle passe en revue les commandes de citation, \cite, \parencite, \textcite et \autocite, avec leurs prénotes et leurs postnotes, \citeauthor et \citeyear, et les citations de plusieurs ouvrages à la fois ; elle compare un même texte dans les styles auteur-année, numérique, numérique compact et alphabétique ; elle montre comment \printbibliography fixe le titre, l’en-tête, l’ordre et les filtres de la liste, et quels mots le français y met ; elle se termine par les avertissements les plus fréquents et ce que chacun signifie.

Objectifs d’apprentissage

  1. Charger BibLaTeX avec Biber et csquotes, et déclarer la base avec \addbibresource.
  2. Expliquer le cycle de compilation avec Biber et quel fichier produit chaque étape, et l’exécuter à la main, avec latexmk ou avec Texmaker.
  3. Choisir entre \cite, \parencite, \textcite et \autocite selon la fonction grammaticale de la citation, et écrire leurs prénotes et leurs postnotes.
  4. Prévoir ce qu’imprime une même citation dans les styles auteur-année, numérique, numérique compact et alphabétique, y compris les numéros que reçoivent les ouvrages.
  5. Composer la liste des références avec son titre, son en-tête, son ordre et ses filtres par type ou par mot-clé.
  6. Interpréter les avertissements de citation indéfinie, de Biber en attente et de bibliographie vide, et en corriger la cause.

Charger BibLaTeX

Dans la leçon consacrée à la base bibliographique, on a vu comment chaque ouvrage est enregistré, une seule fois, dans un fichier .bib, sous une clé qui l’identifie. Cette leçon suppose cette base et étudie l’autre moitié du travail : citer les ouvrages dans le texte par leur clé et laisser LaTeX composer à la fois les citations et la liste des références. L’outil est l’extension BibLaTeX, qui met en forme les citations et la liste, aidée par un programme externe, Biber, qui lit la base, trie les ouvrages et les prépare pour le moteur. Les exemples de la leçon utilisent la base suivante, qui réunit un article de biologie, une monographie d’histoire des sciences, un manuel d’informatique à quatre auteurs, un essai en espagnol et un volume collectif de philosophie avec son éditeur scientifique.

Code LaTeX
@book{kuhn1962,  author    = {Kuhn, Thomas S.},  title     = {The Structure of Scientific Revolutions},  year      = {1962},  publisher = {University of Chicago Press},  location  = {Chicago},  keywords  = {sciences},}@article{watson1953,  author   = {Watson, James D. and Crick, Francis H. C.},  title    = {Molecular Structure of Nucleic Acids: A Structure              for Deoxyribose Nucleic Acid},  journal  = {Nature},  volume   = {171},  number   = {4356},  pages    = {737--738},  year     = {1953},  keywords = {sciences},}@book{cormen2009,  author    = {Cormen, Thomas H. and Leiserson, Charles E.               and Rivest, Ronald L. and Stein, Clifford},  title     = {Introduction to Algorithms},  edition   = {3},  year      = {2009},  publisher = {MIT Press},  location  = {Cambridge, Mass.},  keywords  = {sciences},}@book{ortega1930,  author    = {Ortega y Gasset, José},  title     = {La rebelión de las masas},  year      = {1930},  publisher = {Revista de Occidente},  location  = {Madrid},  keywords  = {lettres},}@book{barnes1995,  editor    = {Barnes, Jonathan},  title     = {The Cambridge Companion to Aristotle},  year      = {1995},  publisher = {Cambridge University Press},  location  = {Cambridge},  keywords  = {lettres},}

Le fichier est enregistré sous le nom fuentes.bib dans le dossier du document. Dans le préambule, trois lignes nouvelles suffisent : csquotes, BibLaTeX avec ses options et la déclaration de la base. L’option backend=biber indique le programme auxiliaire, et style choisit le style des citations et de la liste. La commande \addbibresource déclare la base et exige le nom complet du fichier, extension comprise : avec \addbibresource{fuentes}, Biber cherche un fichier nommé exactement fuentes et s’arrête sur l’erreur « Cannot find 'fuentes'! ». Dans le corps, \printbibliography compose la liste à l’endroit où on l’écrit.

ExempleUn document minimal avec bibliographie
Code LaTeX
\documentclass{article}\usepackage{fontspec}\usepackage[french]{babel}\usepackage{csquotes}\usepackage[backend=biber, style=authoryear]{biblatex}\addbibresource{fuentes.bib}​\begin{document}Selon \textcite{kuhn1962}, la science normale s'appuie surdes réussites passées qu'une communauté accepte comme modèle.​\printbibliography\end{document}
Résultat
Résultat

La liste ne contient que l’ouvrage cité : les quatre autres sont dans la base, mais le texte ne les cite pas. Le titre « Références » vient du fichier de langue français de BibLaTeX, qu’il choisit parce que babel met le document en français ; dans les classes report et book, le titre par défaut est « Bibliographie ».

Pourquoi csquotes ? BibLaTeX met entre guillemets les titres des articles et des chapitres, et pour choisir les guillemets de la langue, les chevrons en français, il s’appuie sur csquotes, l’extension étudiée dans la leçon sur les notes, citations et vers. S’il détecte babel et ne trouve pas csquotes, il le signale dans le journal : « 'babel/polyglossia' detected but 'csquotes' missing. Loading 'csquotes' recommended. » L’ordre recommandé est celui de l’exemple : babel, csquotes, puis BibLaTeX.