--- 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 --- ## Table des matières 1. [Objectifs][toc0]. 1. [Principes généraux][toc1]. 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 BibTeX (avec package natbib)][toc5]. 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 [toc5]: #le-format-bibtex-avec-package-natbib [toc6]: #le-format-biblatex [toc7]: #documentation ## 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" ## 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. ## 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 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. ## Créer un fichier .bib via Zotero[^1] Pour créer un fichier .bib depuis Zotero il suffit de sélectionner les références ou une collection entière et faire un clic-droit *Exporter la collection / les documents* choisir le format BibTeX ou BibLaTeX. 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 dans Zotero. Il faudra recréer et écraser le fichier .bib pour qu'il soit à jour. ### Créer un fichier .bib via Better BibTeX for Zotero L'add-on *Better BibTeX* résout deux problèmes liés aux fichiers .bib : - ![](media/image9.png){width="2.6381944444444443in" height="1.7993055555555555in"}Premièrement, il permet de sauvegarder **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.* - Deuxièmement, *Better BibTeX* permet de **modifier une clé de citation (citekey) manuellement ou de créer un format de citekey par défaut.** ![](media/image11.png){width="4.865972222222222in" height="1.3840277777777779in"}![](media/image12.png){width="4.865972222222222in" height="1.3840277777777779in"}L'extension (au format .xpi) *Better BibTeX* peut être téléchargée à l\'adresse : [https://retorque.re/zotero-better-BibTeX/](https://retorque.re/zotero-better-bibtex/). Pour l'installer, depuis Zotero, cliquer sur *Outils Extensions Route crantée en haut à droite Install Add-on from file* sélectionnerz 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 [https://retorque.re/zotero-better-BibTeX/](https://retorque.re/zotero-better-bibtex/). ## 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 : ## Le format BibTeX (avec package natbib) Le format BibTeX est le format traditionnel servant à gérer les bibliothèques bibliographiques dans LaTeX. BibTeX datant de 1985, son format est parfois daté, d'autant plus qu'il n'est plus vraiment mis à jour. Ainsi, les fichiers BibTeX manquent de champs d'information pertinents pour certains types de documents. Pour autant, sa stabilité et sa large diffusion le rend toujours intéressant, notamment dans l'optique de la publication du document chez un éditeur scientifique. En effet, BibTeX est plus largement répandu, et donc accepté, que son alter-ego BibLaTeX. ### Package natbib Le fichier BibTeX est généralement associé au package natbib. Celui-ci n'est pas obligatoire mais il propose de nombreuses options supplémentaires, nécessaires selon les besoins en matière de citation. natbib définira quelles commandes pourront être utilisées pour personnaliser et citer les citations et la bibliographie. Il faut donc utiliser la commande ci-dessous au début du document LaTeX : - \\usepackage\[backend=bibtex\]{natbib} ### Moteur de compilation bibtex ![](media/image18.png){width="5.946527777777778in" height="1.7236111111111112in"}![](media/image19.png){width="5.946527777777778in" height="1.7236111111111112in"}Le format BibTeX et le package natbib se compilent via le moteur bibtex. Il peut être appelé au lancement de la commande du pack natbib comme ci-dessus, ou être choisi par défaut comme moteur de compilation dans les paramètres de la suite LaTeX : ### Définir un style de bibliographie et de citation Commande pour choisir un style de bibliographie : - \\bibliographystyle{nomdustyle} Pour définir un style bibliographique, se référer à la fiche de synthèse. Par défaut, le style de citation est similaire au style pour la bibliographie. Il est néanmoins possible d\'en paramétrer un soi-même via une commande telle que celle-ci : - \\setcitestyle {authoryear,open={((},close={))}} dans laquelle il faut définir manuellement la forme de citation, les parenthèses utilisées, etc. (voir feuille annexe). ### Créer une bibliographie - \\bibliography{nomdufichier} Cette dernière commande créera la bibliographie à l'endroit choisi dans le document LaTeX. Elle se situera donc plutôt à la fin de celui-ci. De plus, elle sert également à appeler le fichier .bib correspondant. Ainsi, contrairement aux commandes BibLaTeX, il n'y a pas besoin d'une commande propre à l'appel du fichier bibliographique. ### Citer une référence Il existe de nombreuses commandes pour citer une référence, permettant de les adapter à ses besoins. En voici quelques exemples : - \\cite{citekey} citation par défaut selon le style pour un style numérique notamment - \\citet{citekey} citation dans le texte (pour une paraphrase p. ex.) : **Smith et al. (1990)** - \\citep{citekey} citation entre parenthèses : **(Smith et al., 1990)** - \\nocite{citekey} citation non visible afin d'ajouter une référence automatiquement dans la bibliographie ### Résumé des commandes de base pour natbib Adapté de : [https://tex.stackexchange.com/questions/5091/what-to-do-to-switch-to-BibLaTeX](https://tex.stackexchange.com/questions/5091/what-to-do-to-switch-to-biblatex) ## Le format BibLaTeX BibLaTeX est un format de fichier plus récent et plus complet que BibTeX. Les champs d'information sont possiblement plus complets et il est possible d'en ajouter des personnalisés. Cependant, ce format étant plus récent, il est moins universellement accepté par les éditeurs. Il faut donc se renseigner auprès de ceux-ci si nécessaire. ### Package BibLaTeX Le fichier BibLaTeX est généralement associé au package biblatex. Celui-ci définira quelles commandes pourront être utilisées pour personnaliser et citer les citations et la bibliographie. Il faut donc utiliser la commande ci-dessous au début de votre document LaTeX : - \\usepackage\[backend=biber\]{biblatex} ### Moteur de compilation Biber ![](media/image22.png){width="6.060416666666667in" height="1.7395833333333333in"}![](media/image19.png){width="6.060416666666667in" height="1.7395833333333333in"}Le format BibLaTeX et le package biblatex se compilent via le moteur biber qui peut être appelé avec le pack natbib comme ci-dessus, ou être choisi par défaut comme moteur de compilation dans les paramètres de la suite LaTeX : ### Sélectionner le fichier .bib Contrairement aux commandes natbib, il est nécessaire avec biblatex d'ajouter une commande précisant quel est le fichier .bib à utiliser pour citer les références : - \\addbibresource{nomdufichier.bib} ### 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} [^1]: 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.*