biblatex-zotero/policopié.md

413 lines
17 KiB
Markdown
Raw Normal View History

---
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.svg) \
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 (@book, @article, @phdthesis,
etc.). Puis, 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.
La présence de ces champs d'information dépend à la fois de la
complétion de la référence à l'origine ainsi que du format du fichier
*.bib.* **En effet, le format BibLaTeX permet d'ajouter des champs
d'information supplémentaires (notamment concernant les données) par
rapport à BibTeX. Pour autant, les deux formats comprennent les champs
principaux d'une référence bibliographique.**
Il est possible de créer et de mettre à jour un fichier *.bib* à la
main. Pour cela, il faut télécharger une référence au format *.bib*
depuis le web. De nombreuses bases de données telles que Web of Science,
PubMed ou Google Scholar le permettent. Il suffit alors de copier le
contenu de ce fichier *.bib* dans votre bibliothèque *.bib* stockée dans
le dossier du fichier LaTeX.
Cette manière de gérer sa bibliothèque est longue et fastidieuse. Passé
quelques références dans le fichier, il est nécessaire d'utiliser un
logiciel de gestion des références pour créer un fichier *.bib*.
## 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>
[^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.*