From 894b31d181ae3b236823110e9fc37326abcbb865 Mon Sep 17 00:00:00 2001
From: iGor milhit <igor.milhit@unige.ch>
Date: Wed, 29 Mar 2023 16:21:15 +0200
Subject: [PATCH] =?UTF-8?q?documentation:=20d=C3=A9roule=20la=20pr=C3=A9se?=
 =?UTF-8?q?ntation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Crée un fichier décrivant le déroulé de la présentation et de
  l'exercice. Le fichier au format markdown peut être converti et
  imprimé.
- Documente comment utiliser et imprimer le déroulé de la présentation.
- Averti que le support de présentation n'existe pas encore.

Co-Authored-by: iGor milhit <igor.milhit@unige.ch>
---
 README.md    | 27 +++++++++++++++++--
 déroulé.md | 74 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 99 insertions(+), 2 deletions(-)
 create mode 100644 déroulé.md

diff --git a/README.md b/README.md
index 7c4376a..ab5ff24 100644
--- a/README.md
+++ b/README.md
@@ -48,7 +48,30 @@ pandoc --citeproc -t pdf --pdf-engine=tectonic -o polycopié.pdf polycopié.md
   PDF, ici `tectonic`, mais `xelatex` devrait fonctionner aussi, si il est
   installé.
 
-## Convertir la présentation au format PDF
+## 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 :
@@ -74,7 +97,7 @@ 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`)
+### 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 :
diff --git a/déroulé.md b/déroulé.md
new file mode 100644
index 0000000..6c0a1a9
--- /dev/null
+++ b/déroulé.md
@@ -0,0 +1,74 @@
+---
+title: Déroulé de la présentation LaTeX et citation
+date: 2023-03-29T15:44:49+02:00
+id: 20230329154459
+tags: [latex, déroulé, rdv-info]
+---
+
+## Vérifier
+
+- Avoir un dossier de travail avec les fichiers :
+  - `exercice.tex`.
+  - `references-exercice.bib`
+- Que la compilation rapide fonctionne soit avec PdfLaTeX ou XeLaTeX.
+- Que BibLaTeX soit sur `bibtex %`.
+- Imprimer le polycopié et la *cheatsheet*.
+
+## Déroulé
+
+### Introduction
+
+1. Questions aux personnes :
+    1. Contexte académique.
+    1. Usage de LaTeX.
+    1. Quel environnement LaTeX.
+    1. Usage d'un gestionnaire de référence.
+1. Plan.
+1. Objectifs.
+1. Principes de base.
+    1. Langage de balisage dans un fichier `.tex`.
+    1. Système de composition.
+    1. Éditeur de texte ou éditeur dédié.
+    1. Base de donnée des références.
+    1. BibTeX VS BibLaTeX.
+1. Structure d'une référence
+
+### Exercice
+
+1. Export Zotero.
+1. Better BibTeX.
+1. Montrer comment configurer la compilation dans Texmaker.
+    1. `biber %` pour BibLaTeX.
+    1. Compilation rapide avec :
+        1. Soit préconfiguration PdfLaTeX, Biber, PdfLaTeX 2x et affichage du
+           PDF.
+        1. Soit, avec l'assistant XeLaTeX, Biber, XeLaTeX 2x et affichage du
+           PDF.
+1. Ouvrir le fichier `exercice.tex` avec Texmaker.
+1. Monter :
+    1. Commentaires, dont l'insertion de la bibliographie.
+    1. Préambule avec les paquets et les options utilisés.
+        1. Dont biblatex, ses options et la base de donnée de références.
+    1. Structure du document.
+    1. Commandes.
+1. Compiler le fichier tel quel.
+1. **Laisser faire.**
+1. Montrer les fichiers auxiliaires.
+1. Montrer qu'on peut les supprimer avec *Outils / nettoyer* dans Texmaker.
+1. Ajouter un appel à citation simple (`\cite`), décommenter l'insertion de la
+   bibliographie.
+1. Compiler et **Laisser faire.**
+1. Changer le `\cite` en `\autocite`.
+1. Essayer d'autres commandes de citation via la cheatsheet.
+    1. Ajouter des options à `\autocite` et souligner que les deux options
+       doivent être affichées :
+       `\autocite[voir][]{bohemierBibTeXNatbibBiblatex}`.
+    1. Insérer un `\textcite{bosmaCodeswitchingAsymmetryBilingual2019}`.
+    1. Insérer un `\parencite{caiWhatMakesGood2021}`.
+1. Compiler et **Laisser faire.**
+1. Insérer une référence multiple :
+   `\textcites{bosmaCodeswitchingAsymmetryBilingual2019}{sauvayreMethodesEntretienSciences2013}` 
+1. Compiler et **Laisser faire.**
+1. Passer à un style `numeric`, `apa`, `vancouver`. Signaler qu'il faudra
+   peut-être installer un style. Mentionner le topic biblatex.
+1. Compiler et **Laisser faire.**