411 lines
16 KiB
Markdown
411 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.
|
|||
|
|
|||
|
![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
|
|||
|
<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>
|
|||
|
|
|||
|
### 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.*
|