Docs: Change theme to Shibuya

Author: leroyvn

docs/changelog.md

@@ -10,10 +10,11 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### Changed
 
-* Move from Rye to [uv](https://astral.sh/uv).
-* Move back from mkdocs to Sphinx (with Furo theme).
+* Move from Rye to [uv](https://astral.sh/uv) for project management.
+* Move back from mkdocs to Sphinx (with [Shibuya](https://shibuya.lepture.com)
+  theme).
 * Rework documentation structure for improved navigation and search.
-* Deploy docs on Read The Docs.
+* Deploy docs on [Read The Docs](https://joseki.readthedocs.io/).
 * Allow Numpy 2.
 * Support Python 3.13.
 

docs/conf.py

@@ -44,25 +44,14 @@
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_theme = "furo"
-
+html_theme = "shibuya"
 html_theme_options = {
-    "source_repository": "https://github.com/rayference/joseki/",
-    "source_branch": "main",
-    "source_directory": "docs/",
-    "light_css_variables": {
-        "color-brand-primary": "#2563eb",
-        "color-brand-content": "#2563eb",
-    },
-    "dark_css_variables": {
-        "color-brand-primary": "#60a5fa",
-        "color-brand-content": "#60a5fa",
-    },
-    "light_logo": "logo_title-light.svg",
-    "dark_logo": "logo_title-dark.svg",
-    "sidebar_hide_name": True,
+    "github_url": "https://github.com/rayference/joseki/",
+    "accent_color": "violet",
+    "light_logo": "_static/logo_title-light.svg",
+    "dark_logo": "_static/logo_title-dark.svg",
+    "navigation_with_keys": True,
 }
-
 html_static_path = ["_static"]
 html_title = "Joseki"
 

docs/requirements.txt

@@ -1,8 +1,6 @@
 # This file was autogenerated by uv via the following command:
 #    uv export --frozen --no-hashes --output-file=docs/requirements.txt
 -e .
-accessible-pygments==0.0.5
-    # via furo
 alabaster==0.7.16 ; python_full_version < '3.10'
     # via sphinx
 alabaster==1.0.0 ; python_full_version >= '3.10'
@@ -38,9 +36,7 @@ babel==2.17.0
     #   jupyterlab-server
     #   sphinx
 beautifulsoup4==4.13.4
-    # via
-    #   furo
-    #   nbconvert
+    # via nbconvert
 bleach==6.2.0
     # via nbconvert
 certifi==2025.7.14
@@ -113,7 +109,6 @@ fonttools==4.59.0
     # via matplotlib
 fqdn==1.5.1
     # via jsonschema
-furo==2025.7.19
 h11==0.16.0
     # via
     #   httpcore
@@ -360,8 +355,6 @@ pycparser==2.22
     # via cffi
 pygments==2.19.2
     # via
-    #   accessible-pygments
-    #   furo
     #   ipython
     #   ipython-pygments-lexers
     #   nbconvert
@@ -438,6 +431,7 @@ send2trash==1.8.3
     # via jupyter-server
 setuptools==80.9.0
     # via jupyterlab
+shibuya==2025.7.24
 six==1.17.0
     # via
     #   python-dateutil
@@ -451,31 +445,27 @@ soupsieve==2.7
 sphinx==7.4.7 ; python_full_version < '3.10'
     # via
     #   autodocsumm
-    #   furo
     #   myst-parser
+    #   shibuya
     #   sphinx-autoapi
     #   sphinx-autobuild
     #   sphinx-autodoc-typehints
-    #   sphinx-basic-ng
     #   sphinx-copybutton
     #   sphinxcontrib-bibtex
 sphinx==8.1.3 ; python_full_version >= '3.10'
     # via
     #   autodocsumm
-    #   furo
     #   myst-parser
+    #   shibuya
     #   sphinx-autoapi
     #   sphinx-autobuild
     #   sphinx-autodoc-typehints
-    #   sphinx-basic-ng
     #   sphinx-copybutton
     #   sphinxcontrib-bibtex
 sphinx-autoapi==3.6.0
 sphinx-autobuild==2024.10.3
 sphinx-autodoc-typehints==2.3.0 ; python_full_version < '3.10'
 sphinx-autodoc-typehints==3.0.1 ; python_full_version >= '3.10'
-sphinx-basic-ng==1.0.0b2
-    # via furo
 sphinx-copybutton==0.5.2
 sphinxcontrib-applehelp==2.0.0
     # via sphinx

pyproject.toml

@@ -80,7 +80,6 @@ relative-imports-order = "closest-to-furthest"
 dev = [
   "autodocsumm>=0.2.14",
   "coverage>=7.1.0",
-  "furo>=2024.1.29",
   "ipykernel>=6.21.0",
   "ipython>=8.9.0",
   "jupyterlab>=3.5.3",
@@ -90,6 +89,7 @@ dev = [
   "nbstripout>=0.6.1",
   "pytest>=7.2.1",
   "seaborn>=0.13.2",
+  "shibuya>=2025.7.24",
   "sphinx-autoapi>=3.6.0",
   "sphinx-autobuild>=2024.10.3",
   "sphinx-autodoc-typehints>=1.25.0",