fix docs

Author: soodoku

docs/source/_static/.gitkeep

@@ -0,0 +1,2 @@
+# Keep this directory in version control
+# Sphinx expects _static directory to exist for static assets

docs/source/conf.py

@@ -69,10 +69,7 @@
 
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
-source_suffix = {
-    '.rst': None,
-    '.md': None,
-}
+source_suffix = ['.rst', '.md']
 
 # The master toctree document.
 master_doc = 'index'
@@ -135,33 +132,31 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'sphinx_rtd_theme'
+html_theme = 'furo'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
-# html_theme_options = {}
+html_theme_options = {
+    "sidebar_hide_name": True,
+    "light_css_variables": {
+        "color-brand-primary": "#2563eb",
+        "color-brand-content": "#2563eb",
+    },
+    "dark_css_variables": {
+        "color-brand-primary": "#3b82f6",
+        "color-brand-content": "#3b82f6",
+    },
+}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
 
-# Custom sidebar templates, must be a dictionary that maps document names
-# to template names.
-#
-# This is required for the alabaster theme
-# refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars
-html_sidebars = {
-    '**': [
-        'about.html',
-        'navigation.html',
-        'relations.html',  # needs 'show_related': True theme option to display
-        'searchbox.html',
-        'donate.html',
-    ]
-}
+# Furo doesn't need custom sidebar configuration
+# html_sidebars = {}
 
 
 # -- Options for HTMLHelp output ------------------------------------------

docs/source/installation.md

@@ -91,9 +91,11 @@ pip install "allocator[docs]"
 
 Includes:
 - `sphinx` ≥7.0.0 - Documentation generator
-- `sphinx-rtd-theme` ≥1.3.0 - Read the Docs theme
+- `furo` ≥2023.9.10 - Additional functionality
 - `myst-parser` ≥2.0.0 - Markdown support for Sphinx
+- `linkify-it-py` ≥2.0.0 - Additional functionality
 - `sphinx-autodoc-typehints` ≥1.24.0 - Type hints in API docs
+- `sphinx-design` ≥0.5.0 - Additional functionality
 
 ## Complete Installation
 

pyproject.toml

@@ -95,9 +95,11 @@ test = [
 ]
 docs = [
     "sphinx>=7.0.0",
-    "sphinx-rtd-theme>=1.3.0",
+    "furo>=2023.9.10",          # Modern Sphinx theme
     "myst-parser>=2.0.0",       # Markdown support
+    "linkify-it-py>=2.0.0",     # Required for MyST linkify extension
     "sphinx-autodoc-typehints>=1.24.0",
+    "sphinx-design>=0.5.0",     # Modern design components
 ]
 
 # Convenience groups