# 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

## Dépendances

Le template LaTex utilise les packages suivants :

- textpos
- etoolbox

## 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 :

```
---
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, un 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.