diff --git a/documenter-son-projet-avec-sphinx.qmd b/documenter-son-projet-avec-sphinx.qmd index 7ac6b166565fdb9e82ecb64529167b0c180c4c6b..e61cf88d3c08b82774cb7117320419076c68810c 100644 --- a/documenter-son-projet-avec-sphinx.qmd +++ b/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