Évocation et test de l'extension Hieroglyph

L'extension Hieroglyph permettait de créer des slides avec Sphinx mais
elle n'a plus évolué depuis 4 ans et ne fonctionne plus.
Existe-t-il un fork, une alternative ?

documenter-son-projet-avec-sphinx.qmd

@@ -1289,6 +1289,46 @@ Bob <- Alice : Yet another authentication Response
 Bon le rendu n'est pas encore convainquant, mais un jour ...
 :::
 
+## Hieroglyph : slides
+
+::: {.callout-warning}
+En 2012, l'extension [Hieroglyph](https://hieroglyph.readthedocs.io/en/latest/getting-started.html)
+permettait de créer des slides HTML en reStructuredText avec HTML.
+Malheureusement, le dernier commit date de 2020-07-04 ^[Voir le [dépôt Hieroglyph](https://github.com/nyergler/hieroglyph), 
+la documentation fait encore référence à `easy_install`] 
+^[`README.rst` : Included slide CSS and JavaScript originally based on [HTML 5 Slides](http://code.google.com/p/html5slides/) 
+and [io-2012-slides](https://code.google.com/p/io-2012-slides/) projects => projets sur `code.google.com` (archive)]
+et la génération des slides déclenche une exception Jinja et un warning Sphinx. 
+:::
+
+```{.bash}
+$ pip install hieroglyph
+$ mkdir my-hieroglyph-slides
+$ cd my-hieroglyph-slides
+$ hieroglyph-quickstart
+$ make slides
+    Running Sphinx v7.2.6
+    ...
+    done
+    /home/fconil/Progs/python/sphinx/.venv/lib/python3.10/site-packages/hieroglyph/builder.py:126: RemovedInSphinx80Warning: Sphinx 8 will drop support for representing paths as strings. Use "pathlib.Path" or "os.fspath" instead.
+      doctree.attributes.get('source')[len(self.srcdir) + 1:].count('/')
+    generating indices... genindex failed
+    Theme error:
+    An error happened in rendering the page genindex.
+    Reason: UndefinedError("'style' is undefined")
+    make: *** [Makefile:20: slides] Error 2
+```
+
+::: {.notes}
+Déclarer l'extension dans le fichier `conf.py`
+
+```{.python}
+extensions = ['hieroglyph']
+```
+
+Voir ~/PyEnvs-a-trier/PyEnv2.7.6/sphinx-hieroglyph
+:::
+
 # Thèmes HTML pour Sphinx
 
 ## Options de configuration de la sortie HTML