---
title: Citation et bibliographie avec LaTeX
date: 2023-03-21T10:22:47+01:00
id: 20230321102247
tags: [README, documentation, latex, rdv-info]
---

## [Citation et bibliographie avec LaTeX][projet]

Ce répertoire contient les sources pour le *Rendez-vous de l'info* sur les
citations et les références bibliographiques avec LaTeX. Il contient :

- La source en markdown pour le support de cours.
- Des exemples de fichiers `.tex`.
- Un export de collection Zotero au format biblatex.

## Pour démarrer

Pour pouvoir utiliser ce projet, il est nécessaire :

1. De cloner le projet : \
   `git clone https://git.milhit.ch/igor/biblatex-zotero.git`
1. D'activer le module pour `reveal.js` pour la présentation au format HTML :
   ```bash
   git submodule init
   git submodule update
   ```
1. Pour générer les différents fichiers, deux outils sont nécessaire :
   1. `pandoc`. Pour installer `pandoc`, voir [la
      documentation][pandoc-install].  
   1. Une distribution \LaTeX. Une possibilité est de consulter le site web
      [*The \LaTeX project*][latex-project] qui décline les méthodes les plus
      habituelles pour les principaux systèmes d'exploitation. **Pour ma part,
      je recommande l'usage de `tectonic` qui est un binaire à installer** :
      voir comment [installer tectonic][tectonic-install].

## Convertir le support de cours en PDF

Pour convertir le support de cours (`polycopié.md`) au format PDF, il faut
utiliser la commande suivante :

```bash
pandoc --citeproc -t pdf --pdf-engine=tectonic -o polycopié.pdf polycopié.md
```

- `--citeproc` traite les citations et génère la bibliographie.
- `--pdf-engine` définit le moteur de compilation a utiliser pour produire le
  PDF, ici `tectonic`, mais `xelatex` devrait fonctionner aussi, si il est
  installé.

## Convertir la présentation au format PDF

Pour obtenir la présentation au format PDF, il faut utiliser la commande
suivante :

```bash
pandoc -t beamer -V theme=AnnArbor \
       -V colortheme=sidebartab presentation.md -o presentation.pdf
```

- `-t beamer` définit le format de présentation beamer.
- `-V theme=Hannover` permet de passer en variable (`-V`) le theme beamer
  désiré.
- `-V colortheme=sidebartab` définit le thème de couleur.

Une galerie des thèmes et des thèmes de couleurs est disponible en ligne :
<https://deic.uab.cat/~iblanes/beamer_gallery/>.

Il peut être nécessaire de définir l'installation de \LaTeX, par exemple
pour `tectonic` :

```bash
pandoc -t beamer -V theme=AnnArbor -V colortheme=sidebartab \
       --pdf-engine=tectonic presentation.md -o presentation.pdf
```

## Pour convertir la présentation au format HTML (`reveal.js`)

Il faut s'assurer que `pandoc` soit installé et que le submodule `reveal.js`
soit bien activé. Puis, il suffit de taper la commande suivante :

```bash
pandoc -t revealjs --self-contained -o presentation.html presentation.md
```

- `-t revealjs` définit le format de présentation `reveal.js`.
- `--self-contained` assure que tous les fichiers nécessaires à la présentation
  seront bien contenu dans un seul fichier HTML.


[projet]: ./
[pandoc-install]: https://pandoc.org/installing.html
[latex-project]: https://www.latex-project.org/get/
[tectonic-install]: https://tectonic-typesetting.github.io/en-US/install.html