màj presentation, ajoute README

This commit is contained in:
dadel 2018-03-20 11:58:41 +01:00
parent cba297f027
commit a598f78567
6 changed files with 91 additions and 7 deletions

82
README.md Normal file
View File

@ -0,0 +1,82 @@
# Template LaTeX/Beamer pour Hadoly
Le template est situé dans le dossier `template/`.
Vous pouvez vous inspirer de l'exemple fourni ici.
Pour utiliser le template Hadoly dans votre présentation il faut :
- copier le dossier `template/` dans votre dossier de travail
- créer un fichier .tex incluant les éléments nécessaires (exemple `hadoly_modele_navigation.tex`)
- inclure le fichier _.tex_ dans votre présentation beamer ou Markdown
- compiler votre document
## Exemple
Les présentations sont écrites en Markdown dont les fichiers se terminent par l'extention `.md`.
Vous pouvez la compiler en PDF avec la commande make où en tapant :
```sh
pandoc presentation.md -t beamer -o presentation.pdf
```
Il faut évidemment avoir au préalable installé Pandoc, Latex et Beamer.
## Utilisation
Pour créer une présentation avec ce template il faut donc un fichier
LaTeX (`hadoly_modele_navigation.tex` convient)
et dans le Markdown il faut y faire référence dans les métadonnées en l'inculant
sans l'extension dans `header-includes`.
Le template utilise les métadonnées `title`, `subtitle`,`author` et `date`.
Exemple d'entête en début de fichier Markdown :
```markdown
---
title: Hadoly, le CHATON Lyonnais
subtitle: Un hébergeur libre et éthique à Lyon
author: Adel Daouzli
date: 24 mars 2018
header-includes:
- \input{hadoly_modele_navigation}
---
```
Les 2 délimiteurs `---` permettent au début du fichier de définir les métadonnées.
Puis dans la suite, le délimiteur permet de passer à une nouvelle diapo.
Notez ensuite que les titres ont des rendus différents en fonction de leur niveau:
### Premier niveau
Le premier niveau (avec `#`) représente une section et se retrouvent dans
l'entête en haut à gauche (qui liste les 3 plus proches) ainsi que sur une
page à part en début de section.
### Deuxième niveau
Les titres de deuxième niveau (avec `##`) se retrouvent en entête à droite
devant le numéro de diapo.
Leur utilisation implique le passage à une nouvelle diapo.
Attention, ils peuvent se retrouver aussi sur une page à part comme pour une
section. Cela semble dépendre du nombre de titres de différents niveaux dans
le document. Dans ce cas les niveaux doivent être décalés pour garder les
mêmes niveaux que dans l'exemple de présentation (`##` devient `###`,...).
### Troisième niveau
Les titres de troisième niveau (avec `###`) se retrouvent en titre de bloc.
Comme vu précédemment s'il y a décalage ce sera le 4ème niveau qui sera titre
de bloc.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 109 KiB

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 928 KiB

View File

@ -13,7 +13,7 @@ header-includes:
### Détails ### Détails
#### Une petite dose de magie : Une petite dose de magie :
* Du Markdown * Du Markdown
* Un template LaTeX personnalisé (merci Adel) * Un template LaTeX personnalisé (merci Adel)
@ -21,7 +21,7 @@ header-includes:
* Beamer pour le rendu * Beamer pour le rendu
#### Les étapes 1 ### Les étapes 1
* Écrire un zoli texte * Écrire un zoli texte
@ -37,9 +37,9 @@ print(text)
--- ---
### Détails ## Comment faire une présentation Hadoly
#### Les étapes 2 ### Les étapes 2
* Enregistrer dans un fichier `prez.md` * Enregistrer dans un fichier `prez.md`
* Vérifié que latex, beamer, pandoc sont installés * Vérifié que latex, beamer, pandoc sont installés
@ -53,11 +53,9 @@ $ make
``` ```
# Conclusion # Conclusion
## La fin finale
### Résultat ## La fin finale
Nous avons une belle présentation personnalisée :) Nous avons une belle présentation personnalisée :)
@ -65,4 +63,8 @@ N'oublions pas que nous sommes un CHATON :
![chaton hadoly](chaton.png "Chaton Hadoly") ![chaton hadoly](chaton.png "Chaton Hadoly")
## Merci
@ bientôt

Binary file not shown.