Bulldozc (Bonus)

Et si on faisait un petit programme pédagogique ? C'est l'objectif de Bulldozc, un programme que j'ai réalisé rien que pour vous, lecteur·ices de ce guide, bande de veinard·es !

Vous pouvez le télécharger en vous rendant sur cette page, le projet étant hébergé sur Framagit. Vous y trouverez les instructions pour l'installer (c'est un grand mot : il ne s'agit que d'un fichier .sh avec une petite interface).

Que fait ce petit programme ? il construit pour vous les pénibles commandes qu'autrement vous devriez passer dans le terminal ou construire une seule fois dans un fichier .sh. Il les exécute tout comme le fait Zettlr et ses options (ou Obsidian et ses extensions pour Pandoc) pour convertir vos documents.

L'idée ici n'est pas de vous expliquer comment Bulldozc fonctionne exactement, mais ses principes (cela dit, le code est ouvert, vous pouvez jeter un œil).

Rappelez-vous, nous avons vu comment fonctionne fondamentalement Pandoc, il s'agit de respecter la forme suivante :

pandoc monfichier.md -o monfichier.xx

… où xx est l'extension du fichier de sortie indiquant à Pandoc vers quel format il doit réaliser la conversion, bien qu'il vous soit possible l'expliciter, ainsi :

pandoc -f markdown -t html monfichier.md -o monfichier.html

… où -f indique le format d'entrée (from) et -t indique le format de sortie (to).

Partant de ce principe, nous avons vu, à travers tout ce guide, comment ajouter des options et des fichiers « ressources » pour convertir nos documents :

  • --css=monfichier.css : pour utiliser des styles CSS (lorsqu'on convertit vers HTML, par exemple),
  • --csl=monfichier.csl : pour utiliser des styles CSL pour la bibliographie,
  • citeproc : pour utiliser un moteur de rendu pour la bibliographie,
  • --bibliography=monfichier.bib : pour utiliser un fichier de références bibliographiques,
  • --reference-doc=monmodeledereference : pour utiliser un modèle de stylistique de document (par exemple lorsqu'on converti vers ODT),
  • --template=montemplate : pour spécifier un modèle de structure de document,
  • utiliser soit LibreOffice (sans l'ouvrir) soit (xe)LaTeX pour convertir en PDF,
  • et surtout construire un entête YAML correct pour donner les bonnes instructions (en plus de répertorier votre document, lui donner des mots-clés, relier vos connaissances…)

Or, lorsqu'on a la mémoire courte (ou qu'on ne désire pas apprendre ces commandes par cœur), il peut être plus confortable d'avoir une petite béquille mentale pour ne pas quitter son travail et surfer sur Internet à la recherche de la bonne combinaison de commandes.

Ce que Bulldozc fait, c'est construire pour vous les commandes en fonction de ce que vous choisissez de faire via un menu interactif. C'est simple. Vous choisissez le fichier d'entrée, le fichier et le format de sortie, vous indiquez les bons fichiers ressource à utiliser et c'est parti.

À vous de jouer.