409 lines
16 KiB
Markdown
409 lines
16 KiB
Markdown
---
|
||
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.
|
||
|
||
 \
|
||
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, à la
|
||
page 7 (@lehmanBiblatexPackageProgrammable2023).
|
||
|
||
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 :
|
||
|
||
- {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.**
|
||
|
||
{width="4.865972222222222in"
|
||
height="1.3840277777777779in"}{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
|
||
|
||
{width="7.095138888888889in"
|
||
height="5.945833333333334in"}
|
||
|
||
{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
|
||
|
||
{width="5.946527777777778in"
|
||
height="1.7236111111111112in"}{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
|
||
|
||
{width="6.060416666666667in"
|
||
height="1.7395833333333333in"}{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
|
||
<https://www.overleaf.com/learn/latex/Creating_a_document_in_LaTeX>
|
||
- doncherry. (2011). *BibTeX vs. Biber and BibLaTeX vs. Natbib*
|
||
[Forum post]. TeX - LaTeX Stack Exchange.
|
||
<https://tex.stackexchange.com/q/25701>
|
||
|
||
### Bibliographies avec BibLaTeX
|
||
|
||
- *Bibliography management with BibLaTeX*. (s. d.). Consulté 25 mars
|
||
2022, à l'adresse
|
||
<https://fr.overleaf.com/learn/latex/Bibliography_management_with_BibLaTeX>
|
||
- *BibLaTeX citation styles*. (s. d.). Consulté 8 juin 2022, à
|
||
l'adresse :
|
||
<https://www.overleaf.com/learn/latex/BibLaTeX_citation_styles>
|
||
- *BibLaTeX bibliography styles*. (s. d.). Consulté 8 juin 2022, à
|
||
l'adresse
|
||
<https://www.overleaf.com/learn/latex/BibLaTeX_bibliography_styles>
|
||
- Lehman, P., Kime, P., & Wemheuer, M. (s. d.). *The biblatex
|
||
Package*.
|
||
<https://mirror.metanet.ch/tex-archive/macros/latex/contrib/biblatex/doc/biblatex.pdf>
|
||
- Rees, C. F. (s. d.). *Biblatex Cheat Sheet*.
|
||
<http://tug.ctan.org/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf>
|
||
- *LaTeX/Bibliographies with biblatex and biber---Wikibooks, open
|
||
books for an open world*. (s. d.). Consulté 8 décembre 2022, à
|
||
l'adresse
|
||
<https://en.wikibooks.org/wiki/LaTeX/Bibliographies_with_biblatex_and_biber>
|
||
|
||
### Bibliographies avec BibTeX et natbib
|
||
|
||
- *Bibliography management with BibTeX*. (s. d.). Consulté 31 mars
|
||
2022, à l'adresse
|
||
<https://www.overleaf.com/learn/latex/Bibliography_management_with_BibTeX>
|
||
- *BibTeX bibliography styles*. (s. d.). Consulté 8 juin 2022, à
|
||
l'adresse
|
||
<https://www.overleaf.com/learn/latex/BibTeX_bibliography_styles>
|
||
- *Bibliography management with natbib*. (s. d.). Consulté 8 juin
|
||
2022, à l'adresse
|
||
<https://www.overleaf.com/learn/latex/Bibliography_management_with_natbib>
|
||
- *Natbib citation styles*. (s. d.). Consulté 8 juin 2022, à l'adresse
|
||
<https://www.overleaf.com/learn/latex/Natbib_citation_styles>
|
||
- *Natbib bibliography styles*. (s. d.). Consulté 8 juin 2022, à
|
||
l'adresse
|
||
<https://www.overleaf.com/learn/latex/Natbib_bibliography_styles>
|
||
- Daly, P. W. (s. d.). *Citations et références en sciences
|
||
naturelle : Schémas auteur--année ou numérique*.
|
||
<https://mirror.metanet.ch/tex-archive/info/translations/natbib/fr/f-natbib.pdf>
|
||
- Using natbib with AASTeX. (s. d.). *AAS Journals*. Consulté 7
|
||
décembre 2022, à l'adresse <https://journals.aas.org/natbib/>
|
||
- *A Short Guide to Reference Management using natbib with BibTeX \|
|
||
BibTeX*. (s. d.). Consulté 7 décembre 2022, à l'adresse
|
||
<https://bibtex.eu/natbib/>
|
||
- *Pense-bête pour Natbib*. (s. d.). Consulté 7 décembre 2022, à
|
||
l'adresse <http://merkel.texture.rocks/Latex/natbib.php>
|
||
|
||
### En savoir plus sur Better BibTeX
|
||
|
||
- *Better BibTeX for Zotero :: Better BibTeX for Zotero*. \[s. d.\].
|
||
<https://retorque.re/zotero-better-BibTeX/>
|
||
- CIFUENTES-GOODBODY, Nicholas. *Better Bib(La)Tex. Academic Writing
|
||
in Plain Text*. 2017.
|
||
<https://www.youtube.com/watch?v=GAVXVkcpbG0>
|
||
- 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
|
||
<https://formadoct.doctorat-bretagneloire.fr/zotero/zotero_latex>
|
||
- GROLIMUND, Raphaël. Zotero et LaTeX. Dans : *Le blog Zotero
|
||
francophone*. \[s. d.\]. <https://zotero.hypotheses.org/762>
|
||
|
||
|
||
[^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.*
|