Fix documentation build: GitHub Actions, Sphinx 5.3.0, and theme compatibility

Author: soot-bit

.github/workflows/doc-build.yml

@@ -22,14 +22,15 @@ jobs:
       run: |
         export DEBIAN_FRONTEND=noninteractive
         sudo apt-get update
-        sudo apt install -y git python3-venv make
+        sudo apt install -y git python3-venv make python3-setuptools
         echo `python3 --version`
         python3 -m venv venv 
         source venv/bin/activate 
         pip install --upgrade pip setuptools 
       id: build
     - name: Build the docset
       run: | 
+        source ../venv/bin/activate 
         cd docs
         pip install -r requirements.txt
         make html 

docs/source/_static/.gitkeep

@@ -41,8 +41,7 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["sphinx.ext.napoleon", "sphinx.ext.autodoc", 'sphinx_panels']
-panels_add_bootstrap_css = False
+extensions = ["sphinx.ext.napoleon", "sphinx.ext.autodoc", "sphinx_panels"]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
@@ -66,6 +65,7 @@
 # so a file named "default.css" will overwrite the builtin "default.css".
 
 html_static_path = ["_static"]
+html_css_files = [] # avoid undefined errors
 panels_add_fontawesome_latex = True
 
 html_theme_options = {