Template remarkjs pour la charte graphique de l'école

h1. Introduction

Cette solution basée sur remark.js (https://github.com/gnab/remark) permet de réaliser des présentations très simplement avec uniquement un éditeur de texte. 

Le langage utilisé s'appelle le Markdown (https://fr.wikipedia.org/wiki/Markdown) : c'est un format avec un balisage léger qui permet d'enrichir du texte en le laissant lisible (comme le fichier "readme.md":https://redmine.telecom-bretagne.eu/projects/template-remarkjs/repository/revisions/master/raw/readme.md, présent dans ce répertoire, que vous pouvez ouvrir avec n'importe quel éditeur de texte).

h1. Mise en route rapide

Téléchargez l'archive `demo-chrome-safari-latest.zip` dans le répertoire "release":https://redmine.telecom-bretagne.eu/projects/template-remarkjs/repository/revisions/master/show/release, décompressez-la, modifiez le fichier `demo.html` et c'est tout !

Il est recommandé d'utiliser le navigateur Chrome pour simplifier l'export au format PDF en choisissant l'option `Imprimer au format PDF`.

Pour démarrer une présentation vierge remplacez le fichier `demo.html` par le fichier `imta-boilerplate-local.html`

h1. Avantages et inconvénients

Avantages :

- Il suffit d'avoir un éditeur de texte pour faire une présentation.

- On ne s'occupe pas **du tout** de la mise en forme, la charte est respectée à la lettre sans s'en préoccuper.

- On peut inclure des formules Latex pour faire des expressions mathématiques.

- Il n'y a pas besoin de compiler sa présentation, elle se visualise dans un navigateur web.

- Il est possible d'exporter simplement sa présentation en PDF avec le navigateur Chrome.

Inconvénients :

- Cela reste moins simple d'utilisation qu'un logiciel dédié comme Powerpoint ou LibreOffice Impress.

- Sans utiliser le navigateur Chrome, l'impression en PDF est plus complexe.

h1. Choix du navigateur

h2. Comparatif

- Le navigateur Chrome est recommandé car il permet l'export en PDF très simplement.

- Les navigateurs Safari et Opera permettent de respecter correctement la mise en page.

- Les navigateurs Firefox, Internet Explorer et Edge n'implémentent pas encore les dernières normes CSS, ainsi le titre sur la page de garde est aligné sur une colonne et non selon la diagonale (ce qui permet aux autres navigateurs d'afficher plus de texte).

h2. Impression sans navigateur sous Ubuntu

- Installez le logiciel [Decktape](https://github.com/astefanutti/decktape) et les librairies nécessaires.

- Installez python en version supérieure à 3.

- Dans le répertoire de votre présentation exécutez la commande <pre>python -m http.server</pre>

- Dans le répertoire de decktape exécutez la commande <pre>./phantomjs decktape.js automatic http://localhost:8000/demo.html#1 slides.pdf</pre> (changez l'url et le nom du fichier de sortie si nécessaire)

h1. Fonctionnalités

h2. Mode présentateur

Appuyez sur la touche `C` pour cloner votre fenêtre puis la touche `P` pour passer en mode présentateur. Le texte écrit dans vos transparents après la balise `???` sera affiché dans le mode présentateur

h2. Autres fonctionnalités supportées

Voir la documentation de [remark.js](https://github.com/gnab/remark).