présentation: essaie quelques possibilités

- Ajoute des slides pour essayer.
- Documente les prérequis et les commandes pour obtenir la présentation
  au format PDF.
- Ajoute un submodule pour `reveal.js`, afin d'en disposer et documente
  ce point, ainsi que la génération de la présentation au format HTML.
- Ajoute une règle pour ignorer les fichiers HTML.

Co-Authored-by: iGor milhit <igor.milhit@unige.ch>

.gitignore

@@ -1 +1,2 @@
 *.pdf
+*.html

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "reveal.js"]
+	path = reveal.js
+	url = https://github.com/hakimel/reveal.js.git

README.md

@@ -1,10 +1,12 @@
 ---
 title: Citation et bibliographie avec LaTeX
-date: 2023-03-21
+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 :
 
@@ -12,10 +14,61 @@ citations et les références bibliographiques avec LaTeX. Il contient :
 - Des exemples de fichiers `.tex`.
 - Un export de collection Zotero au format biblatex.
 
-Pour obtenir la présentation au format PDF, il faut avoir installé `pandoc` et
+## Pour démarrer
-taper la commande suivante :
+
+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 très simple à
+      installer** : voir comment [installer tectonic][tectonic-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 presentation.pdf -o presentation.pdf
+pandoc -t beamer -V theme=AnnArbor presentation.pdf -o presentation.pdf
 ```
 
+- `-t beamer` définit le format de présentation beamer.
+- `-V theme=AnnArbor` permet de passer en variable (`-V`) le theme beamer
+  désiré.
+
+Il peut être nécessaire de définir l'installation de \LaTeX, par exemple
+pour `tectonic` :
+
+```bash
+pandoc -t beamer -V theme=AnnArbor --pdf-engine=tectonic presentation.pdf -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

presentation.md

@@ -1,10 +1,9 @@
 ---
 title: Citer ses références et créer une bibliographie avec LaTeX
 author: iGor milhit
-date: 2023-03-21
+date: 2023-03-21T09:07:01+01:00
 id: 20230321090701
 tags: [rdv-info, latex, biblatex, zotero, bibliographie]
-theme: AnnArbor
 ---
 
 ## Objectifs de la formation
@@ -19,8 +18,6 @@ theme: AnnArbor
 ```latex
 \documentclass[11pt,a4paper]{article} 
 \usepackage{lmodern}
-%\usepackage{polyglossia}
-%\setdefaultlanguage{french} 
 \usepackage[french]{babel}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
@@ -28,10 +25,13 @@ theme: AnnArbor
 \usepackage[citestyle=numeric,
             style=vancouver,
             backend=biber]{biblatex}
-% Declares the references file
 \addbibresource{references.bib}
-
-\author{Igor Milhit}
-\title{Un article avec une bibliographie !}
 ```
 
+# Examples
+
+## Exemple de bloc
+
+### Titre {.alert}
+
+Texte dans un bloc.

reveal.js

@@ -0,0 +1 @@
+Subproject commit 724c4fee274914dd2d997b7584cf603c44e96c72