updates

Author: msneubauer

.github/workflows/deploy.yml

@@ -3,38 +3,39 @@ name: deploy-book
 on:
   push:
     branches:
-    - main
+      - main
 
 jobs:
   deploy-book:
     runs-on: ubuntu-latest
     steps:
+      # 1️⃣ Checkout the repository
       - uses: actions/checkout@v2
 
-      # Set up Python 3.11 (needed for latest packages)
+      # 2️⃣ Set up Python 3.11
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
           python-version: 3.11
 
-      # Install system dependencies required by PyTables
+      # 3️⃣ Install system dependencies (needed by PyTables)
       - name: Install system dependencies
         run: |
           sudo apt-get update
           sudo apt-get install -y libhdf5-dev build-essential python3-dev
 
-      # Install Python dependencies
+      # 4️⃣ Install Python dependencies
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip wheel setuptools
           pip install -r requirements.txt
 
-      # Build the book
-      - name: Build the book
+      # 5️⃣ Build the Jupyter Book (using python -m to ensure it works in venv)
+      - name: Build the Jupyter Book
         run: |
-          jupyter-book build --config _config.yml --toc _toc.yml .
+          python -m jupyter_book build --config _config.yml --toc _toc.yml .
 
-      # Push to GitHub Pages
+      # 6️⃣ Deploy to GitHub Pages
       - name: GitHub Pages action
         uses: peaceiris/actions-gh-pages@v3.6.1
         with: