Integrate Jupyter Lite and Colab

.github/workflows/deploy.yml

@@ -0,0 +1,48 @@
+name: Build and Deploy
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - '*'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Install the dependencies
+        run: |
+          python -m pip install -r requirements.txt
+      - name: Build the JupyterLite site
+        run: |
+          cp README.md content
+          jupyter lite build --contents content --output-dir dist
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist
+
+  deploy:
+    needs: build
+    if: github.ref == 'refs/heads/main'
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -208,6 +208,7 @@ __pycache__/
 # Distribution / packaging
 .Python
 build/
+docs/build
 develop-eggs/
 dist/
 downloads/
@@ -329,3 +330,8 @@ pip-log.txt
 mesa_geo/visualization/templates/css/*
 mesa_geo/visualization/templates/js/*
 !mesa_geo/visualization/templates/js/MapModule.js
+
+# Jupyter Lite files
+.jupyterlite.doit.db
+*.jupyterlite.doit.db
+.virtual_documents

.nojekyll

@@ -0,0 +1 @@
+

.readthedocs.yml

@@ -1,26 +1,23 @@
-# Read the Docs configuration file
+  # Read the Docs configuration file
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 
 # Required
 version: 2
 
-# Build documentation in the docs/ directory with Sphinx
-sphinx:
-  configuration: docs/conf.py
-
-# Optionally build your docs in additional formats such as PDF
-formats:
-  - pdf
-
 build:
-  os: "ubuntu-22.04"
+  os: "ubuntu-20.04"
   tools:
-    python: "3.9"
+       python: "mambaforge-4.10"
 
-# Optionally set the version of Python and requirements required to build your docs
 python:
   install:
     - method: pip
       path: .
-      extra_requirements:
-        - docs
+
+conda:
+  environment: docs/source/environment.yml
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/source/conf.py
+  fail_on_warning: false