Principes de base
Les classes
Lorsqu’on travaille avec LaTeX, on doit d’abord déclarer une classe de document. Avec Markdown, pour la production de documents pdf, on va faire cette déclaration dans l’en-tête YAML avec la commande :
documentclass: classe
Les principales classes possibles (sans les variantes) sont :
- article (la classe par défaut)
- report
- book
- letter (non décrit dans le manuel)
- beamer (pour créer des diaporama, voir plus loin)
Les paquets
Après avoir déclaré une classe, on peut modifier les fonctionnalités de LaTeX en ajoutant un ou plusieurs packages (ou “paquets”).
Avec Markdow, toujours dans l’en-tête YAML, on appelle ces paquets avec la commande :
\header-includes:
et, par exemple, pour modifier la langue du document :
\usepackage[french]{babel}
Les paquets peuvent :
- modifier la façon dont certaines parties de LaTeX fonctionnent ;
- changer l’apparence du document ;
- ajouter de nouvelles commandes qui seront utilisables par la suite dans la rédaction.
De nombreux exemples d’utilisation des paquets sont présentés dans les pages suivantes.
Les formats
Dans l’en-tête d’un document LaTeX (l’en-tête YAML pour un fichier Markdown), on va également définir certaines caractéristiques comme le format de la page (geometry:), la taille des caractères (fontsize:), la présence ou non d’une table des matières (toc:) ou la numérotation de titres (numbersections:).
Les Métadonnées
Dans l’en-tête YAML on va enfin ajouter les métadonnées (title, autor, keywords…).
Certaines de ces métadonnées apparaissent en en-tête du document pdf produit. Elles sont également utilisées pour les autres types de documents générés avec Pandoc (ePub, html…).
Les Templates
Il est aussi possible de se servir d’un templatehttps://www.overleaf.com/latex/templates[/footnote] (modèle) qui sera appelé lors de la transformation avec Pandoc (–template=montemplate.tex).
