From 58a9d8fedf630506e96d57d659e3d6be33d9b654 Mon Sep 17 00:00:00 2001
From: Chris Holdgraf <choldgraf@berkeley.edu>
Date: Tue, 5 Nov 2019 00:38:27 -0800
Subject: [PATCH] Fix parsing of multiple toctree directives on a single page /
 with a caption (#50)

---
 pandas-docs/source/index.rst.template |  6 ++++++
 pandas_sphinx_theme/__init__.py       | 12 +++++++++---
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/pandas-docs/source/index.rst.template b/pandas-docs/source/index.rst.template
index 7ae67cad29c7a..224e784164f52 100644
--- a/pandas-docs/source/index.rst.template
+++ b/pandas-docs/source/index.rst.template
@@ -53,6 +53,12 @@ See the :ref:`overview` for more detail about what's in the library.
     whatsnew/index
 {% endif -%}
 
+.. toctree::
+    :maxdepth: 2
+    :caption: An extra caption. This item should be at the end of page nav (and duplicated)
+
+    development/index
+
 
 * :doc:`whatsnew/v0.25.0`
 * :doc:`install`
diff --git a/pandas_sphinx_theme/__init__.py b/pandas_sphinx_theme/__init__.py
index 7a35c945b4374..b0a9165459825 100644
--- a/pandas_sphinx_theme/__init__.py
+++ b/pandas_sphinx_theme/__init__.py
@@ -8,7 +8,7 @@
 import sphinx.builders.html
 
 from .bootstrap_html_translator import BootstrapHTML5Translator
-
+import docutils
 
 __version__ = "0.0.1.dev0"
 
@@ -27,7 +27,7 @@ def convert_docutils_node(list_item, only_pages=False):
 
     if only_pages and '#' in url:
         return None
-        
+
     nav = {}
     nav["title"] = title
     nav["url"] = url
@@ -47,18 +47,24 @@ def update_page_context(self, pagename, templatename, ctx, event_arg):
     from sphinx.environment.adapters.toctree import TocTree
 
     def get_nav_object(**kwds):
+        """Return a list of nav links that can be accessed from Jinja."""
         toctree = TocTree(self.env).get_toctree_for(
             pagename, self, collapse=True, **kwds
         )
 
+        # Grab all TOC links from any toctrees on the page
+        toc_items = [item for child in toctree.children for item in child
+                     if isinstance(item, docutils.nodes.list_item)]
+
         nav = []
-        for child in toctree.children[0].children:
+        for child in toc_items:
             child_nav = convert_docutils_node(child, only_pages=True)
             nav.append(child_nav)
 
         return nav
 
     def get_page_toc_object():
+        """Return a list of within-page TOC links that can be accessed from Jinja."""
         self_toc = TocTree(self.env).get_toc_for(pagename, self)
 
         try: