Merge pull request #791 from nkeim/doc-pydata-theme

BLD: Switch docs to PyData theme

Author: nkeim

doc/conf.py

@@ -12,7 +12,6 @@
 
 import sys
 import os
-import sphinx_bootstrap_theme
 import matplotlib as mpl
 mpl.use("Agg")
 
@@ -40,7 +39,7 @@
              ]
 
 extlinks = {'issue': ('https://github.com/soft-matter/trackpy/issues/%s',
-                      'GH')}
+                      'GH #%s')}
 
 mathjax_path = 'https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.3/MathJax.js'
 
@@ -118,27 +117,35 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'bootstrap'
+html_theme = 'pydata_sphinx_theme'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
-                      'source_link_position': "footer",
-                      'bootswatch_theme': "spacelab",
-                      'navbar_sidebarrel': False,
-                      'bootstrap_version': "3",
-                      'navbar_links': [("Tutorial", "tutorial")],
+                      "header_links_before_dropdown": 2,
+                      "navbar_align": "right",
+                      "secondary_sidebar_items": {
+                        "*": ["page-toc"],
+                        "generated/trackpy.*": [],
+
+                      }
                      }
-# Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = sphinx_bootstrap_theme.get_html_theme_path()
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
-#html_title = None
+html_title = "trackpy " + release
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = None
+html_short_title = "trackpy " + release
+
+# Only show left sidebar in API reference
+html_sidebars = {
+    "*": [],
+    "tutorial/*": [],
+    "api": ["sidebar-nav-bs"],
+    "generated/trackpy.*": ["sidebar-nav-bs"],
+}
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.