365 lines
14 KiB
Markdown
365 lines
14 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
|
||
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.
|
||
|
||
 \
|
||
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. <https://www.jabref.org/>
|
||
[^2]: Logiciel multiplatforme et libre. <https://www.zotero.org/>
|
||
|
||
## 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.* \
|
||
|
||
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 <https://github.com/retorquere/zotero-better-bibtex/releases/latest>.
|
||
- Télécharger le fichier `Zotero-better-bibtex-X.X.X.xpi`.
|
||
- Dans Zotero, choisir le menu *Outils / Extensions*. \
|
||
|
||
- Cliquer sur la roue crantée en haut à droite et sélectionner *Install Add-on
|
||
from file*. \
|
||
|
||
- 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
|
||
<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 :
|
||
|
||
## 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{<nom-du-fichier>.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
|
||
<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}
|
||
|
||
|
||
|