WIP try jupyterlite-sphinx (not working)

Author: gilch

docs/conf.py

@@ -1,5 +1,5 @@
 # Adapted from Sphinx configuration template. Modifications
-# copyright 2019, 2020, 2021, 2022, 2023, 2024 Matthew Egan Odendahl
+# copyright 2019, 2020, 2021, 2022, 2023, 2024, 2025 Matthew Egan Odendahl
 # SPDX-License-Identifier: Apache-2.0 AND BSD-2-Clause
 
 # [https://github.com/sphinx-doc/sphinx/blob/v4.2.0/AUTHORS]
@@ -70,7 +70,9 @@
     "lissp_lexer",
     "lissp_directive",
     "sphinx.ext.viewcode",
+    "jupyterlite_sphinx",
 ]
+jupyterlite_silence = False
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
@@ -96,7 +98,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["_static"]
+# html_static_path = ["_static"]
 
 intersphinx_mapping = {"python": ("https://docs.python.org/3.10", None)}
 

docs/environment.yml

@@ -0,0 +1,8 @@
+name: jupyterlite-sphinx
+channels:
+  - https://repo.mamba.pm/emscripten-forge
+  - conda-forge
+dependencies:
+  - pip:
+      - ../setup/dist/hissp-0.5.dev1-py3-none-any.whl
+  - xeus-python

docs/index.rst

@@ -15,7 +15,13 @@ Jump in and try the `lissp_whirlwind_tour` first if you're feeling confident
 or already know Python or a Lisp dialect well.
 Otherwise, start with the easier, but less-comprehensive `primer`.
 
-.. TODO: add REPL via Brython or Pyodide?
+.. replite::
+   :kernel: pyodide
+   :new_tab: True
+   :new_tab_button_text: #> ;; Open Lissp REPL
+
+    print("Hello, World!")
+
 
 .. toctree::
    :maxdepth: 2

docs/requirements.txt

@@ -3,3 +3,4 @@
 # SPDX-License-Identifier: Apache-2.0
 sphinx==6.2.1
 furo==2023.03.27
+jupyterlite-sphinx==0.20.2