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}
|
|||
|
|
|
|||
|
|
|
|||
|
|
|