[JTH] little changes to deploy sphinx docu

Author: tausiaj

.github/workflows/build-docs.yml

@@ -9,28 +9,32 @@ permissions:
   contents: write
 
 jobs:
-  docs:
+  build-and-deploy-docs:
     runs-on: ubuntu-latest
-    
+
     steps:
-      - uses: actions/checkout@v4
-    
-      - uses: actions/setup-python@v5
+    - name: Checkout Repository
+      uses: actions/checkout@v4
+
+    - name: Set Up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.12"
 
-      - name: Install dependencies
-        run: |
-          pip install sphinx sphinx-rtd-theme jupyter-sphinx
-      
-      - name: Sphinx build
-        run: |
-          sphinx-apidoc -o docs/source/ bluemath_tk/
-          sphinx-build docs/source/ docs/build/
+    - name: Install dependencies
+      run: |
+        pip install bluemath-tk[docs]
       
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v3
-        if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
-        with:
-          publish_branch: gh-pages
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs/build/
-          force_orphan: true
+    - name: Sphinx build
+      run: |
+        sphinx-apidoc -o docs/source/ bluemath_tk/
+        sphinx-build docs/source/ docs/build/
+    
+    - name: Deploy to GitHub Pages
+      uses: peaceiris/actions-gh-pages@v3
+      if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
+      with:
+        publish_branch: gh-pages
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: docs/build/
+        force_orphan: true

.github/workflows/build-package.yml

@@ -1,12 +1,12 @@
-name: Publish Python Package
+name: Build and Publish Package
 
 on:
   push:
     tags:
       - "v*"
 
 jobs:
-  build-and-publish:
+  build-and-publish-package:
     runs-on: ubuntu-latest
 
     steps:

docs/source/conf.py

@@ -18,7 +18,6 @@
     "sphinx.ext.viewcode",
     "sphinx.ext.napoleon",
     "sphinx.ext.doctest",
-    "matplotlib.sphinxext.plot_directive",
     "jupyter_sphinx",
 ]
 

pyproject.toml

@@ -49,7 +49,6 @@ dependencies = [
 [project.optional-dependencies]
 
 docs = ["sphinx", "sphinx-rtd-theme", "jupyter-sphinx"]
-tests = ["pytest", "pytest-mock"]
 deep = ["tensorflow", "keras"]
 num-models = ["hydromt-sfincs"]