chore: update Sphinx documentation build process and dependencies in pyproject.toml

Author: Khushiyant

.github/workflows/docs.yml

@@ -30,13 +30,17 @@ jobs:
 
       - name: Build Sphinx Documentation
         run: |
-          # Generate RST files from source if they don't exist
-          uv run sphinx-apidoc -o docs/ src/tether/
-          # Build the HTML
-          cd docs && uv run make html
+          cd docs
+          mkdir -p source/_static 
+          uv run sphinx-build -M html source build -W
 
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
       - name: Deploy to GitHub Pages
-        uses: JamesIves/github-pages-deploy-action@v4
-        with:
-          folder: docs/_build/html # The folder the action should deploy.
-          branch: gh-pages # The branch the action should deploy to.
+        id: deployment
+        uses: actions/deploy-pages@v4

docs/conf.py

@@ -1,12 +1,45 @@
 import os
 import sys
 # Ensure Sphinx can find the source code
-sys.path.insert(0, os.path.abspath('../src'))
+sys.path.insert(0, os.path.abspath("../src"))
+
+
+def get_project_metadata():
+    import pathlib
+    import sys
+
+    pyproject_path = pathlib.Path(__file__).parents[2] / "pyproject.toml"
+    if sys.version_info >= (3, 11):
+        import tomllib
+
+        with open(pyproject_path, "rb") as f:
+            data = tomllib.load(f)
+    else:
+        try:
+            import tomli
+
+            with open(pyproject_path, "rb") as f:
+                data = tomli.load(f)
+        except ImportError:
+            return {}
+    project = data.get("project", {})
+    author = project.get("authors", [{}])[0].get("name", "")
+    copyright_year = re.search(r"\\d{4}", project.get("version", ""))
+    copyright_str = f"{copyright_year.group(0) if copyright_year else ''}, {author}"
+    return {
+        "project": project.get("name", "SheetWise"),
+        "author": author,
+        "release": project.get("version", "0.0.0"),
+        "copyright": copyright_str,
+    }
+
+
+meta = get_project_metadata()
 
 project = 'Tether'
 copyright = '2025, Khushiyant'
-author = 'Khushiyant'
-release = '0.0.1'
+author = meta.get("author", "Khushiyant")
+release = meta.get("release", "0.6.0")
 
 extensions = [
     'sphinx.ext.autodoc',      # Core library for html generation from docstrings
@@ -20,10 +53,12 @@
 templates_path = ['_templates']
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
 
-# Use the Read the Docs theme
-html_theme = 'sphinx_rtd_theme'
-html_static_path = ['_static']
+html_static_path = ["_static"]
+html_theme = "furo"
 
-# Napoleon settings to handle your current docstring style
-napoleon_google_docstring = False
-napoleon_numpy_docstring = True
+# Optional: Furo specific customization
+html_theme_options = {
+    "source_repository": "https://github.com/Khushiyant/tenso",
+    "source_branch": "main",
+    "source_directory": "docs/source/",
+}

pyproject.toml

@@ -14,10 +14,11 @@ build-backend = "hatchling.build"
 [project.optional-dependencies]
 dev = ["pytest>=9.0.2"]
 docs = [
-    "sphinx>=7.0.0",
-    "sphinx-rtd-theme>=2.0.0",
-    "myst-parser>=2.0.0", # For Markdown support
-    "sphinx-autodoc-typehints"
+    "sphinx>=8.1.3",
+    "sphinx-autodoc-typehints>=3.0.1",
+    "sphinx-rtd-theme>=3.0.0",
+    "myst-parser>=4.0.1",
+    "furo>=2025.9.25",
 ]
 
 [tool.hatch.build.targets.wheel]