Statium Blog
[  Christophe Masutti  ]
   

Lettres et articles avec Zettlr ou Pandoc

☙  Posté le 11-04-2021  (modifié le 16-04-2021)  | ⏱ 4 minutes  | ✏ 697 mots  | ✍ Christophe Masutti

title: “Le titre” date: “17 février 2021” author: “Prénom Nom” …


Ainsi, pandoc les interprétera et, en utilisant un modèle par défaut ou un modèle de votre cru, reportera ces variables aux emplacements voulus dans la mise en page.

Si vous voulez écrire un article académique et le sortir en PDF en utilisant pandoc qui lui-même utilisera LaTeX, il vous faut donc réunir les éléments suivants :

- un modèle LaTeX (ou se contenter des modèles LaTEX par défaut de pandoc),
- des métadonnées à entrer après s'être bien renseigné sur la manuel d'utilisation de pandoc,
- un fichier de bibliographie,
- un fichier de style de présentation de la bibliographie.

En comptant les options courantes de pandoc que vous souhaitez utiliser, vous risquez de vous retrouver avec une ligne de commande assez longue… pour éviter cela, vous pouvez automatiser le tout avec un ``makefile`` que vous pourrez réutiliser plus tard pour d'autres documents, mais bigre… cela commence à devenir bien complexe pour qui n'a pas forcément envie d'y passer trop de temps, à moins de concevoir une fois pour toute une chaîne éditoriale que vous adapterez au fil du temps (c'est une option).


## Zettlr et les modèles

Un grand avantage de Zettlr est de vous décharger de plusieurs de ces contraintes, en plus d'offrir une interface vraiment pratique entièrement destinée à l'écriture. Pour réaliser des exports, il vous faudra seulement installer pandoc. Et pour réaliser des exports PDF, il vous faudra installer LaTeX (je préconise une installation complète, par exemple ``Texlive-full``).

Le fichier et le [style CSL](https://citationstyles.org/) de bibliographie ? il vous suffit de les renseigner dans les préférences de Zettlr une fois pour toutes.

Le modèle de sortie PDF ? idem, vous le renseignez dans les préférences d'export PDF.

Et pour exporter ? il vous suffira de cliquer sur l'icône PDF.

Tout cela demeure assez simple, sauf que si vous rédigez un article sans chercher à travailler la question des métadonnées, votre sortie PDF risque de vous décevoir : pandoc utilisera le modèle par défaut, c'est-à-dire la classe ``[article]``de LaTeX, qui en soi est une excellente mise en page, mais ne colle pas forcément à vos souhaits.

Réaliser des modèles pour pandoc est chose assez facile. En effet, si vous comprenez des notions informatiques basiques comme « pour...si...ou...alors », la [syntaxe des modèles pandoc](https://pandoc.org/MANUAL.html#template-syntax) ne posera guère de problème. Il faudra néanmoins maîtriser LaTeX si vous voulez créer un modèle LaTeX.


### Mes modèles article, rapport et lettre

Pour vous éviter d'y passer trop de temps, je vous propose d'utiliser mes modèles élaboré pour des articles, des rapports ou des lettres simples.

J'ai pris le parti de réaliser un modèle LaTeX destiné à chaque fois à la sortie voulue, là où le modèle pandoc par défaut permet de créer un article, une présentation ou un livre en indiquant simplement la classe voulue. Ce modèle par défaut inclu donc de nombreuses variables mais à trop vouloir être généraliste, je pense qu'on loupe l'essentiel. 

Pour utiliser mes modèles, il vous suffit de réutiliser les fichiers markdown renseigner les différents éléments présents dans les en-têtes YAML de ces fichiers. Si vous voulez modifier les modèles eux-mêmes, il vous suffit de les éditer : j'ai tâché de commenter et de bien séparer les éléments importants.

Ces modèles utilisent KOMA-script, la classe ``scrartcl`` pour les article, ``scrreprt`` pour les rapports et ``scrlttr2`` pour les lettres. Si vous connaissez LaTeX, vous comprendrez que KOMA-script est un  excellent choix pour des documents européens (il fut créé au départ pour des documents de langue allemande, mais il fut rapidement adapté à différentes pratiques d'écriture, dont le Français).

Pour résumer très simplement :

- si vous écrivez une lettre, renseignez dans Zettlr le chemin vers le modèle dans les préférences d'export PDF,
- si vous écrivez un article ou un rapport, renseignez dans Zettlr le chemin vers le modèle dans les préférences d'export PDF et notez que le modèle utilise les styles CSL pour la bibliographie (pas de biblatex ou de natbib, donc),
- si vous ne voulez pas utiliser Zettlr, et uniquement pandoc, je vous ai indiqué dans le ``README`` les lignes de commande à utiliser (ce sont celles qu'utilise Zettlr, en fait).

Vous trouverez l'ensemble sur [ce dépôt GIT](https://framagit.org/Framatophe/modeles-pandoc-zettlr).