Merge pull request matplotlib#23351 from jklymak/doc-dev-install-mpl-theme

DOC/MNT install docs with dev version of sphinx theme

Author: timhoffm

.circleci/config.yml

@@ -100,6 +100,13 @@ commands:
                 numpy<< parameters.numpy_version >> codecov coverage \
                 -r requirements/doc/doc-requirements.txt
 
+  mpl-theme-install:
+    steps:
+      - run:
+          name: Install mpl-sphinx-theme dev
+          command: |
+            pip install git+https://github.com/matplotlib/mpl-sphinx-theme.git
+
   mpl-install:
     steps:
       - run:

doc/_static/mpl.css

@@ -1,6 +1,8 @@
 :root {
-    --sd-color-primary: #11557C;
-    --sd-color-primary-highlight: #003c63;
+    --pst-color-link: var(--pst-color-primary);
+    --pst-color-link-hover: var(--pst-color-secondary);
+    --sd-color-primary: var(--pst-color-primary);
+    --sd-color-primary-text: var(--pst-color-text-base);
 }
 
 .simple li>p {
@@ -51,6 +53,10 @@ does not float with it.
     margin: 5px 2px;
 }
 
+html[data-theme="dark"] .sphx-glr-thumbcontainer {
+    background-color: rgb(63, 63, 63);
+}
+
 /* workaround: the default padding decenters the image inside the frame */
 .sphx-glr-thumbcontainer .figure {
     padding: 0;

doc/conf.py

@@ -329,7 +329,6 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
 html_logo = "_static/logo2.svg"
 html_theme_options = {
     "native_site": True,
-    "logo": {"link": "index"},
     # collapse_navigation in pydata-sphinx-theme is slow, so skipped for local
     # and CI builds https://github.com/pydata/pydata-sphinx-theme/pull/386
     "collapse_navigation": not is_release_build,
@@ -342,7 +341,10 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
             'stable' if matplotlib.__version_info__.releaselevel == 'final'
             else 'devdocs')
     },
-    "navbar_end": ["version-switcher", "mpl_icon_links"]
+    "logo": {"link": "index",
+             "image_light": "images/logo2.svg",
+             "image_dark": "images/logo_dark.svg"},
+    "navbar_end": ["version-switcher", "mpl_icon_links", "theme-switcher"]
 }
 include_analytics = is_release_build
 if include_analytics:

doc/index.rst

@@ -44,7 +44,6 @@ Learning resources
 .. grid:: 1 1 2 2
 
     .. grid-item-card::
-        :class-header: sd-bg-light
         :padding: 2
 
         Tutorials
@@ -56,7 +55,6 @@ Learning resources
         - :doc:`External learning resources <users/resources/index>`
 
     .. grid-item-card::
-        :class-header: sd-bg-light
         :padding: 2
 
         How-tos
@@ -66,7 +64,6 @@ Learning resources
         - :doc:`Matplotlib FAQ <users/faq/index>`
 
     .. grid-item-card::
-        :class-header: sd-bg-light
         :padding: 2
 
         Understand how Matplotlib works
@@ -79,7 +76,6 @@ Learning resources
           material
 
     .. grid-item-card::
-        :class-header: sd-bg-light
         :padding: 2
 
         Reference