Découvrir et tester ``pandoc``
==============================

.. caution::
   Les essais permettent de vérifier et mémoriser

L’hôte ``www`` (``tjener``) fourni la solution ``pandoc``
---------------------------------------------------------

-  l’installation n’est pas nécessaire ! L’usage est possible
   directement.
- faire une recherche superficielle..., consulter ce `lien 
  <https://pandoc.org/>`__
- consulter ``man pandoc``
- vérifier ``pandoc --version``

L'usage via un ``alias``
------------------------

Créer ou ajuster l'alias ``panhtml``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- à l'aide de l'extrait d'écran de commandes suivant :

.. code:: console

   fred@tjener:~$ type panhtml 
   panhtml est un alias vers « pandoc --ascii -s -c /~fred/pandoc.css -t html5 -o ~/public_html/tmp/brouillon.html »


- créer le dossier ``tmp`` dans le dossier ``~/public_html``

.. code:: console

   mkdir ~/public_html/tmp

Récupérer et éventuellement personnaliser une copie de ``pandoc.css``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code:: console

   cd ~/public_html ; https_proxy=http://www:3128 wget https://pandoc.org/demo/pandoc.css

Fonctionnement envisagé de l'alias ``panhtml``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- éditer un ``fichier.md`` en respect du code `Markdown 
  <http://daringfireball.net/projects/markdown/>`__
- utiliser l'alias de la manière suivant :

.. code:: console

   panhtml fichier.md
   
- consulter le résultat à l'aide d'un client ``http``

.. seealso::
   Comparer ses résultats avec ceux des autres étudiant⋅es (sans être 
   trop bruillant⋅es)