Fix 2nd navigation level in left sidebar (pandas-dev#31)

Author: jorisvandenbossche

pandas_sphinx_theme/__init__.py

@@ -17,14 +17,17 @@
 # Sphinx monkeypatch for adding toctree objects into context
 
 
-def convert_docutils_node(list_item):
+def convert_docutils_node(list_item, only_pages=False):
     if not list_item.children:
         return None
     reference = list_item.children[0].children[0]
     title = reference.astext()
     url = reference.attributes["refuri"]
     active = "current" in list_item.attributes["classes"]
 
+    if only_pages and '#' in url:
+        return None
+        
     nav = {}
     nav["title"] = title
     nav["url"] = url
@@ -33,7 +36,7 @@ def convert_docutils_node(list_item):
 
     if len(list_item.children) > 1:
         for child_item in list_item.children[1].children:
-            child_nav = convert_docutils_node(child_item)
+            child_nav = convert_docutils_node(child_item, only_pages=only_pages)
             if child_nav is not None:
                 nav["children"].append(child_nav)
 
@@ -50,7 +53,7 @@ def get_nav_object(**kwds):
 
         nav = []
         for child in toctree.children[0].children:
-            child_nav = convert_docutils_node(child)
+            child_nav = convert_docutils_node(child, only_pages=True)
             nav.append(child_nav)
 
         return nav

pandas_sphinx_theme/docs-sidebar.html

@@ -7,18 +7,19 @@
 <nav class="bd-links" id="bd-docs-nav" aria-label="Main navigation">
 
   <div class="bd-toc-item active">
-  {% set nav = get_nav_object(maxdepth=2) %}
+  {% set nav = get_nav_object(maxdepth=3) %}
 
   <ul class="nav bd-sidenav">
       {% for main_nav_item in nav %}
       {% if main_nav_item.active %}
         {% for nav_item in main_nav_item.children %}
           {% if nav_item.children %}
 
-              <li>{{ nav_item.title }}
+              <li class="{% if nav_item.active%}active{% endif %}">
+                  <a href="{{ nav_item.url }}">{{ nav_item.title }}</a>
                   <ul>
                   {% for nav_item in nav_item.children %}
-                      <li class="{% if nav_item.active%}active bd-sidenav-active{% endif %}">
+                      <li class="{% if nav_item.active%}active{% endif %}">
                           <a href="{{ nav_item.url }}">{{ nav_item.title }}</a>
                       </li>
                   {% endfor %}

pandas_sphinx_theme/static/css/custom.css

@@ -159,7 +159,7 @@
   .bd-toc-item.active > .bd-sidenav {
     display: block;
   }
-  
+
   .bd-sidebar .nav > li > a {
     display: block;
     padding: .25rem 1.5rem;
@@ -183,7 +183,25 @@
     background-color: transparent; */
   }
 
-  
+  .bd-sidebar .nav > li > ul {
+    list-style: none;
+    padding: .25rem 1.5rem;
+  }
+
+  .bd-sidebar .nav > li > ul > li > a {
+    display: block;
+    padding: .25rem 1.5rem;
+    font-size: 90%;
+    color: rgba(0, 0, 0, 0.65);
+  }
+
+  .bd-sidebar .nav > li > ul > .active > a,
+  .bd-sidebar .nav > li > ul > .active:hover > a {
+    font-weight: 600;
+    background: #007bff;
+    color: white;
+  }
+
 /* offsetting html anchor titles to adjust for fixed header, https://github.com/pandas-dev/pandas-sphinx-theme/issues/6*/
   h2::before, h3::before, 
   h4::before, h5::before,