biblatex-zotero/polycopié.md

---
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
author: 
- Dimitri Donzé^[Bibliothèque de l'UNIGE, site UNIMAIL]
- Vincent Huber^[Bibliothèque de l'UNIGE, site Arve]
- Igor Milhit^[Bibliothèque de l'UNIGE, site CMU]
lang: fr
bibliography: references-support.bib
reference-section-title: Bibliographie
nocite: '@*'
link-citations: true
---

## 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. [Utilisation de BibLaTeX][toc6].
1. [Bibliographie][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
[toc6]: #utilisation-de-biblatex
[toc7]: #refs

## 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]. \
Les sources sont sur <https://git.milhit.ch/igor/biblatex-zotero>

[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

> Dans LaTeX il faut distinguer le langage de balisage, le système de
> composition et la *distribution*. @fauchieFabriquesPublicationLaTeX2020

Pour générer des documents avec LaTeX, il faut :

- Rédiger un document dans un fichier `.tex` à l'aide du langage de balisage,
  afin de le structurer.
- Compiler ce fichier avec un système (ou moteur) de composition, par exemple
  LaTeX, PdfLaTeX ou XeLaTeX.

Pour disposer d'un tel système de composition, le plus souvent on installe un
environnement ou une distribution LaTeX, par exemple TeX Live pour Linux,
MacTex pour Mac OS ou MiKTeX pour Windows.[^0] De plus en plus souvent,
toutefois, afin de faciliter le travail en collaboration ou pour s'éviter une
installation parfois laborieuse, des services en ligne sont préférés, comme
<https://www.overleaf.com/>.

Enfin, un éditeur de texte est nécessaire pour travailler sur les sources (le
ou les fichiers `.tex`). N'importe quel éditeur suffit, mais des aides comme la
coloration syntaxique, la complétion des commandes ou la gestion de la
compilation autrement que dans une console sont très utiles. Parmi une liste
impressionnante, les éditeurs suivants peuvent être mentionnés :

- Texmaker, libre, multiplatforme, <https://www.xm1math.net/texmaker/>.
- TeXworks, libre, multiplatforme, <https://www.tug.org/texworks/>.
- Visual Studio Code, gratuit, multiplatforme,
  <https://code.visualstudio.com/>, avec les extensions nécessaires.

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 à la structure BibTeX,
- soit à la structure Biber pour BibLaTeX.

Ce fichier `.bib` se place le plus souvent dans le même dossier
que le document `.tex` de travail.

[^0]: Voir le site <https://www.latex-project.org/get/>.

### 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 facilement les
fonctionnalités auxquelles nous pouvons nous attendre actuellement.

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},
  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]. Une *cheatsheet* les liste
également [voir @reesBibLaTeXBiberCheat2017].

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 recommandé de déléguer la gestion du fichier `.bib` à un logiciel
de gestion de références bibliographiques, comme JabRef[^1] ou Zotero[^2].
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électionnant 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.* \
   ![Dialogue Better BibTex](./media/better-bibtex-a-jour.png)
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*. \
  ![Menu « outils » de Zotero](./media/menu-outils.png)
- Cliquer sur la roue crantée en haut à droite et sélectionner *Install Add-on
  from file*. \
  ![Installer un fichier `.xpi`](./media/install-add-on.png)
- 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/>.


## Configuer la compilation

Pour générer le fichier PDF à partir des sources `.tex` et `.bib`, il est
nécessaire de configurer le système de composition que l'on va utiliser. Il
peut être appelé en ligne de commande dans une console ou, à l'inverse, pris en
charge presque entièrement par une plateforme comme Overleaf. Et entre les
deux, des éditeurs de texte dédiés à LaTeX offrent un certain nombre d'options
de compilation ou de composition.

L'exemple donné ci-dessous est adapté à l'exercice et à l'utilisation de
l'éditeur Texmaker, mais le principe est similaire dans les différents
environnement.

Dans Texmaker, la fonction pour lancer BibTeX ou Biber est la même. Il faut
donc lui préciser lequel on utilise :

1. Menu Options.
1. Configurer Texmaker.
1. Dans l'onglet *Commandes*, chercher l'entrée *Bib(la)tex* et entrer `biber
   %`. \
   ![Configuer Biber pour BibLaTeX](./media/texmaker-biber.png)

Lorsque l'on compile avec des références bibliographiques, il est nécessaire de
le faire quatre fois :

1. LaTeX.
1. Biber.
1. LaTeX.
1. LaTeX.

Heureusement Texmaker permet de configure une *Compilation rapide* qui lance
tout seul ces quatre itération :

1. Menu Options.
1. Configurer Texmaker.
1. Onglet *Compil rapide*.
1. Choisir la suite de commande à lancer.

Dans le cas de l'exercice présenté, une bonne solution est d'utiliser XeLaTeX.
Pour cela, il faut choisir l'option *Utilisateur* et utiliser l'assistant.

![Assistant de configuration de compil rapide](./media/compil-rapide-assistant.png)

Puis, dans l'assistant, sélectionner les commandes à ajouter, une à une, dans
l'ordre.

![Ajout des commandes](./media/compil-rapide-liste.png)

Les outils comme Overleaf ou `tectonic`[^5] prennent eux-mêmes en charge ce
genre de complexité.

[^5]: Voir <https://tectonic-typesetting.github.io>. L'intérêt de cet outil est
qu'il s'occupe de télécharger à la volée des logiciels nécessaires en fonction
de ce qui est indiqué dans le préambule. À l'exception de Biber qui doit être
installé sur le système.

## Utilisation de BibLaTeX

### Préambule : options de style et lien avec les références {#preambule} 

Voici un exemple de préambule avec le paquet `biblatex` et quelques options :

```latex
\documentclass[11pt,a4paper,french]{article}
\usepackage{lmodern}
\usepackage[french]{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{hyperref}
\usepackage[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 ou à la *cheatsheet* citées plus
haut. 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.
- `style` détermine le style dans lequel les références seront rédigées.

Pour plus de finesse, existent les options `citestyle` pour définit le style de
citation et `bibstyle` pour le style bibliographique. Le plus souvent l'option
`style` suffit.

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`.

### Insérer des citations

Pour insérer des citations, il existe un ensemble de commandes possibles (voir
la *cheatsheet*), pour les différents cas. La syntaxe est la suivante :

```latex
\cite[<pre>][<post>]{<key>}
```

- `\cite` est la commande proprement dite, qui détermine le type de citation
  utilisée.
- `[<pre>]`, optionnel, permet d'ajouter du texte avant l'appel à citation. Par
  exemple `[voir]` permet d'obtenir `(voir Auteur, date)`.
- `[<post>]`, optionnel, ajoute du texte après l'appel à citation, comme un
  numérotation de pages.
- `{<ke>}`, obligatoire, est la clé de citation indiquant de quelle référence
  il s'agit. Par exemple `{slaweckiParadigmsQualitativeResearch2018}`.

Voici les appels de citation les plus utiles :

- `\autocite` est dépendante du style utilisé, aussi elle s'adapte
  automatiquement au style de citation.
- `\textcite` insère l'appel à citation dans le texte.
- `\parencite` insère l'appel à citation dans des parenthèses.

Ces commandes possèdent des versions pour appeler plusieurs références
simultanément : `\autocites{<key1>}{<key2>}`.

### Créer une bibliographie

La commande `\printbibliography` insère la bibliographie. Elle se place
généralement à la fin du document, mais ce n'est pas obligatoire.

Elle peut prendre un certain nombre d'options :

```latex
\printbibliography[title=Bibliographie]
```

Cet exemple définit le titre de la bibliographie. Par défaut, le titre est
*Références* en français.

À l'aide de la *cheatsheet* ou de la documentation il est possible de
comprendre comment réaliser une bibliographie pour une section du document, ou
une bibliographie ne contenant que les références liées à un mot clé
particulier.

### Enrichir BibLaTeX

Dans la bibliographie est indiqué une ressource en ligne qui liste des paquets
pouvant être installés afin d'enrichir BibLaTeX [@CTANTopicBibLaTeX]. Dans ces
paquets, on trouve par exemple des styles bibliographiques. Or, pour les
installer, il faut savoir dans quel répertoire il faut ajouter les fichiers, si
nécessaire. Pour cela, une commande peut être tapée dans une console (par
exemple Powershell pour Windows, iterm pour Mac OS ou votre terminal Linux) :

```bash
kpsewhich --var-value TEXMFLOCAL
/usr/local/share/texmf:/usr/share/texmf
```

La deuxième ligne est le chemin correspondant à l'installation de LaTeX où les
répertoires et fichiers peuvent être ajoutés.

Sous Windows la commande ne prend qu'un tiret pour le paramètre :

```bash
kpsewhich -var-value TEXMFLOCAL
```