=========================================
Installation de LaTeX et de la *template*
=========================================
.. note::
La procédure peut ne pas fonctionner sous Windows (probable) et macOS (moins probable), où elle n'a pas été testée.
N'hésitez pas à faire des retours sur `forum des Devs' de Zeste de Savoir `_.
Afin de générer des PDFs, `zmarkdown `_ est capable de générer du code LaTeX via un plugin nommé `rebber `_.
Une fois le code généré, il est nécessaire de le compiler, donc d'installer deux composants:
+ Un compilateur LaTeX (en fait, c'est LuaLaTeX qui est employé, mais peu importe ici) ;
+ La *template*, qui permet, entre autres choses, la mise en forme du document (couleurs, page de garde, blocs ...). Celle-ci est située dans un `dépot séparé (en) `_, où vous trouverez plus d'informations.
Prérequis
---------
Avant toutes choses, vous devez installer les parties suivantes (peu importe votre système d'exploitation):
+ Les polices `Source Code Pro `_ et `Source Sans Pro `_. Une fois téléchargées et décompressées, le programme permetant de visualiser les polices sur votre système d'exploitation propose généralement un bouton d'installation. Sous Linux, vous pouvez simplement employer `ce script `_.
+ Le package `Pygments `_: vous pouvez l'installer via ``pip`` (``pip install Pygments``, peu importe l'OS) ou via le gestionnaire de package de votre distribution (Linux et macOS). Notez que c'est également une dépendance de ZdS, donc il est déjà installé dans le *virtualenv*.
+ (*optionnel*, Linux seulement) Pour utiliser des formats d'images tels que le GIF ou le SVG, deux outils supplémentaires sont nécessaires: `librsvg `_ (souvent disponible sous le nom ``librsvg2-bin`` dans votre gestionnaire de paquets) et `imagemagick `_ (probablement disponible via le package du même nom).
Installer une distribution LaTeX
--------------------------------
+ Sous Windows, vous pouvez installer `MikTeX `_ ou `TexLive `_.
+ Sous macOS, vous pouvez installer `MacTex `_.
+ Sous Linux, vous pouvez utiliser `TexLive `_ (qui est probablement disponible dans votre gestionnaire de paquet). Notez que si vous êtes à l'aise, vous pouvez également installer une version allégée, `comme c'est fait ici `_ ou `dans le script d'installation automatisé <./install-linux.html#composant-tex-local-et-latex-template>`_.
Si vous n'êtes pas famillier avec LaTeX, choisissez d'installer la version **complète**.
La liste des packages nécessaire `est disponible ici `_, mais n'est peut être pas exhaustive.
Installer la *template*
-----------------------
Vous pouvez `télécharger l'archive `_ et en décompresser le contenu (ou alors cloner le dépot) dans ``/tex/latex``, où la valeur de ```` peut être obtenue en entrant la commande suivante:
.. sourcecode:: bash
kpsewhich -var-value TEXMFHOME
et ce **quelque soit votre système d'exploitation** (ou la distribution installée).
Créez les sous dossiers ``tex`` puis ``latex`` si ce n'est pas le cas.
Notez que l'utilisation de ``texhash`` n'est pas nécessaire.