non-rtf docs use globaltoc and css

docs/source/_static/css/custom.css

@@ -0,0 +1,4 @@
+div.sphinxsidebar {
+  height: 100%; /* 100vh */
+  overflow: auto; /* overflow-y */
+}

docs/source/conf.py

@@ -133,6 +133,7 @@
 #
 if not on_rtd:
     html_theme = 'alabaster' #'bizstyle'
+    html_css_files = ['css/custom.css',]
    #import sphinx_rtd_theme
    #html_theme = 'sphinx_rtd_theme'
    #html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
@@ -152,6 +153,8 @@
     'gratipay_user': False,  # username
     'extra_nav_links': {'Module Index': 'py-modindex.html'},
 #   'show_related': True,
+#   'globaltoc_collapse': True,
+    'globaltoc_maxdepth': 4,
     'show_powered_by': False
 }
 
@@ -165,19 +168,20 @@
 #
 # This is required for the alabaster theme
 # refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars
-#if html_theme == 'alabaster':
+if on_rtd:
+    toc_style = 'localtoc.html', # display the toctree
+else:
+    toc_style = 'globaltoc.html', # collapse the toctree
 html_sidebars = {
     '**': [
         'about.html',
         'donate.html',
         'searchbox.html',
 #       'navigation.html',
-        'localtoc.html', # display the toctree
+        toc_style, # defined above
         'relations.html', # needs 'show_related':True option to display
     ]
 }
-#FIXME: donate / UQFoundation (home/github)
-
 
 # -- Options for HTMLHelp output ------------------------------------------
 

docs/source/index.rst

@@ -3,16 +3,17 @@
 dill package documentation
 ==========================
 
-.. automodule:: dill
-..  :exclude-members: +
-
 .. toctree::
+    :hidden:
     :maxdepth: 2
-    :caption: Contents:
 
+    self
     dill
     scripts
 
+.. automodule:: dill
+..  :exclude-members: +
+
 Indices and tables
 ==================