L1 Info : Informatique et Document, MarkDown & Pandoc
 
◃  Ch. 2 Pandoc  ▹
 

Réalisation d'un template élémentaire HTML5

  • Fichier monTemplate.html :
    <!DOCTYPE html>
    <html xmlns="http://www.w3.org/1999/xhtml" lang="$lang$" xml:lang="$lang$">
    <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
    <title>$pagetitle$</title>
    $for(css)$
    <link rel="stylesheet" href="$css$" />
    $endfor$
    </head>
    <body>
    $body$
    </body>
    </html>
  • Variables disponibles :
    • $lang$ pour indiquer la langue du document,
    • $pagetitle$ pour renseigner le contenu de l'élément title,
    • $css$ pour préciser les noms de fichiers CSS,
    • $body$ pour le contenu principal.
  • L'option --template indique le fichier template à utiliser lors de la conversion et la production du document standalone.
  • Exemple :
    pandoc -f commonmark -t html -s 
    --template chemin/monTemplate.html 
    --metadata pagetitle="mon propre title" 
    --metadata lang="fr" pandoc1.md
  • La variable $css$ n'étant pas renseignée, aucun lien vers un fichier css ne sera produit.
  • Fichier pandoc1.md
# Pandoc: a universal document converter
+ Convertisseur de documents numériques
+ Logiciel libre créé par John MacFarlane
+ Programme en ligne de commande disponible sur la plupart des OS
+ Nombre impressionnant de formats de documents gérés : Markdown, HTML, LaTeX, OpenDocument XML, docx, odt, ...
  • Résultat produit :
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head>
  <meta charset="utf-8" />
  <meta name="generator" content="pandoc" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
  <title>mon propre title</title>
  </head>
<body>
<h1>Pandoc: a universal document converter</h1>
<ul>
<li>Convertisseur de documents numériques</li>
<li>Logiciel libre créé par John MacFarlane</li>
<li>Programme en ligne de commande disponible sur la plupart des OS</li>
<li>Nombre impressionnant de formats de documents gérés : Markdown, HTML, LaTeX, OpenDocument XML, docx, odt, ...</li>
</ul>
</body>
</html>