--- title: Citer ses références et créer une bibliographie avec \LaTeX date: 2023-03-30 creation_date: 2023-03-24T08:25:47+01:00 id: 20230324082557 authors: [Dimitri Donzé, Vincent Huber, Igor Milhit] bibliography: references.bib link-citations: true --- ## Table des matières 1. [Objectifs][toc0]. 1. [Principes généraux][toc1]. 1. [BibTeX VS BibLaTeX][toc8] 1. [Structure d'une référence dans un fichier `.bib`][toc2]. 1. [Créer un fichier .bib via Zotero][toc3]. 1. [Différences entre le format BibTeX et BibLaTeX][toc4]. 1. [Le format BibLaTeX][toc6]. 1. [Documentation][toc7]. [toc0]: #objectifs [toc1]: #principes-généraux [toc2]: #structure-dune-référence-dans-un-fichier-.bib [toc3]: #créer-un-fichier-.bib-via-zotero [toc4]: #différences-entre-le-format-bibtex-et-biblatex [toc6]: #le-format-biblatex [toc7]: #documentation [toc8]: #bibtex-vs-biblatex ## Objectifs Au terme de cet atelier, vous serez en mesure de : - Comprendre ce qu'est un fichier `.bib`. - Connaître la structure d'une référence. - Créer ou de générer un fichier `.bib`. - Charger les paquets nécessaires dans leur fichier `.tex` et utiliser les outils de composition pour générer le document final. - Utiliser les commandes \LaTeX pour : - Définir leur le style de citation et de bibliographie. - Insérer une citation et un appel de citation. - Créer une bibliographie. ![Logo de la licence CC BY-SA 4.0](media/by-sa.png) \ Ce document est sous licence [*CC BY-SA 4.0*][cc-by-sa]. [cc-by-sa]: https://creativecommons.org/licenses/by-sa/4.0/deed.fr "Texte de la licence en français" \newpage ## Principes généraux Afin de pouvoir insérer des citations et créer des bibliographies avec LaTeX, un fichier contenant les références bibliographiques est nécessaire. Il s'agit d'un fichier dont l'extension est `.bib`, ce qui correspond : - soit selon la structure BibTeX, - soit selon la structure Biber pour BibLaTeX. Ce fichier `.bib` se place le plus souvent dans le même dossier que le document `.tex` de travail. ### BibTeX VS BibLaTeX BibTex est le logiciel historique pour la gestion des références et des bibliographies dans un document `.tex`. Il est aussi le plus répandu dans les exigences des éditeurs scientifiques. Pourtant, ce logiciel n'est plus développé depuis de nombreuses décennies et n'offre pas les fonctionnalités auxquelles nous pouvons nous attendre actuellement, ou seulement avec difficulté. Aussi Biber (et BibLaTeX) est fortement conseillé et c'est pourquoi il n'est question que de cette option dans ce document. Il est plus récent et évolue encore constamment. En ne chargeant que le paquet `biblatex`, il est possible de définir le type d'appel de citation (notes en bas de page, numéro, auteur-date, etc.) et différents style de bibliographies. Débuter avec BibLaTeX n'empêche pas de passer à BibTeX ensuite, si nécessaire. ## Structure d'une référence dans un fichier `.bib` Une référence dans un fichier `.bib` au format BibLaTeX ressemble à cela : ```bib @book{sauvayreMethodesEntretienSciences2013, location = {Paris}, title = {Les méthodes de l'entretien en sciences sociales}, isbn = {978-2-10-057970-9}, series = {Psycho sup. Psychologie sociale}, pagetotal = {138}, publisher = {Dunod}, author = {Sauvayre, Romy}, date = {2013}, note = {Book Title: Les méthodes de l'entretien en sciences sociales}, keywords = {Enquêtes sociologiques, Entretiens, Sociologie}, } ``` La première ligne définit le type de document, sous la forme `@type` (`@book`, `@article`, `@phdthesis`, etc.). Puis, après l'ouverture d'accolade, suit la clé de citation (*Citekey*), c'est-à-dire l'identifiant unique de la référence qui sera indiquée dans le document `.tex`, afin d'insérer une référence. \ Les lignes suivantes correspondent aux champs de la référence, sous la forme `champ = {valeur}`, séparés par une virgule. La documentation BibLaTeX détaille l'ensemble des types et des champs [@lehmanBiblatexPackageProgrammable2023, p. 7]. Il est possible de créer et de mettre à jour un fichier `.bib` à la main, à l'aide d'un éditeur de texte. Un grand nombre de bases de données, de sites de revues ou de catalogues de bibliothèques permettent de télécharger une ou plusieurs références dans un fichier `.bib`, mais le plus souvent dans la structure BibTeX et non pas BibLaTeX. Mais il est bien plus facile de déléguer la gestion du fichier `.bib` à un logiciel de gestion de références bibliographiques, comme [JabRef][^1] ou [Zotero][]. L'intérêt de ces logiciels est d'éviter les erreurs et d'automatiser en partie l'ajout de références dans sa base de données. [^1]: Logiciel multiplatforme et libre, BibTeX et Biber natif. [^2]: Logiciel multiplatforme et libre. ## Créer un fichier `.bib` via Zotero Avec Zotero, il est possible de générer un fichier `.bib` : - À partir d'une sélection de références. - En sélection une collection, une sous-collection ou la bibliothèque entière. Il suffit de : - Sélectionner l'ensemble désiré. - Faire un clic-droit et sélectionner *Exporter la collection / les documents*. - Choisir le format BibTeX ou BibLaTeX.[^3] Ce procédé très simple a néanmoins un inconvénient, qui est que le fichier créé est statique, c'est-à-dire qu'il ne sera pas mis à jour automatiquement si la collection est complétée, ou si les références sont corrigées dans Zotero. Il faudra générer à nouveau et écraser le fichier `.bib` pour qu'il soit à jour. [^3]: Il est également possible d'exporter une bibliothèque au format BibTeX depuis d'autres logiciels bibliographiques, notamment EndNote. Pour cela, dans ce dernier, il faut aller dans les options de styles *Tools / Output Styles / Open Style Manager* et cocher le style *BibTeX Export*. Une fois cela fait, il faut cliquer sur *File Export*, sélectionner le style *BibTeX Export* et sauvegarder le fichier au format `.bib`. ### L'extension *Better BibTeX for Zotero* L'extension *Better BibTeX for Zotero* résout deux problèmes des fichiers `.bib` générés par Zotero : 1. Elle permet d'exporter **un fichier `.bib` dynamique, c'est-à-dire que le contenu de celui-ci sera mis à jour automatiquement lorsque la collection correspondante dans Zotero sera modifiée**. Pour cela, il faut choisir le format d'exportation *Better BibTeX* ou *Better BibLaTeX* et sélectionner l'option *Garder à jour.* \ ![Dialogue Better BibTex](./media/better-bibtex-a-jour.png) 1. Elle permet de **modifier une clé de citation (citekey) manuellement ou de créer un format de citekey par défaut.** Pour installer l'extension (au format .xpi) *Better BibTeX* : - Se rendre sur . - Télécharger le fichier `Zotero-better-bibtex-X.X.X.xpi`. - Dans Zotero, choisir le menu *Outils / Extensions*. \ ![Menu « outils » de Zotero](./media/menu-outils.png) - Cliquer sur la roue crantée en haut à droite et sélectionner *Install Add-on from file*. \ ![Installer un fichier `.xpi`](./media/install-add-on.png) - Sélectionner le fichier téléchargé. ### Autres fonctionnalités de Better BibTeX Better BibTeX propose des fonctionnalités plus avancées : - Création et gestion de clés uniques. - Conversion des caractères UTF-8 et des éventuels balisages HTML présents dans les références. - Génération de champs supplémentaires absents de Zotero. - Création de types de documents n'existant pas dans Zotero. Ces fonctionnalités ne seront pas décrites en détail dans ce document. Les informations supplémentaires à ce sujet sont disponibles sur le site . ## Différences entre le format BibTeX et BibLaTeX ![](media/image3.png){width="7.095138888888889in" height="5.945833333333334in"} ![](media/image15.png){width="1.1079965004374452in" height="0.3184951881014873in"} Un fichier bibliographique .bib peut être créé dans deux formats : **BibTeX ou BibLaTeX.** Il est important de choisir le bon type de format dès le départ car chacun d'eux aura ses avantages et inconvénients et devra être utilisé avec des packages et des moteurs de compilation propre à chacun. Voici ci-dessous, en résumé, le processus pour chacun d'eux : ## Préambule Voici un exemple de préambule avec le paquet `biblatex` et quelques options : ```latex \documentclass[11pt,a4paper]{article} \usepackage{lmodern} \usepackage[french]{babel} \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} \usepackage{hyperref} \usepackage[citestyle=numeric, style=vancouver, backend=biber]{biblatex} \addbibresource{references-exercice.bib} \author{Dimitri Donzé, Vincent Hubert, Igor Milhit} \title{Notre pseudo-article} ``` Le paquet est chargé sous la forme `\usepackage[options]{biblatex}`. Pour les options, il faut se référer à la documentation (@lehmanBiblatexPackageProgrammable2023) ou à la *cheatsheet* (@reesBibLaTeXBiberCheat2017). L'exemple montre les options que vous allez le plus souvent utiliser : - `backend=biber` détermine l'outil de composition, le plus souvent Biber pour BibLaTeX. Cela suppose que Biber soit installé sur votre machine, par exemple dans la distribution LaTeX que vous avez choisie. - `citestyle` définit le style d'appel à citation et comment la bibliographie est ordonnée. - `style` détermine le style dans lequel les références seront rédigées. La commande `\addbibresource{.bib}` permet de définir le fichier contenant les références bibliographiques. Le plus simple, est de le placer dans le même répertoire que le fichier `.tex`. ### Choisir un style bibliographique et de citation Le choix du style de bibliographie et/ou de citation se fait en ajoutant des options lors de la commande du package, p.ex : - \\usepackage\[backend=biber,[style=apa]{.underline}\]{biblatex} où le style général choisi est *apa.* Il est également possible de spécifier des styles différents pour la bibliographie et pour les citations : - \\usepackage\[backend=biber, [bibstyle=alphabetic, citestyle=authoryear]{.underline}\] {biblatex} où le style bibliographique est *bibliographic* et le style de citation *authoryear* ### Citer une référence Comme pour les commandes natbib, BibTeX propose de nombreuses formes de citation de références (voir feuilles annexes). En voici quelques exemples : - \\cite{citekey} citation par défaut selon le style pour un style numérique notamment - \\parencite{citekey} citation entre parenthèses : **(Smith et al., 1990)** - \\textcite citation dans le texte (pour une paraphrase p.ex.) : **Smith et al. (1990)** - \\footcite{citekey} référence en pieds de page abrégée - \\footfullcite{citekey} référence en pieds de page complète ### Créer la bibliographie Enfin, la création de la bibliographie à la fin du document se fait avec la commande : - \\printbibliography ## Résumé des commandes de base pour BibLaTeX ## Documentation ### Bibliographies avec LaTeX en général - *Creating a document in LaTeX*. (s. d.). Consulté 8 juin 2022, à l'adresse - doncherry. (2011). *BibTeX vs. Biber and BibLaTeX vs. Natbib* [Forum post]. TeX - LaTeX Stack Exchange. ### Bibliographies avec BibLaTeX - *Bibliography management with BibLaTeX*. (s. d.). Consulté 25 mars 2022, à l'adresse - *BibLaTeX citation styles*. (s. d.). Consulté 8 juin 2022, à l'adresse : - *BibLaTeX bibliography styles*. (s. d.). Consulté 8 juin 2022, à l'adresse - Lehman, P., Kime, P., & Wemheuer, M. (s. d.). *The biblatex Package*. - Rees, C. F. (s. d.). *Biblatex Cheat Sheet*. - *LaTeX/Bibliographies with biblatex and biber---Wikibooks, open books for an open world*. (s. d.). Consulté 8 décembre 2022, à l'adresse ### Bibliographies avec BibTeX et natbib - *Bibliography management with BibTeX*. (s. d.). Consulté 31 mars 2022, à l'adresse - *BibTeX bibliography styles*. (s. d.). Consulté 8 juin 2022, à l'adresse - *Bibliography management with natbib*. (s. d.). Consulté 8 juin 2022, à l'adresse - *Natbib citation styles*. (s. d.). Consulté 8 juin 2022, à l'adresse - *Natbib bibliography styles*. (s. d.). Consulté 8 juin 2022, à l'adresse - Daly, P. W. (s. d.). *Citations et références en sciences naturelle : Schémas auteur--année ou numérique*. - Using natbib with AASTeX. (s. d.). *AAS Journals*. Consulté 7 décembre 2022, à l'adresse - *A Short Guide to Reference Management using natbib with BibTeX \| BibTeX*. (s. d.). Consulté 7 décembre 2022, à l'adresse - *Pense-bête pour Natbib*. (s. d.). Consulté 7 décembre 2022, à l'adresse ### En savoir plus sur Better BibTeX - *Better BibTeX for Zotero :: Better BibTeX for Zotero*. \[s. d.\]. - CIFUENTES-GOODBODY, Nicholas. *Better Bib(La)Tex. Academic Writing in Plain Text*. 2017. - Sicot, J. (s. d.). *FORMADOCT : Collecter, gérer et citer ses références bibliographiques avec Zotero: Zotero vers LaTeX*. Consulté 8 juin 2022, à l'adresse - GROLIMUND, Raphaël. Zotero et LaTeX. Dans : *Le blog Zotero francophone*. \[s. d.\]. ### Ouvrages cités {#refs}