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

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

Avec Chrome, Safari ou Opera :

- Téléchargez l'archive "demo-chrome-safari-latest.zip":https://redmine.telecom-bretagne.eu/projects/template-remarkjs/repository/revisions/master/raw/release/demo-chrome-safari-opera-latest.zip dans le répertoire "release":https://redmine.telecom-bretagne.eu/projects/template-remarkjs/repository/revisions/master/show/release

Avec Firefox, Internet Explorer ou Edge :

- Téléchargez l'archive "demo-firefox-ie-edge-latest.zip":https://redmine.telecom-bretagne.eu/projects/template-remarkjs/repository/revisions/master/raw/release/demo-firefox-ie-edge-latest.zip dans le répertoire "release":https://redmine.telecom-bretagne.eu/projects/template-remarkjs/repository/revisions/master/raw/release

Décompressez l'archive, modifiez le fichier `demo.html` et c'est tout !

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.

- La pagination et la numération n'est pas automatique comme sous Latex.

- Les formules Latex nécessitent par défaut une connexion internet, sinon une petite manipulation est à faire (voir en bas de page).

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. Formules mathématiques en mode déconnecté

Le script MathJax est utilisé pour générer les formules mathématiques sur le document HTML. Inconvénient : il faut être connecté à internet pour que cela fonctionne avec la version actuelle.

En mode déconnecté, le PDF fonctionnera parfaitement, mais si vous désirez produire un document dans l'avion ou le train il faudra récupérer les librairies MathJax en suivant ce "lien"(https://github.com/mathjax/MathJax/archive/2.7.1.zip), dézipper l'archive et remplacer la ligne :

<pre>

<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js" type="text/javascript"></script>

</pre>

par :

<pre>

<script src="lien_local_vers_repertoire_Mathjax/MathJax.js" type="text/javascript"></script>

</pre>

h2. Autres fonctionnalités supportées

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