From: Fred LE MEUR <frederic.le-meur@ac-versailles.fr>
Date: Mon, 24 Nov 2025 14:53:18 +0000 (+0100)
Subject: p57, découvrir `pandoc`
X-Git-Url: https://fred1m.tech/gitweb/papier-crayon.git/commitdiff_plain/594eff5edc03b21e800c9d2717c10b9df3392545

p57, découvrir `pandoc`
---

diff --git a/source/p57/548pandoc.rst b/source/p57/548pandoc.rst
new file mode 100644
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)
diff --git a/source/p57/index.rst b/source/p57/index.rst
index fd87f28..f7d1663 100644
--- a/source/p57/index.rst
+++ b/source/p57/index.rst
@@ -11,6 +11,7 @@ Premier semestre, b1CLI
    542index
    545reprendre
    547patat
+   548pandoc
 
 Semaines 537-542
 ~~~~~~~~~~~~~~~~
@@ -24,8 +25,9 @@ Semaines 537-542
 -  ``https://www/~identifi``
 - :doc:`542index`
 
-Semaines 545-547
+Semaines 545-548
 ~~~~~~~~~~~~~~~~
 
 - :doc:`545reprendre`
 - :doc:`547patat`
+- :doc:`548pandoc`