changed docs theme to alabaster and customized to have TOC and full width (no margins)

Author: dave-doty

doc/conf.py

@@ -81,17 +81,38 @@ def extract_version(filename: str):
 # 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 = 'alabaster'
+# html_theme = "pyramid"
+# html_theme = "sphinx_rtd_theme"
+html_theme = 'alabaster'
 # html_theme = "classic"
 
+# Alabaster theme options
+html_theme_options = {
+    'page_width': '100%',        # Use full width of browser
+    'body_max_width': 'none',    # No maximum width constraint
+    'sidebar_width': '300px',    # Set sidebar width to 300px (adjust as needed)
+    'fixed_sidebar': True        # Make sidebar fixed with separate scrolling
+}
+
+
 # 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 = []
+html_static_path = ['_static']
+html_css_files = ['custom.css']
+
+html_sidebars = {
+    '**': [
+        'globaltoc.html',  # Global table of contents
+        'localtoc.html',   # Local page table of contents
+        'searchbox.html',  # Search box
+        'sourcelink.html'  # Link to source
+    ]
+}
 
 # use order in source rather than alphabetical order
-autodoc_member_order = 'bysource'
+# autodoc_member_order = 'bysource'
+autodoc_member_order = 'alphabetical'
 
 # intersphinx_mapping = {'python': ('https://docs.python.org/3', None)}