Installer Pandoc

1. Installation en deux étapes

Il faut d’abord installer Pandoc et, si on souhaite pouvoir convertir vers le format PDF, il faut installer un moteur latex. Le projet Pandoc suggérant d’utiliser Miktext.

2. Conversion

Une des manières de procéder est de préciser le chemin complet vers le fichier pdflatex.exe

pandoc -s \ --latex-engine='C:\Christophe\tools\pandoc\miktex\miktex\bin\x64\pdflatex.exe' \ -f markdown_github -t latex \ "my-file.md" -o "my-file.pdf"

Sinon, ajouter C:\Christophe\tools\pandoc\miktex\miktex\bin\x64\ dans le §PATH de Windows afin que l’exécutable pdflatex.exe soit accessible.

3. MiKTex Package Manager

Le manager est accessible en exécutant le programme mpm.exe depuis le command prompt (le chemin complet est C:\Christophe\tools\pandoc\miktex\miktex\bin\x64\mpm.exe). Afin de correctement configurer les mises-à-jour et l’endroit où aller chercher les paquets, cliquez sur

  1. le menu Repository
  2. puis sur Change Package Repository
  3. choisir “Packagesd shall be installed from the Internet” et,
  4. choisir un site de référence (peut-être privilégier un site disponible en FTP)

Pour mettre à jour : Repository -> Synchronize

3.1. Pour tester la conversion

En ligne de commande, tester p.ex.

pandoc -s -o test.pdf test.md

afin de convertir le fichier test.md vers test.pdf

Si tout est correctement installé, le fichier test.pdf sera généré, sinon, des messsages d’erreur peuvent apparaître.

3.1.1. MiKTex & Proxy

En démarrant l’application MiKTeX Update (C:\Christophe\tools\pandoc\miktex\miktex/bin/x64/internal\miktex-update.exe), il est possible de définir le proxy à utiliser.

Août 2017 : le proxy peut-être défini sur http://tmgproxy.yourict.net:8080/

3.1.2. LaTeX Error: File xxx.sty not found

Si une telle erreur se produit, lancer en ligne de commande le programme mpm.exe pour exécuter le MiKTex Package Manager. Une fois l’écran chargé, retrouver le fichier qui était mentionné comme manquant dans le message d’erreur (p.ex. url.sty), faire un clic droit sur cet élément pour l’installer.

Erroneous variable \c___fontspec_shape_n_n_tl used!

Si une erreur telle que celle ci-dessous se produit, réinstaller MiKText

Lancer Update MiKTex (Admin) et il sera peut-être nécessaire de le faire plusieurs fois car la mise-à-jour de certains packages est exclusive.

Update MiKTex (Admin)Sélection des packages