Generate docs for stable and develop

docs/_templates/layout.html

@@ -0,0 +1,16 @@
+{% extends "!layout.html" %}
+
+{% block document %}
+
+  {% if current_version.name == "develop" %}
+    <div class="admonition warning">
+      <p class="admonition-title">Warning</p>
+      <p>This documentation only applies for the development version of
+      Funkwhale! <a href="{{ vpathto('stable') }}">Visit the docs for the latest
+      release.</a></p>
+    </div>
+  {% endif %}
+
+{{ super() }}
+
+{% endblock %}

docs/_templates/versions.html

@@ -0,0 +1,19 @@
+{%- 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>
+    {{ current_version.name }}
+    <span class="fa fa-caret-down"></span>
+  </span>
+  <div class="rst-other-versions">
+    {%- if versions.branches %}
+    <dl>
+      <dt>Versions</dt>
+      {%- for item in versions.branches %}
+      <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+      {%- endfor %}
+    </dl>
+    {%- endif %}
+  </div>
+</div>
+{%- endif %}

docs/build_docs.sh

@@ -1,6 +1,6 @@
 #!/bin/bash -eux
 # Building sphinx and swagger docs
-python -m sphinx . $BUILD_PATH
+poetry run sphinx-multiversion . $BUILD_PATH
 TARGET_PATH="$BUILD_PATH/swagger" ./build_swagger.sh
 python ./get-releases-json.py > $BUILD_PATH/releases.json
 python ./get-releases-json.py --latest > $BUILD_PATH/latest.txt

docs/conf.py

@@ -20,7 +20,7 @@
 import os
 import sys
 import datetime
-from shutil import copyfile
+import subprocess
 
 sys.path.insert(0, os.path.abspath("../api"))
 sys.path.insert(0, os.path.abspath("../api/config"))
@@ -51,6 +51,7 @@ extensions = [
     "sphinx.ext.autodoc",
     "myst_parser",
     "sphinx_panels",
+    "sphinx_multiversion",
 ]
 autodoc_mock_imports = [
     "celery",
@@ -83,10 +84,7 @@ author = "The Funkwhale Collective"
 # built documents.
 #
 # The short X.Y version.
-version = funkwhale_api.__version__
+version = subprocess.check_output(["git", "describe", "--tags"]).strip().decode("utf-8")
-if "-dev" in version:
-    version = "develop"
-# The full version, including alpha/beta/rc tags.
 release = version
 
 # The language for content autogenerated by Sphinx. Refer to documentation
@@ -267,3 +265,7 @@ def copy_legacy_redirects(app, docname):
 
 def setup(app):
     app.connect("build-finished", copy_legacy_redirects)
+
+
+smv_tag_whitelist = None
+smv_branch_whitelist = r"(stable|develop)$"