Générer les PDFs

Le générateur de PDFs/EPUBs s'appuie sur pdc-gen.sh (https://github.com/ResponSySS/pdc-gen) pour générer récursivement les fichiers PDF/EPUB/etc. correpondants aux fichiers MD trouvés grâce à find et pandoc.

Quelques règles pour que cela fonctionne bien:

• éviter les blocks HTML
• pas de caractères Unicode chelous (accents, caractères avec accents, 'ç', etc.)

Utilisation

Pour faciliter l'utlisation de pdc-gen.sh, une Makefile a été créée dans le dossier racine du site (/Makefile).
Voir $ make help.

Table des matières

Peut être générée si toc: true et lang: fr sont précisés dans le header YAML.

Attention : ne pas utiliser des chemins absolus !

Comme on se sert des fichiers MD pour générer à la fois une page web (jekyll) et un PDF/EPUB (pandoc), les chemins d'accès doivent être valides pour les deux environnement (serveur distant où sera publié le site et système local où seront générés les PDFs/EPUBs).
Cela implique donc de ne pas utiliser des chemins comme /textes/la-guerre-sociale/misere-du-feminisme/img1.jpg. Car, s'il est valide pour le serveur web et jekyll, il n'est pas valide pour pandoc puisque cela revient à dire que l'image se trouve dans un dossier du système local qui s'appelerait /textes/la-guerre-sociale/.