source/p57/548pandoc.rst

   1 Découvrir et tester ``pandoc``
   2 ==============================
   3
   4 .. caution::
   5    Les essais permettent de vérifier et mémoriser
   6
   7 L’hôte ``www`` (``tjener``) fourni la solution ``pandoc``
   8 ---------------------------------------------------------
   9
  10 -  l’installation n’est pas nécessaire ! L’usage est possible
  11    directement.
  12 - faire une recherche superficielle..., consulter ce `lien
  13   <https://pandoc.org/>`__
  14 - consulter ``man pandoc``
  15 - vérifier ``pandoc --version``
  16
  17 L'usage via un ``alias``
  18 ------------------------
  19
  20 Créer ou ajuster l'alias ``panhtml``
  21 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  22
  23 - à l'aide de l'extrait d'écran de commandes suivant :
  24
  25 .. code:: console
  26
  27    fred@tjener:~$ type panhtml
  28    panhtml est un alias vers « pandoc --ascii -s -c /~fred/pandoc.css -t html5 -o ~/public_html/tmp/brouillon.html »
  29
  30
  31 - créer le dossier ``tmp`` dans le dossier ``~/public_html``
  32
  33 .. code:: console
  34
  35    mkdir ~/public_html/tmp
  36
  37 Récupérer et éventuellement personnaliser une copie de ``pandoc.css``
  38 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  39
  40 .. code:: console
  41
  42    cd ~/public_html ; https_proxy=http://www:3128 wget https://pandoc.org/demo/pandoc.css
  43
  44 Fonctionnement envisagé de l'alias ``panhtml``
  45 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  46
  47 - éditer un ``fichier.md`` en respect du code `Markdown
  48   <http://daringfireball.net/projects/markdown/>`__
  49 - utiliser l'alias de la manière suivant :
  50
  51 .. code:: console
  52
  53    panhtml fichier.md
  54
  55 - consulter le résultat à l'aide d'un client ``http``
  56
  57 .. seealso::
  58    Comparer ses résultats avec ceux des autres étudiant⋅es (sans être
  59    trop bruillant⋅es)