Build docs against the latest jupyterlite-xeus-python (jupyter-widget…

…s-contrib#338)

* Build docs against the latest jupyterlite-xeus-python

* Missing comma

* Missing build dependencies

* Add workflow for rtd preview in PRs

.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
+ - ..