p57, découvrir `pandoc`

[papier-crayon.git] / source / p57 / 548pandoc.rst

diff --git a/source/p57/548pandoc.rst b/source/p57/548pandoc.rst
new file mode 100644 (file)
index 0000000..ce0f635
--- /dev/null
+++ b/source/p57/548pandoc.rst
@@ -0,0 +1,59 @@
+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 ; 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)