Repository: mne-tools/mne-bids

Issue:
STY: Move to pydata-sphinx-theme
Now that NumPy, SciPy (in progress), pandas, and (most importantly I think) MNE-Python have moved to pydata-sphinx-theme, it might be nice to move `mne-bids` over, too, for cohesiveness. Any thoughts or objections?


Discussion:
no objections, the motivation to move to pydata-sphinx-theme is very clear to me (discussed here: https://github.com/mne-tools/mne-python/issues/8184#issuecomment-685047720).
@sappelhoff do you want to give it a shot? Hopefully it's less onerous than it was for MNE since the config and custom CSS used here is much simpler...

If not, I can take a look.
> If not, I can take a look.

That'd be very nice! We have some docs on our documentation setup here: https://github.com/mne-tools/mne-bids/wiki/Explanation-of-Documentation-Setup

should be very similar to MNE, which is where most of it was copied from :thinking: 

Resolving patch:
diff --git a/doc/conf.py b/doc/conf.py
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -5,7 +5,6 @@
 
 import sphinx_gallery  # noqa: F401
 from sphinx_gallery.sorting import ExampleTitleSortKey
-import sphinx_bootstrap_theme
 
 import mne_bids
 
@@ -74,7 +73,7 @@
 master_doc = 'index'
 
 # General information about the project.
-project = u'mne_bids'
+project = u'MNE-BIDS'
 td = date.today()
 copyright = u'2017-%s, MNE Developers. Last updated on %s' % (td.year,
                                                               td.isoformat())
@@ -97,12 +96,10 @@
                     '.DS_Store']
 
 # HTML options (e.g., theme)
-# see: https://sphinx-bootstrap-theme.readthedocs.io/en/latest/README.html
-# Clean up sidebar: Do not show "Source" link
 html_show_sourcelink = False
+html_copy_source = False
 
-html_theme = 'bootstrap'
-html_theme_path = sphinx_bootstrap_theme.get_html_theme_path()
+html_theme = 'pydata_sphinx_theme'
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -113,21 +110,31 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
-    'navbar_title': 'MNE-BIDS',
-    'bootswatch_theme': "flatly",
-    'navbar_sidebarrel': False,  # no "previous / next" navigation
-    'navbar_pagenav': False,  # no "Page" navigation in sidebar
-    'bootstrap_version': "3",
-    'navbar_links': [
-        ("News", "whats_new"),
-        ("Install", "install"),
-        ("Use", "use"),
-        ("API", "api"),
-        ("CLI", "generated/cli"),
-        ("Contribute!", "contribute")
-    ]}
-
-html_sidebars = {'**': ['localtoc.html']}
+    'icon_links': [
+        dict(name='GitHub',
+             url='https://github.com/mne-tools/mne-bids',
+             icon='fab fa-github-square'),
+    ],
+    'icon_links_label': 'Quick Links',  # for screen reader
+    'use_edit_page_button': False,
+    'navigation_with_keys': False,
+    'show_toc_level': 1,
+}
+
+html_context = {
+    'versions_dropdown': {
+        'dev': 'v0.8 (devel)',
+        'stable': 'v0.7 (stable)',
+        'v0.6': 'v0.6',
+        'v0.5': 'v0.5',
+        'v0.4': 'v0.4',
+        'v0.3': 'v0.3',
+        'v0.2': 'v0.2',
+        'v0.1': 'v0.1',
+    },
+}
+
+html_sidebars = {}
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {


Test patch: