138 lines
4.3 KiB
Markdown
138 lines
4.3 KiB
Markdown
---
|
||
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.
|
||
|
||
Le support de cours au format PDF ainsi que les fichiers d'exercice peuvent
|
||
être téléchargés dans [les publications de version][latest].
|
||
|
||
[latest]: https://git.milhit.ch/igor/biblatex-zotero/releases/latest
|
||
|
||
## 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
|
||
|
||
### Avec LaTeX
|
||
|
||
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é.
|
||
|
||
### Avec `paged.js`
|
||
|
||
```bash
|
||
pandoc --self-contained --template=template.html --css=polycopié.css \
|
||
--citeproc --t html -o test.html polycopié.md
|
||
```
|
||
|
||
|
||
```bash
|
||
pandoc --self-contained --css=polycopié.css \
|
||
--citeproc --t pdf --pdf-engine=pagedjs-cli -o test.html polycopié.md
|
||
```
|
||
|
||
## Déroulé de la présentation
|
||
|
||
Le fichier `déroulé.md` décrit le déroulé de la présentation. Si une impression
|
||
est nécessaire, on peut soit utiliser le rendu HTML d'un éditeur, soit le
|
||
convertir au format désiré puis l'imprimer.
|
||
|
||
Pour le HTML :
|
||
|
||
```bash
|
||
pandoc -t html5 -s -o déroulé.html déroulé.md
|
||
```
|
||
|
||
Pour le PDF :
|
||
|
||
```bash
|
||
pandoc -t pdf --pdf-engine=tectonic -o déroulé.pdf déroulé.md
|
||
```
|
||
|
||
## Support de présentation
|
||
|
||
⚠ Il n'y a pas encore de support de présentation. Le fichier est là à titre
|
||
d'essai pour l'instant.
|
||
|
||
### 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
|