Repository: mne-tools/mne-python

Issue:
Changed color scheme?
Hello, I'm not sure if this was introduced upstream in our theme or we did that ourselves, but I don't really like the new colors here:

<img width="753" alt="Screen Shot 2022-06-15 at 14 19 50" src="https://user-images.githubusercontent.com/2046265/173825494-1ef55386-cbf7-47aa-8b6e-c0ae7dcbd566.png">

Aside from the reduced contrast compared to what we had before for headlines, now links and headlines have the same color, so I caught myself actually clicking on headlines a few times, believing that's some sort of hyperlink. I don't think this is a great choice of colors.


Discussion:
It was an upstream change and I didn't want to executively change it, and I also didn't want to open that can of worms just before the 1.1 release 😆
So am I correct in assuming you're not too fond of this change either? 
> So am I correct in assuming you're not too fond of this change either?

I'd like to change a lot of our colors, actually. The syntax highlighting colors of our code blocks changed sometime between stable and current dev docs, but it happened when I was away on leave and I haven't gone digging yet to figure out what caused it. I liked the way it was on the 1.0 docs.  But yeah, I agree the new primary color is a bit low-contrast on light backgrounds (though looks good on dark) and I can see the point about different colors for headings and links.  Also those colors are pydata "brand" colors so there's an argument that we probably *should* overwrite them.
> The syntax highlighting colors of our code blocks changed sometime between stable and current dev docs, but it happened when I was away on leave and I haven't gone digging yet to figure out what caused it. I liked the way it was on the 1.0 docs

Same! The new code block color scheme looks quite "dated" to me!

Is the color scheme something we could try to attack during the sprint?
> Is the color scheme something we could try to attack during the sprint?

I think it's something you and I should work out, and then in theory anyone could implement it (but it would be easier for one of us to do it).  So possibly, depends on how much time is needed supporting the participants. Maybe I'll tag it for the sprint and assign it to you, to keep it on our radars.

Resolving patch:
diff --git a/doc/conf.py b/doc/conf.py
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -123,9 +123,6 @@
 # documents.
 default_role = "py:obj"
 
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'default'
-
 # A list of ignored prefixes for module index sorting.
 modindex_common_prefix = ['mne.']
 
@@ -583,7 +580,8 @@ def append_attr_meth_examples(app, what, name, obj, options, lines):
     'use_edit_page_button': False,
     'navigation_with_keys': False,
     'show_toc_level': 1,
