From 466997e2fda7b7002241e4611715abadc765476c Mon Sep 17 00:00:00 2001
From: iGor milhit <igor.milhit@unige.ch>
Date: Tue, 21 Mar 2023 12:04:01 +0100
Subject: [PATCH] =?UTF-8?q?pr=C3=A9sentation:=20essaie=20quelques=20possib?=
 =?UTF-8?q?ilit=C3=A9s?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 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. Ce point
  n'est pas encore documenté.
- Ajoute une règle pour ignorer les fichiers HTML.

Co-Authored-by: iGor milhit <igor.milhit@unige.ch>
---
 .gitignore      |  1 +
 .gitmodules     |  3 +++
 README.md       | 39 +++++++++++++++++++++++++++++++++++----
 presentation.md | 16 ++++++++--------
 reveal.js       |  1 +
 5 files changed, 48 insertions(+), 12 deletions(-)
 create mode 100644 .gitmodules
 create mode 160000 reveal.js

diff --git a/.gitignore b/.gitignore
index a136337..f4df0be 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,2 @@
 *.pdf
+*.html
diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..79e8571
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "reveal.js"]
+	path = reveal.js
+	url = github:hakimel/reveal.js.git
diff --git a/README.md b/README.md
index 2d6c6cb..d454566 100644
--- a/README.md
+++ b/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,39 @@ 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
-taper la commande suivante :
+## Pré-requis
+
+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
+```
+
+
+[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
diff --git a/presentation.md b/presentation.md
index 1d269f2..0cd2d61 100644
--- a/presentation.md
+++ b/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.
diff --git a/reveal.js b/reveal.js
new file mode 160000
index 0000000..724c4fe
--- /dev/null
+++ b/reveal.js
@@ -0,0 +1 @@
+Subproject commit 724c4fee274914dd2d997b7584cf603c44e96c72