.bib}` permet de définir le chemin
et 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
l'aide-mémoire), pour les différents cas. La syntaxe est la suivante :
```latex
\cite[][]{}
```
- `\cite` est la commande proprement dite, qui détermine le type de citation
utilisée (`\cite`, `\autocite`, etc.).
- `[]`, optionnel, permet d'ajouter du texte avant l'appel à citation. Par
exemple `[voir]` permet d'obtenir `(voir Auteur, date)`.
- `[]`, optionnel, ajoute du texte après l'appel à citation, comme un
numérotation de pages.
- Si on ajoute une option (`pre` ou `post`), il faut toujours ajouter l'autre
option, même si on la laisse vide : `\cite[voir][]{citationKey}`.
- `{}`, 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{}{}`.
### 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, par exemple :
```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 l'aide-mémoire 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, la sortie de la commande, à savoir 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
```
## LaTeX, mais sans LaTeX ?
Il est possible de produire un document au format PDF avec un rendu identique à
LaTeX avec un fichier source rédigé non pas avec la syntaxe LaTeX, mais avec
Markdown[^8]. Il s'agit d'un langage de balisage *léger*, plus simple à
maîtriser. Surtout, le mécanisme pour les citations et la bibliographie est
très similaire. C'est pourquoi il en est très brièvement question ici.
Le principe de base est le suivant :
1. La source est un ou plusieurs fichiers texte en Markdown.
1. La base de donnée des références bibliographiques est également un fichier
texte, par exemple au format BibLaTeX (`.bib`) ou CSL Json (`.json`).
1. Dans les deux cas, *Better BibTeX* est en mesure de le créer (et de le
mettre à jour automatiquement).
1. La conversion de la source en PDF se fait avec Pandoc[^9] (et Pandoc Citeproc
qui est intégré à Pandoc).
1. Pandoc s'appuie sur un moteur pour LaTeX, par exemple XeLaTeX.
Dans le fichier source, pour insérer une citation on peut le faire avec les
syntaxes suivantes :
- `[@citationKey]`, équivalent à `\parencite{citationKey}`.
- `[@citationKey1; @citationKey2]`, équivalent à `\parencites{...}`.
- `@citationKey`, équivalent à `\textcite{citationKey}`.
La bibliographie sera insérée après le dernier titre de section (vide) du
document.
Pour convertir au format PDF la source, on peut utiliser la commande suivante
dans un terminal :
```bash
pandoc --citeproc --bibliography="references.bib" \
--pdf-engine="xelatex" \
--output="document.pdf" source.md
```
Cette commande demande au logiciel `pandoc` de convertir le fichier `source.md`
vers le fichier `document.pdf` (donc au format PDF), en utilisant XeLaTeX, en
traitant les références bibliographiques (`--citeproc`) sur la base de la liste
de références du fichier `references.bib`.
Rien n'empêche d'ajouter des configurations et des paramètres. Une solution est
d'ajouter un « frontmatter » à notre fichier Markdown, autrement dit un entête
au format YAML pour préciser des métadonnées et des paramètres, un peu comme on
le ferait avec un préambule pour LaTeX. Par exemple :
```yaml
title: Notre pseudo-article
date: Printemps 2026
lang: fr
author:
- "Auteur 1"
- "Auteur 2"
pdf-engine: xelatex
bibliography: ./references-exercice.bib
csl-style: ./vancouver.csl
link-citations: true
colorlinks: true
```
`csl-style` spécifie le style de citation utilisé au moyen d'un fichier CSL, à
savoir les styles utilisés par Zotero. `link-citations` et `colorlinks`
indiquent que les appels à citation sont des liens hypertextes, et que les
liens hypertextes doivent être en couleur.
La commande de conversion peut être simplifiée :
```bash
pandoc --citeproc --output="document.pdf" source.md
```
Ce principe se retrouve avec d'autres outils, construits avec les mêmes briques
(Pandoc, Markdown), comme Zettlr[^11] ou Quarto[^12].
## Bibliographie {.newpage}