sidebar template

docs/source/conf.py

@@ -34,11 +34,12 @@
 # -- Options for EPUB output
 epub_show_urls = 'footnote'
 
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
 html_sidebars = {
     '**': [
-        # 'relations.html',  # needs 'show_related': True theme option to display
-        'searchbox.html',
-    ]
+        '_templates/versions.html',
+    ],
 }
 
 # autosummary_generate = True

docs/source/templates/versions.html

@@ -0,0 +1,27 @@
+{%- if current_version %}
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
+    <span class="rst-current-version" data-toggle="rst-current-version">
+        <span class="fa fa-book"> Other Versions</span>
+        v: {{ current_version.name }}
+        <span class="fa fa-caret-down"></span>
+    </span>
+    <div class="rst-other-versions">
+        {%- if versions.tags %}
+        <dl>
+            <dt>Tags</dt>
+            {%- for item in versions.tags %}
+            <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+            {%- endfor %}
+        </dl>
+        {%- endif %}
+        {%- if versions.branches %}
+        <dl>
+            <dt>Branches</dt>
+            {%- for item in versions.branches %}
+            <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+            {%- endfor %}
+        </dl>
+        {%- endif %}
+    </div>
+</div>
+{%- endif %}