From cb2d960d874b296b1279c59b7db5eaf6ffa0adac Mon Sep 17 00:00:00 2001
From: Chris Sewell <chrisj_sewell@hotmail.com>
Date: Mon, 20 May 2024 23:32:31 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=A7=AA=20Add=20sphinx-immaterial=20to=20d?=
 =?UTF-8?q?oc=20theme=20builds?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/_static/sphinx_immaterial.css | 30 +++++++++++++++++++++++++++
 docs/conf.py                       | 33 ++++++++++++++++++++++++++++++
 pyproject.toml                     |  1 +
 tox.ini                            |  7 ++++---
 4 files changed, 68 insertions(+), 3 deletions(-)
 create mode 100644 docs/_static/sphinx_immaterial.css

diff --git a/docs/_static/sphinx_immaterial.css b/docs/_static/sphinx_immaterial.css
new file mode 100644
index 0000000..95a4ce6
--- /dev/null
+++ b/docs/_static/sphinx_immaterial.css
@@ -0,0 +1,30 @@
+body {
+    --sd-fontsize-dropdown: .64rem;
+    --sd-fontsize-dropdown-title: .64rem;
+    --sd-fontweight-dropdown-title: 700;
+}
+
+details.sd-dropdown {
+    padding-left: 0;
+    padding-right: 0;
+}
+
+summary.sd-summary-title::after {
+    display: none;
+    right: 0 !important;
+}
+
+summary.sd-summary-title::before {
+    display: none;
+    left: 0 !important;
+}
+
+summary.sd-summary-title {
+    width: 100% !important;
+    margin-left: 0;
+    padding: .5em 1em !important;
+}
+
+summary.sd-summary-title svg.sd-octicon {
+    max-width: none !important;
+}
diff --git a/docs/conf.py b/docs/conf.py
index 6aa598a..34bc6be 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -55,6 +55,39 @@
     html_theme_options = {
         "logo_only": True,
     }
+if html_theme == "sphinx_immaterial":
+    extensions.append("sphinx_immaterial")
+    html_css_files = ["sphinx_immaterial.css"]
+    html_theme_options = {
+        "icon": {
+            "repo": "fontawesome/brands/github",
+        },
+        "site_url": "https://sphinx-design.readthedocs.io/",
+        "repo_url": "https://github.com/executablebooks/sphinx-design",
+        "repo_name": "Sphinx-Design",
+        "palette": [
+            {
+                "media": "(prefers-color-scheme: light)",
+                "scheme": "default",
+                "primary": "blue",
+                "accent": "light-blue",
+                "toggle": {
+                    "icon": "material/weather-night",
+                    "name": "Switch to dark mode",
+                },
+            },
+            {
+                "media": "(prefers-color-scheme: dark)",
+                "scheme": "slate",
+                "primary": "blue",
+                "accent": "yellow",
+                "toggle": {
+                    "icon": "material/weather-sunny",
+                    "name": "Switch to light mode",
+                },
+            },
+        ],
+    }
 
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 myst_enable_extensions = ["colon_fence", "deflist", "substitution", "html_image"]
diff --git a/pyproject.toml b/pyproject.toml
index e8e923b..c307e72 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -48,6 +48,7 @@ theme-furo = ["furo~=2024.5.4"]
 theme-pydata = ["pydata-sphinx-theme~=0.15.2"]
 theme-rtd = ["sphinx-rtd-theme~=2.0"]
 theme-sbt = ["sphinx-book-theme~=1.1"]
+theme-im = ["sphinx-immaterial~=0.11.11"]
 
 [tool.flit.sdist]
 exclude = [
diff --git a/tox.ini b/tox.ini
index 5f61643..fad8312 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,6 +1,5 @@
 # To use tox, see https://tox.readthedocs.io
-# Simply pip or conda install tox
-# If you use conda, you may also want to install tox-conda
+# (you may also want to install tox-uv)
 # then run `tox` or `tox -- {pytest args}`
 # run in parallel using `tox -p`
 [tox]
@@ -15,7 +14,7 @@ extras =
     testing
 commands = pytest {posargs}
 
-[testenv:docs-{alabaster,rtd,pydata,sbt,furo}]
+[testenv:docs-{alabaster,rtd,pydata,sbt,furo,im}]
 description =
     Run documentation build for this theme
 extras =
@@ -24,6 +23,7 @@ extras =
     pydata: theme_pydata
     sbt: theme_sbt
     furo: theme_furo
+    im: theme_im
 allowlist_externals = echo
 passenv =
     BUILDER
@@ -35,6 +35,7 @@ setenv =
     pydata: SPHINX_THEME = pydata_sphinx_theme
     sbt: SPHINX_THEME = sphinx_book_theme
     furo: SPHINX_THEME = furo
+    im: SPHINX_THEME = sphinx_immaterial
 commands_pre =
   python -c "import shutil; shutil.rmtree('docs/_build/{env:BUILDER:html}/{env:SPHINX_THEME:}', ignore_errors=True) if '{env:CLEAN:}' else None"
 commands =