add versions

Author: Samoed

docs/source/_templates/versioning.html

@@ -9,6 +9,7 @@
 import os
 import sys
 from pathlib import Path
+from importlib.metadata import version
 
 conf_dir = os.path.dirname(os.path.abspath(__file__))  # noqa: PTH100, PTH120
 
@@ -83,7 +84,9 @@
 
 html_theme = "pydata_sphinx_theme"
 html_static_path = ["../_static"]
+version = version("autointent").replace("dev", "")  # may differ
 
+BASE_URL = "https://deeppavlov.github.io/AutoIntent"
 html_theme_options = {
     "logo": {
         "text": "AutoIntent",
@@ -104,6 +107,11 @@
             "type": "local",
         },
     ],
+    "switcher": {
+        "json_url": f"{BASE_URL}/_static/versions.json",
+        "version_match": version,
+    },
+    "navbar_start": ["navbar-logo", "version-switcher"],
     "show_toc_level": 3,
 }
 
@@ -133,11 +141,11 @@
     "user_guides/*": "_static/square-white.svg",
 }
 
-html_sidebars = {
-    '**': [
-        'versioning.html',
-    ],
-}
+# html_sidebars = {
+#     '**': [
+#         'versioning.html',
+#     ],
+# }
 
 mathjax_path = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
 
@@ -156,7 +164,7 @@
 
 repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', ".."))  # if conf.py is in docs/
 def setup(app) -> None:  # noqa: ANN001
-    generate_versions_json(app, repo_root)
+    generate_versions_json(app, repo_root, BASE_URL)
     # versions = get_sorted_versions()
     # with open('docs/source/_static/versions.json', 'w') as f:
     #     json.dump(versions, f, indent=4)

docs/source/conf.py

@@ -9,7 +9,7 @@
 import subprocess
 
 
-def get_sorted_versions(repo_root):
+def get_sorted_versions(repo_root, base_url):
     # Get the git repository root
     tags_output = subprocess.check_output(['git', '-C', repo_root, 'tag'], text=True).strip().split('\n')
     # Change to the repository root
@@ -34,13 +34,14 @@ def version_key(tag):
         versions.append({
             "name": f"{sorted_tags[0]} (stable)",
             "version": sorted_tags[0].lstrip('v'),
-            "url": f"/{sorted_tags[0].lstrip('v')}/"
+            "url": f"{base_url}/{sorted_tags[0].lstrip('v')}/",
+            "preferred": True,
         })
 
     for tag in sorted_tags[1:]:
         versions.append({
             "version": tag.lstrip('v'),
-            "url": f"/{tag.lstrip('v')}/"
+            "url": f"{base_url}/{tag.lstrip('v')}/"
         })
 
     # Get branches
@@ -55,13 +56,13 @@ def version_key(tag):
     for branch in dev_branches:
         versions.append({
             "version": f"{branch} (dev)",
-            "url": f"/{branch}/"
+            "url": f"{base_url}/{branch}/"
         })
 
     return versions
 
 
-def generate_versions_json(app, repo_root):
+def generate_versions_json(app, repo_root, base_url):
     """
     Sphinx extension to generate versions.json during documentation build.
     """