Deploy previews on RTD

Author: jtpio

.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://jupyterlab-hybrid-kernels--${PR_NUMBER}.org.readthedocs.build/en/${PR_NUMBER}) :point_left: Try it on ReadTheDocs`
+            })

.gitignore

@@ -126,3 +126,7 @@ dmypy.json
 
 # Jupyter Notebooks
 [Uu]ntitled*
+
+# JupyterLite
+.jupyterlite.doit.db
+_output/

.readthedocs.yml

@@ -0,0 +1,12 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: mambaforge-latest
+  commands:
+    - mamba env update --name base --file docs/environment.yml
+    - python -m pip install .
+    - jupyter lite build --output-dir dist
+    - mkdir -p $READTHEDOCS_OUTPUT/html
+    - cp -r dist/* $READTHEDOCS_OUTPUT/html/

docs/environment.yml

@@ -0,0 +1,10 @@
+name: jupyterlab-hybrid-kernels
+channels:
+- conda-forge
+dependencies:
+- pip
+- python=3.11
+- ipywidgets>=8.1,<9
+- jupyterlab>=4.5.0,<5
+- nodejs=22
+- jupyterlite-core>=0.7.0,<0.8