work on light theme for docs

MarcusMNoack · MarcusMNoack · commit 2a7b99baa627 · 2026-06-04T16:17:39.000-07:00
diff --git a/docs/source/_static/custom.css b/docs/source/_static/custom.css
@@ -1,24 +1,7 @@
-/* ------------------------------------------------------------------ */
-/* Force light colour scheme regardless of OS/browser preference.     */
-/*                                                                     */
-/* pydata-sphinx-theme respects color_mode:'light' in conf.py by      */
-/* setting data-theme="light" on <html>, but still ships a            */
-/* prefers-color-scheme:dark media block.  The rules below override   */
-/* that block so the docs always render in light mode.                */
-/* ------------------------------------------------------------------ */
-
-/* Prevent native browser controls (inputs, scrollbars, etc.)         */
-/* from switching to dark variants.                                   */
+/* Keep native browser controls (scrollbars, form widgets) in their light
+   variants — pydata's default_mode="light" handles the rest. */
 :root {
-    color-scheme: light !important;
-}
-
-/* Re-assert light variables if the theme's dark media query fires.   */
-@media (prefers-color-scheme: dark) {
-    html[data-theme="light"],
-    html:not([data-theme="dark"]) {
-        color-scheme: light;
-    }
+    color-scheme: light;
 }
 
 /* ------------------------------------------------------------------ */
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -64,6 +64,11 @@ def setup(app):
 
 html_theme = 'pydata_sphinx_theme'
 
+# Force light mode regardless of the visitor's OS preference. pydata-sphinx-theme
+# sets data-theme="light" on <html> when default_mode == "light", and the navbar
+# theme-switcher is excluded via navbar_end so visitors can't toggle to dark.
+html_context = {'default_mode': 'light'}
+
 html_theme_options = {
     'logo': {'text': 'fvGP'},
     'github_url': 'https://github.com/lbl-camera/fvgp',
@@ -73,7 +78,6 @@ def setup(app):
     'secondary_sidebar_items': ['page-toc'],
     'footer_start': ['copyright'],
     'footer_end': [],
-    'color_mode': 'light',
 }
 
 html_static_path = ['_static']
