Iterate on the docs and the jupyterlite build

Author: martinRenou

Diff for: docs/build-environment.yml

@@ -0,0 +1,19 @@
+name: ipyopenlayers-docs
+
+channels:
+  - conda-forge
+
+dependencies:
+  - yarn~=3.0
+  - jupyterlab~=4.0
+  - jupyter-packaging~=0.12
+  - jupyter-sphinx
+  - build
+  - branca
+  - hatch
+  - pydata-sphinx-theme
+  - sphinx
+  - jupyterlite-sphinx
+  - jupyterlite-xeus
+  - pip:
+      - ..

Diff for: lite_build_output/environment.yml renamed to docs/environment.yml

@@ -3,9 +3,8 @@ channels:
   - https://repo.mamba.pm/emscripten-forge
   - conda-forge
 dependencies:
-  - xeus-python=0.15.10
-  - python=3.11
+  - xeus-python
   - ipywidgets
   - traitlets
   - pip:
-    - ipyopenlayers
+    - ..

Diff for: docs/source/conf.py

@@ -31,6 +31,7 @@
     'nbsphinx',
     'jupyter_sphinx',
     'nbsphinx_link',
+    'jupyterlite-sphinx',
 ]
 
 # Set the nbsphinx JS path to empty to avoid showing twice of the widgets
@@ -188,11 +189,6 @@
 # docs.readthedocs.org
 on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
 
-if not on_rtd:  # only import and set the theme if we're building docs locally
-    import sphinx_rtd_theme
-    html_theme = 'sphinx_rtd_theme'
-    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
-
 # otherwise, readthedocs.org uses their theme by default, so no need to specify it
 
 
@@ -211,3 +207,10 @@ def add_scripts(app):
                 logger.warning('missing javascript file: %s' % fname)
             app.add_js_file(fname)
     app.connect('builder-inited', add_scripts)
+
+jupyterlite_dir = "."
+jupyterlite_contents = ["../examples/*"]
+
+html_theme = "pydata_sphinx_theme"
+htmlhelp_basename = "ipyopenlayersdoc"
+html_static_path = ["_static"]