{"id":242,"date":"2023-04-08T18:03:12","date_gmt":"2023-04-08T16:03:12","guid":{"rendered":"https:\/\/e-publish.uliege.be\/md\/?post_type=chapter&p=242"},"modified":"2025-04-25T10:15:33","modified_gmt":"2025-04-25T08:15:33","slug":"yaml","status":"publish","type":"chapter","link":"https:\/\/e-publish.uliege.be\/md\/chapter\/yaml\/","title":{"raw":"YAML","rendered":"YAML"},"content":{"raw":"
\r\n\r\n<\/a>Pour rappel, Pandoc<\/em> prend en charge les en-t\u00eates YAML<\/em> pour les fichiers Markdown<\/em>. Cet acronyme n\u2019est pas simple \u00e0 traduire, il vient de YAML Ain\u2019t Markup Language<\/em> telle que le d\u00e9finit le site yaml.org[footnote]https:\/\/yaml.org\/spec\/1.2.2\/<\/a>[\/footnote].\r\n\r\nCi-dessous un exemple d\u2019en-t\u00eate YAML<\/em> plus complet avec une s\u00e9rie d\u2019instructions pour la mise en forme<\/strong> et les m\u00e9tadonn\u00e9es<\/strong> du document produit (ici pdf<\/em>).\r\n\r\nL'en-t\u00eate YAML est pr\u00e9c\u00e9d\u00e9e et suivie de trois tirets simples :\r\n
\r\n\r\n-\u00a0 - -\r\n\r\n# format du document\r\n\r\ndocumentclass: article\r\nheader-includes:\r\n- \\usepackage[french]{babel}\r\n- \\usepackage[utf8]{inputenc}\r\ngeometry:\r\n- left=2.5cm\r\n- right=2.5cm\r\n- top=2.5cm\r\n- bottom=2.5cm\r\n- a4paper\r\nlinestretch: 1\r\nfontsize: 11pt\r\ntoc: false\r\ntoc_depth:\r\nnumbersections: false\r\n\r\n# m\u00e9tadonn\u00e9es\r\n\r\ntitle: Titre du document\r\nsubtitle: Sous-titre du document\r\nauthor: Non, Pr\u00e9nom\r\naffiliation: ULi\u00e8ge\r\ndate: 2021 (cc-by)\r\nabstract: Ce court document est destin\u00e9 \u00e0 d\u00e9montrer les possibilit\u00e9s de *Markdown* ...\r\nkeywords: Markdown, r\u00e9diger\r\nsubject: \u00e9criture num\u00e9rique ouverte\r\nModified: 9 d\u00e9cembre 2021\r\nright: CC-BY 0.4\r\n\r\n# bibliographie\r\n\r\nbibliography: library.bib\r\ncsl: apa.csl\r\n\r\n# liens\r\n\r\nlinks-as-notes: true\r\nlinkcolor: blue\r\nlinkcolor: green\r\n\r\n- - -\r\n\r\n<\/div>\r\nPour la rendre plus lisible, il est possible d\u2019ins\u00e9rer (comme ci-dessus) des commentaires dans l\u2019en-t\u00eate YAML<\/em>.\r\n
\r\n

Page<\/h1>\r\ndocumentclass:<\/strong> avec book<\/em> ou report<\/em> ou article<\/em> (et \u00e9galement chapter<\/em> ou part<\/em>).\r\n\r\nLa mise en forme sera diff\u00e9rente pour ces diff\u00e9rents types.\r\n\r\nheader-includes:<\/strong> une s\u00e9rie de commandes directes LaTeX<\/em>.\r\n\r\nDans l\u2019exemple ci-dessus , l'instruction \\usepackage[french]{babel}<\/code><\/strong> va franciser la mise en forme (par exemple : \u201cTable des mati\u00e8res\u201d au lieu de \u201cContents\u201d ou des tirets longs au lieu de bulets dans les listes), l'instruction \\usepackage[utf8]{inputenc}<\/code><\/strong> va pr\u00e9ciser le code de caract\u00e8res utilis\u00e9 (ici UTF8).\r\n\r\nIl est possible d\u2019ajouter de nombreuses options dans header-includes<\/em> via des packages LaTeX<\/em> voir \u201cpour aller plus loin\u201d dans le chapitre \"sources\".\r\n\r\nLa ligne suivante va formater la page (geometry:<\/strong><\/em>). On peut ajouter landscape<\/em> \u00e0 la suite des quatre marges pour produire un document au format \u201cpaysage\u201d.\r\n\r\nlinestretch:<\/strong> permet, si n\u00e9cessaire, de r\u00e9gler l\u2019interligne (1 est la valeur par d\u00e9faut).\r\n

Colonnes<\/h1>\r\nL\u2019utilisation, dans l\u2019en-t\u00eate, de :\r\n
classoption: twocolumn<\/div>\r\nva provoquer l\u2019affichage en deux colonnes de tout le document. Si vous souhaitez ne mettre en deux colonnes qu\u2019une partie du document, ajoutez dans l\u2019en-t\u00eate YAML<\/em>, dans la section header-includes:<\/strong>\r\n
- \\usepackage{multicol}<\/div>\r\net encadrer la partie du document \u00e0 mettre en colonnes (ici deux) avec :\r\n
\\begin{multicols}{2}<\/code><\/strong><\/pre>\r\net :\r\n
\\end{multicols}<\/code><\/strong><\/pre>\r\n<\/div>\r\n
\r\n
En-t\u00eate et pied de pages<\/h1>\r\nPour ajoutez des en-t\u00eates et pieds de page dans le document, il faut compl\u00e9ter l\u2019en-t\u00eate YAML<\/em>, dans la section header-includes:<\/strong>, avec :\r\n
- \\usepackage{lastpage}\r\n- \\usepackage{fancyhdr}\r\n- \\pagestyle{fancy}\r\n- \\fancyhead[L]{texte en haut et \u00e0 gauche}\r\n- \\fancyhead[C]{texte en haut et au centre}\r\n- \\fancyhead[R]{texte en haut et \u00e0 droite}\r\n- \\fancyfoot[L]{texte en bas et \u00e0 gauche}\r\n- \\fancyfoot[C]{texte en bas au centre}\r\n- \\fancyfoot[R]{Page \\thepage \\hspace{1pt}\/ \\pageref{LastPage}}<\/div>\r\nAvec cet exemple, dans le bas de la page, vous verrez appara\u00eetre \u00e0 droite le num\u00e9ro de la page, suivi du nombre de pages du document. Si vous n'ajoutez pas la ligne - \\fancyhead[L]{}<\/strong>, fancy<\/em> ajoutera, en haut, \u00e0 gauche, un titre courant \u00e0 la page (le premier titre de niveau 2). Le comportement est le m\u00eame pour la zone en haut, \u00e0 droite, pour le titre de niveau 1.\r\n\r\n<\/div>\r\n
\r\n
Caract\u00e8res<\/h1>\r\nfontsize:<\/strong> la taille des caract\u00e8res = 10, 11 ou 12pt.\r\n\r\nIl est possible d\u2019avoir d\u2019autres tailles, 8, 9, 14, 17 ou 20pt, apr\u00e8s avoir remplac\u00e9 article<\/em><\/strong> par extarticle<\/em><\/strong> dans \u201cdocumentclass\u201d.\r\n\r\nM\u00eame si la police de caract\u00e8res par d\u00e9faut (lmodern) fait tr\u00e8s \u201cpro\u201d, LaTeX<\/em> propose plusieurs autres polices pour la cr\u00e9ation des documents pdf.\r\n\r\nIci encore, ce sera directement via une instruction dans l\u2019en-t\u00eate YAML<\/em>. Voici quelques polices \u00e0 tester (en ajoutant - \\usepackage{nom_de_la_police}<\/strong> dans la section header-includes:<\/strong>) :\r\n