From 4bc194cb44136bbdb554f79e74097810cf5172fa Mon Sep 17 00:00:00 2001 From: iGor milhit Date: Tue, 21 Mar 2023 12:04:01 +0100 Subject: [PATCH] =?UTF-8?q?pr=C3=A9sentation:=20permet=20la=20g=C3=A9n?= =?UTF-8?q?=C3=A9ration=20PDF=20et=20revealjs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Ajoute quelques slides avec un contenu prétexte. - 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 --- .gitignore | 1 + .gitmodules | 3 +++ README.md | 66 ++++++++++++++++++++++++++++++++++++++++++++++--- presentation.md | 16 ++++++------ reveal.js | 1 + 5 files changed, 75 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..12123b5 --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "reveal.js"] + path = reveal.js + url = https://github.com/hakimel/reveal.js.git diff --git a/README.md b/README.md index 2d6c6cb..66a4798 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,66 @@ 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 : +## 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 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 -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 : +. + +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 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