Merge pull request #1024 from xylar/add-version-side-bar

Add versions to sidebar

Author: xylar

docs/_templates/versions.html

@@ -0,0 +1,28 @@
+{%- 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 %}
+

docs/conf.py

@@ -42,6 +42,9 @@
               'sphinx.ext.viewcode',
               'sphinx.ext.napoleon']
 
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
 autosummary_generate = True
 
 # Otherwise, the Return parameter list looks different from the Parameters list