From 84844eb4c6c4127e6380d72c7336338d1b8b70b4 Mon Sep 17 00:00:00 2001
From: "Taylor C. Richberger" <taywee@gmx.com>
Date: Wed, 14 Aug 2019 15:53:18 -0600
Subject: [PATCH] add support for missing toctree theme_options

navigation.html's toctree was missing support for maxdepth and
titles_only.
---
 alabaster/navigation.html |  7 ++++++-
 alabaster/theme.conf      |  2 ++
 docs/customization.rst    | 13 +++++++++----
 3 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/alabaster/navigation.html b/alabaster/navigation.html
index 760dcc9..cd32206 100644
--- a/alabaster/navigation.html
+++ b/alabaster/navigation.html
@@ -1,5 +1,10 @@
 <h3>{{ _('Navigation') }}</h3>
-{{ toctree(includehidden=theme_sidebar_includehidden, collapse=theme_sidebar_collapse) }}
+{{ toctree(
+    collapse=theme_sidebar_collapse,
+    maxdepth=theme_sidebar_maxdepth|int,
+    titles_only=theme_sidebar_titles_only,
+    includehidden=theme_sidebar_includehidden
+) }}
 {% if theme_extra_nav_links %}
 <hr />
 <ul>
diff --git a/alabaster/theme.conf b/alabaster/theme.conf
index b6cdc8d..e5376e0 100644
--- a/alabaster/theme.conf
+++ b/alabaster/theme.conf
@@ -34,6 +34,8 @@ show_relbar_bottom =
 show_relbar_top =
 show_relbars = false
 sidebar_collapse = true
+sidebar_maxdepth = 2
+sidebar_titles_only = false
 sidebar_includehidden = true
 sidebar_width = 220px
 tidelift_url =
diff --git a/docs/customization.rst b/docs/customization.rst
index 11c245f..8f8ac7f 100644
--- a/docs/customization.rst
+++ b/docs/customization.rst
@@ -173,10 +173,15 @@ Sidebar-related options that aren't directly related to service links.
     header/footer options; the two visual components are orthogonal and may be
     enabled/disabled independently of one another.
 
-* ``sidebar_collapse``: Boolean determining whether all TOC entries that
-   are not ancestors of the current page are collapsed.
-   You can read more about this in the Sphinx toctree
-   `docs <http://www.sphinx-doc.org/en/stable/templating.html#toctree>`_.
+* ``sidebar_collapse``: Boolean determining whether all TOC entries that are not
+  ancestors of the current page are collapsed.  You can read more about this
+  and the following settings in the Sphinx toctree
+  `docs <http://www.sphinx-doc.org/en/stable/templating.html#toctree>`_.
+* ``sidebar_maxdepth``: Integer setting the maximum depth the sidebar will
+  expand to.  This defaults to 2.  You may set this to -1 to disable limiting
+  the depth. 
+* ``sidebar_titles_only``: Boolean determining whether the sidebar will show
+  only page titles or all page sections.
 * ``sidebar_includehidden``: Boolean determining whether the TOC sidebar
   should include hidden Sphinx toctree elements. Defaults to ``true`` so you
   can use ``:hidden:`` in your index page's root toctree & avoid having 2x