stable and latest subcategories in sphinx output (#144)

Author: clonker

docs/source/_templates/version.html

@@ -0,0 +1,23 @@
+<p class="caption">
+    <span class="caption-text">Version</span>
+</p>
+<ul>
+    <li class="toctree-l1">
+        <a class="reference internal" id="version-stable"
+           href="../stable/{{ pathto('index') if '.html' in pathto('index') else 'index.html' }}">Stable
+            ({{ version }})</a>
+    </li>
+    <li class="toctree-l1">
+        <a class="reference internal" id="version-latest"
+           href="../latest/{{ pathto('index') if '.html' in pathto('index') else 'index.html' }}">Latest</a>
+    </li>
+</ul>
+<script>
+    if (window.location.href.indexOf("stable") > -1) {
+        document.getElementById("version-stable").className = "reference internal current";
+        document.getElementById("version-latest").className = "reference internal";
+    } else {
+        document.getElementById("version-stable").className = "reference internal";
+        document.getElementById("version-latest").className = "reference internal current";
+    }
+</script>

docs/source/conf.py

@@ -30,6 +30,7 @@
 copyright = '2020, AI4Science Group'
 author = 'AI4Science Group'
 
+version = f"{deeptime.__version__.split('+')[0]}"
 # The full version, including alpha/beta/rc tags
 release = f"{deeptime.__version__}"
 
@@ -155,9 +156,10 @@ def filter(self, record: LogRecord) -> int:
     '**': [
         'about.html',
         'navigation.html',
+        'version.html',
         'relations.html',
         'searchbox.html',
-        'github_button.html'
+        'github_button.html',
     ]
 }