-    'navbar_end': ['theme-switcher', 'version-switcher', 'navbar-icon-links'],
+    'navbar_end': ['search-button', 'theme-switcher', 'version-switcher',
+                   'navbar-icon-links'],
     'footer_items': ['copyright'],
     'google_analytics_id': 'UA-37225609-1',
     'switcher': {
@@ -622,7 +620,7 @@ def append_attr_meth_examples(app, what, name, obj, options, lines):
 
 # Custom sidebar templates, maps document names to template names.
 html_sidebars = {
-    'index': ['search-field.html', 'sidebar-quicklinks.html'],
+    'index': ['sidebar-quicklinks.html'],
 }
 
 # If true, links to the reST sources are added to the pages.
@@ -646,12 +644,15 @@ def append_attr_meth_examples(app, what, name, obj, options, lines):
     'pygment_light_style': 'tango',
     'pygment_dark_style': 'native',
     'funders': [
-        dict(img='nih.png', size='3', title='National Institutes of Health'),
+        dict(img='nih.svg', size='3', title='National Institutes of Health'),
         dict(img='nsf.png', size='3.5',
              title='US National Science Foundation'),
-        dict(img='erc.svg', size='3.5', title='European Research Council'),
+        dict(img='erc.svg', size='3.5', title='European Research Council',
+             klass='only-light'),
+        dict(img='erc-dark.svg', size='3.5', title='European Research Council',
+             klass='only-dark'),
         dict(img='doe.svg', size='3', title='US Department of Energy'),
-        dict(img='anr.svg', size='4.5',
+        dict(img='anr.svg', size='3.5',
              title='Agence Nationale de la Recherche'),
         dict(img='cds.png', size='2.25',
              title='Paris-Saclay Center for Data Science'),
@@ -677,9 +678,15 @@ def append_attr_meth_examples(app, what, name, obj, options, lines):
              url='https://web.mit.edu/',
              size=md),
         dict(name='New York University',
-             img='NYU.png',
+             img='NYU.svg',
+             url='https://www.nyu.edu/',
+             size=xs,
+             klass='only-light'),
+        dict(name='New York University',
+             img='NYU-dark.svg',
              url='https://www.nyu.edu/',
-             size=xs),
+             size=xs,
+             klass='only-dark'),
         dict(name='Commissariat à l´énergie atomique et aux énergies alternatives',  # noqa E501
              img='CEA.png',
              url='http://www.cea.fr/',
@@ -687,15 +694,27 @@ def append_attr_meth_examples(app, what, name, obj, options, lines):
         dict(name='Aalto-yliopiston perustieteiden korkeakoulu',
              img='Aalto.svg',
              url='https://sci.aalto.fi/',
-             size=md),
+             size=md,
+             klass='only-light'),
+        dict(name='Aalto-yliopiston perustieteiden korkeakoulu',
+             img='Aalto-dark.svg',
+             url='https://sci.aalto.fi/',
+             size=md,
+             klass='only-dark'),
         dict(name='Télécom ParisTech',
              img='Telecom_Paris_Tech.svg',
              url='https://www.telecom-paris.fr/',
              size=md),
         dict(name='University of Washington',
-             img='Washington.png',
+             img='Washington.svg',
              url='https://www.washington.edu/',
-             size=md),
+             size=md,
+             klass='only-light'),
+        dict(name='University of Washington',
+             img='Washington-dark.svg',
+             url='https://www.washington.edu/',
+             size=md,
+             klass='only-dark'),
         dict(name='Institut du Cerveau et de la Moelle épinière',
              img='ICM.jpg',
              url='https://icm-institute.org/',
@@ -707,54 +726,108 @@ def append_attr_meth_examples(app, what, name, obj, options, lines):
         dict(name='Institut national de la santé et de la recherche médicale',
              img='Inserm.svg',
              url='https://www.inserm.fr/',
-             size=xl),
+             size=xl,
+             klass='only-light'),
+        dict(name='Institut national de la santé et de la recherche médicale',
+             img='Inserm-dark.svg',
+             url='https://www.inserm.fr/',
+             size=xl,
+             klass='only-dark'),
         dict(name='Forschungszentrum Jülich',
              img='Julich.svg',
              url='https://www.fz-juelich.de/',
-             size=xl),
+             size=xl,
+             klass='only-light'),
+        dict(name='Forschungszentrum Jülich',
+             img='Julich-dark.svg',
+             url='https://www.fz-juelich.de/',
+             size=xl,
+             klass='only-dark'),
+        dict(name='Technische Universität Ilmenau',
+             img='Ilmenau.svg',
+             url='https://www.tu-ilmenau.de/',
+             size=xxl,
+             klass='only-light'),
         dict(name='Technische Universität Ilmenau',
-             img='Ilmenau.gif',
+             img='Ilmenau-dark.svg',
              url='https://www.tu-ilmenau.de/',
-             size=xxl),
+             size=xxl,\
+             klass='only-dark'),
         dict(name='Berkeley Institute for Data Science',
              img='BIDS.png',
              url='https://bids.berkeley.edu/',
-             size=lg),
+             size=lg,
+             klass='only-light'),
+        dict(name='Berkeley Institute for Data Science',
+             img='BIDS-dark.png',
+             url='https://bids.berkeley.edu/',
+             size=lg,
+             klass='only-dark'),
         dict(name='Institut national de recherche en informatique et en automatique',  # noqa E501
              img='inria.png',
              url='https://www.inria.fr/',
              size=xl),
         dict(name='Aarhus Universitet',
-             img='Aarhus.png',
+             img='Aarhus.svg',
              url='https://www.au.dk/',
-             size=xl),
+             size=xl,
+             klass='only-light'),
+        dict(name='Aarhus Universitet',
+             img='Aarhus-dark.svg',
+             url='https://www.au.dk/',
+             size=xl,
+             klass='only-dark'),
         dict(name='Karl-Franzens-Universität Graz',
-             img='Graz.jpg',
+             img='Graz.svg',
              url='https://www.uni-graz.at/',
              size=md),
         dict(name='SWPS Uniwersytet Humanistycznospołeczny',
              img='SWPS.svg',
              url='https://www.swps.pl/',
-             size=xl),
+             size=xl,
+             klass='only-light'),
+        dict(name='SWPS Uniwersytet Humanistycznospołeczny',
+             img='SWPS-dark.svg',
+             url='https://www.swps.pl/',
+             size=xl,
+             klass='only-dark'),
         dict(name='Max-Planck-Institut für Bildungsforschung',
              img='MPIB.svg',
              url='https://www.mpib-berlin.mpg.de/',
-             size=xxl),
+             size=xxl,
+             klass='only-light'),
+        dict(name='Max-Planck-Institut für Bildungsforschung',
+             img='MPIB-dark.svg',
+             url='https://www.mpib-berlin.mpg.de/',
+             size=xxl,
+             klass='only-dark'),
         dict(name='Macquarie University',
-             img='Macquarie.png',
+             img='Macquarie.svg',
              url='https://www.mq.edu.au/',
-             size=lg),
+             size=lg,
+             klass='only-light'),
+        dict(name='Macquarie University',
+             img='Macquarie-dark.svg',
+             url='https://www.mq.edu.au/',
+             size=lg,
+             klass='only-dark'),
         dict(name='Children’s Hospital of Philadelphia Research Institute',
              img='CHOP.svg',
-             url='https://imaging.research.chop.edu/',
-             size=xxl),
+             url='https://www.research.chop.edu/imaging',
+             size=xxl,
+             klass='only-light'),
+        dict(name='Children’s Hospital of Philadelphia Research Institute',
+             img='CHOP-dark.svg',
+             url='https://www.research.chop.edu/imaging',
+             size=xxl,
+             klass='only-dark'),
     ],
     # \u00AD is an optional hyphen (not rendered unless needed)
     # If these are changed, the Makefile should be updated, too
     'carousel': [
         dict(title='Source Estimation',
              text='Distributed, sparse, mixed-norm, beam\u00ADformers, dipole fitting, and more.',  # noqa E501
-             url='auto_tutorials/inverse/30_mne_dspm_loreta.html',
+             url='auto_tutorials/inverse/index.html',
              img='sphx_glr_30_mne_dspm_loreta_008.gif',
              alt='dSPM'),
         dict(title='Machine Learning',
@@ -769,7 +842,7 @@ def append_attr_meth_examples(app, what, name, obj, options, lines):
              alt='STRF'),
         dict(title='Statistics',
              text='Parametric and non-parametric, permutation tests and clustering.',  # noqa E501
-             url='auto_tutorials/stats-source-space/20_cluster_1samp_spatiotemporal.html',  # noqa E501
+             url='auto_tutorials/stats-source-space/index.html',
              img='sphx_glr_20_cluster_1samp_spatiotemporal_001.png',
              alt='Clusters'),
         dict(title='Connectivity',
@@ -780,7 +853,7 @@ def append_attr_meth_examples(app, what, name, obj, options, lines):
         dict(title='Data Visualization',
              text='Explore your data from multiple perspectives.',
              url='auto_tutorials/evoked/20_visualize_evoked.html',
-             img='sphx_glr_20_visualize_evoked_007.png',
+             img='sphx_glr_20_visualize_evoked_010.png',
              alt='Visualization'),
     ]
 }
diff --git a/tutorials/inverse/70_eeg_mri_coords.py b/tutorials/inverse/70_eeg_mri_coords.py
--- a/tutorials/inverse/70_eeg_mri_coords.py
+++ b/tutorials/inverse/70_eeg_mri_coords.py
@@ -79,6 +79,7 @@
 # we stored our locations in Freesurfer surface RAS (MRI) coordinates.
 #
 # .. dropdown:: What if my electrodes are in MRI voxels?
+#     :color: warning
 #     :icon: question
 #
 #     If you have voxel coordinates in MRI voxels, you can transform these to


Test patch: