Build docs against the latest jupyterlite-xeus-python (#338)

* Build docs against the latest jupyterlite-xeus-python

* Missing comma

* Missing build dependencies

* Add workflow for rtd preview in PRs

Author: martinRenou

.github/workflows/rtd_preview.yml

@@ -0,0 +1,24 @@
+name: RTD Preview
+on:
+  pull_request_target:
+    types: [opened]
+
+permissions:
+  pull-requests: write
+
+jobs:
+  binder:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Comment on the PR with the RTD preview
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{secrets.GITHUB_TOKEN}}
+          script: |
+            var PR_NUMBER = context.issue.number
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `[![lite-badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://ipycanvas--${PR_NUMBER}.org.readthedocs.build/en/${PR_NUMBER}/lite/lab/index.html) :point_left: Try it on ReadTheDocs with JupyterLite!`
+            })

.readthedocs.yaml

@@ -6,4 +6,4 @@ build:
     python: "mambaforge-4.10"
 
 conda:
-  environment: docs/environment.yml
+  environment: docs/build-environment.yml

docs/build-environment.yml

@@ -0,0 +1,15 @@
+name: ipycanvas-docs
+
+channels:
+  - conda-forge
+
+dependencies:
+  - ipycanvas
+  - mamba
+  # This is needed for building ipycanvas from source for the emscripten env
+  - yarn
+  # Docs requirements
+  - pydata-sphinx-theme
+  - jupyterlite-sphinx
+  - jupyterlite-xeus-python >=0.9.2,<0.10
+  - jupyterlab-night

docs/conf.py

@@ -1,7 +1,6 @@
 # -*- coding: utf-8 -*-
 extensions = ["sphinx.ext.autodoc", "sphinx.ext.napoleon", "jupyterlite_sphinx"]
 
-jupyterlite_config = "jupyterlite_config.json"
 jupyterlite_dir = "."
 
 master_doc = "index"

docs/environment.yml

@@ -1,16 +1,10 @@
-name: xeus-python-kernel-docs
-
+name: ipycanvas
 channels:
-  - conda-forge
-
+  - https://repo.mamba.pm/emscripten-forge
+  - https://repo.mamba.pm/conda-forge
 dependencies:
-  - ipycanvas
-  - mamba
-  - pydata-sphinx-theme
-  - empack
-
+  - pillow
+  - numpy
+  - ipywidgets
   - pip:
-    - jupyterlite
-    - jupyterlite-sphinx
-    - jupyterlite-xeus-python
-    - jupyterlab-night
+    - ..