From bac595001e0bb45f594a5dd9a7e3b58c6efe94b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fran=C3=A7oise=20Conil?= <francoise.conil@insa-lyon.fr>
Date: Fri, 19 Apr 2024 11:31:23 +0200
Subject: [PATCH] =?UTF-8?q?=C3=89vocation=20et=20test=20de=20l'extension?=
 =?UTF-8?q?=20Hieroglyph?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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 | 40 +++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/documenter-son-projet-avec-sphinx.qmd b/documenter-son-projet-avec-sphinx.qmd
index 7ac6b16..e61cf88 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
-- 
GitLab