fix: update Sphinx documentation build process and remove sphinx-multiversion

Author: gnzng

.github/workflows/main.yml

@@ -32,10 +32,13 @@ jobs:
         run: |
           uv pip install ."[docs]"
 
-      - name: Build versioned docs with sphinx-multiversion
+      - name: Build versioned docs with sphinx
         run: |
-          uv run sphinx-multiversion docs/ docs/_build/html
-
+          uv run python -m sphinx -b html docs/ docs/_build/html
+          git reset --hard
+          git fetch --prune --unshallow
+          git checkout v0.3.10
+          uv run python -m sphinx -b html docs/ docs/_build/html/v0.3.10
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

docs/conf.py

@@ -16,7 +16,6 @@
 extensions = [
     "sphinx.ext.autosummary",
     "sphinx.ext.autodoc",
-    "sphinx_multiversion",
 ]
 
 templates_path = ["_templates"]
@@ -28,14 +27,3 @@
 
 html_theme = "sphinx_rtd_theme"
 html_static_path = ["_static"]
-
-# Ensure the version selector sidebar is always included
-html_sidebars = {
-    "**": [
-        "versioning.html",  # Provided by sphinx-multiversion
-        "globaltoc.html",
-        "relations.html",
-        "sourcelink.html",
-        "searchbox.html",
-    ]
-}

pyproject.toml

@@ -27,8 +27,7 @@ requires-python = ">=3.10"
 [project.optional-dependencies]
 docs = [
   "sphinx",
-  "sphinx_rtd_theme",
-  "sphinx-multiversion"
+  "sphinx_rtd_theme"
 ]
 
 [optional-dependencies]