Merge pull request #598 from PyAutoLabs/feature/docs-theming-hub

docs: shared PyAuto brand layer for the Furo docs

Author: Jammy2211

.gitignore

@@ -1,69 +1,68 @@
-.envr
-*.ipynb
-.projprofile
-*.pyc
-pip-selfcheck.json
-.Python
-bin/
-include/
-lib/
-.ipynb_checkpoints
-.cache
-.idea
-.env
-.pytest_cache
-MultiNest/
-hyper
-hyper_galaxies
-files
-Nonesubplots
-scripts
-subplots
-test_files
-scripts/
-subplots/
-multinest
-.DS_Store
-temp.txt
-*.log
-*.swp
-.coverage
-dist/
-PyAutoLens.egg-info/
-autolens.egg-info/
-__pycache__/
-prof/
-config/*.pyc
-test/integration/data/
-test/output/
-test/test_files/plotting/
-test/integration/tests/simulate_and_fit/datas/
-output
-test/integration/datas/
-search.py
-bfg-1.13.0.jar
-error.log
-workspace/scraps
-workspace_jam/
-workspace_amy/
-workspace/runners/cosma/
-workspace/
-test/integration/data_temp/
-autolens/lens/lens_fit/__pycache__
-test/integration/hyper/
-test/integration/image/
-test/data/
-test/unit/data/test_files/
-test_autolens/integration/data_temp/
-test_autolens/dataset/
-.eggs/
-__MACOSX/
-
-#docs
-docs/_build
-docs/_static
-docs/_templates
-docs/generated
-docs/api/generated
-autolens_workspace_test/
+.envr
+*.ipynb
+.projprofile
+*.pyc
+pip-selfcheck.json
+.Python
+bin/
+include/
+lib/
+.ipynb_checkpoints
+.cache
+.idea
+.env
+.pytest_cache
+MultiNest/
+hyper
+hyper_galaxies
+files
+Nonesubplots
+scripts
+subplots
+test_files
+scripts/
+subplots/
+multinest
+.DS_Store
+temp.txt
+*.log
+*.swp
+.coverage
+dist/
+PyAutoLens.egg-info/
+autolens.egg-info/
+__pycache__/
+prof/
+config/*.pyc
+test/integration/data/
+test/output/
+test/test_files/plotting/
+test/integration/tests/simulate_and_fit/datas/
+output
+test/integration/datas/
+search.py
+bfg-1.13.0.jar
+error.log
+workspace/scraps
+workspace_jam/
+workspace_amy/
+workspace/runners/cosma/
+workspace/
+test/integration/data_temp/
+autolens/lens/lens_fit/__pycache__
+test/integration/hyper/
+test/integration/image/
+test/data/
+test/unit/data/test_files/
+test_autolens/integration/data_temp/
+test_autolens/dataset/
+.eggs/
+__MACOSX/
+
+#docs
+docs/_build
+docs/_templates
+docs/generated
+docs/api/generated
+autolens_workspace_test/
 docs/api/_autosummary

docs/_static/pyauto.css

@@ -0,0 +1,32 @@
+/* PyAuto shared docs brand layer — identical file in PyAutoFit, PyAutoGalaxy,
+   PyAutoLens (docs/_static/pyauto.css). The per-project accent is set via
+   Furo's color-brand-* variables in each repo's conf.py; this file carries
+   the elements common to the whole stack. */
+
+/* The PyAuto family signature: a thin gradient strip across the top of every
+   docs page, running through the three stack accents (Fit / Galaxy / Lens). */
+body::before {
+  content: "";
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: 3px;
+  background: linear-gradient(90deg, #c2410c 0%, #0f766e 50%, #7c4dff 100%);
+  z-index: 1000;
+  pointer-events: none;
+}
+@media (prefers-color-scheme: dark) {
+  body:not([data-theme="light"])::before {
+    background: linear-gradient(90deg, #f28c38 0%, #2dd4bf 50%, #9d7aff 100%);
+  }
+}
+body[data-theme="dark"]::before {
+  background: linear-gradient(90deg, #f28c38 0%, #2dd4bf 50%, #9d7aff 100%);
+}
+
+/* Project wordmark in the sidebar. */
+.sidebar-brand-text {
+  font-weight: 700;
+  letter-spacing: -0.01em;
+}

docs/conf.py

@@ -124,11 +124,18 @@
 
 language = "en"
 
+html_static_path = ["_static"]
+html_css_files = ["pyauto.css"]
+
 html_theme_options = {
     "light_css_variables": {
-        "color-brand-primary": "#7C4DFF",
-        "color-brand-content": "#7C4DFF",
-    }
+        "color-brand-primary": "#7c4dff",
+        "color-brand-content": "#7c4dff",
+    },
+    "dark_css_variables": {
+        "color-brand-primary": "#9d7aff",
+        "color-brand-content": "#9d7aff",
+    },
 }
 
 from sphinx.builders.html import StandaloneHTMLBuilder