Show the deployed version in the footer, linked to the changelog

Author: C4ptainCrunch

CHANGELOG.md

@@ -4,8 +4,12 @@ This page tries to contain all use facing changes made on DocHub.
 
 # Unreleased
 
+ * Show the deployed version in the footer, linked to the changelog
+
 # 2026.5.3
 
+*No user facing changes*
+
 # 2026.5.2
 
  * Add a /stats/ page with charts of DocHub activity over time

www/context_processors.py

@@ -10,3 +10,7 @@ def sentry(context):
         "SENTRY_DSN": getattr(settings, "SENTRY_DSN", None),
         "SENTRY_RELEASE": getattr(settings, "SENTRY_RELEASE", None),
     }
+
+
+def version(context):
+    return {"GIT_DESCRIBE": getattr(settings, "GIT_DESCRIBE", None)}

www/settings.py

@@ -1,4 +1,5 @@
 import logging
+import subprocess
 from pathlib import Path
 
 import environ
@@ -89,6 +90,7 @@
                 "django.contrib.messages.context_processors.messages",
                 "www.context_processors.read_only",
                 "www.context_processors.sentry",
+                "www.context_processors.version",
             ],
         },
     },
@@ -155,6 +157,24 @@
 SENTRY_DSN = env("SENTRY_DSN", default=None)
 SENTRY_RELEASE = get_default_release()
 
+
+def _git_describe() -> str | None:
+    try:
+        result = subprocess.run(
+            ["git", "describe", "--tags", "--dirty", "--always"],
+            cwd=BASE_DIR,
+            capture_output=True,
+            text=True,
+            timeout=2,
+            check=True,
+        )
+    except (subprocess.SubprocessError, FileNotFoundError):
+        return None
+    return result.stdout.strip() or None
+
+
+GIT_DESCRIBE = _git_describe()
+
 FILE_STORAGE = "django.core.files.storage.FileSystemStorage"
 
 # Only configure S3 storage if we have a STORAGE_ENDPOINT env variable else, default to the local filesystem

www/templates/base.html

@@ -251,6 +251,14 @@
                         <span class="text-muted mx-1">&bull;</span>
                         <a href="{% url 'stats' %}">Stats</a>
                     {% endif %}
+                    {% if GIT_DESCRIBE %}
+                        <span class="text-muted mx-1">&bull;</span>
+                        <a href="https://github.com/UrLab/dochub/blob/main/CHANGELOG.md"
+                           class="text-muted text-decoration-none"
+                           title="Version déployée — voir le changelog">
+                            <small>{{ GIT_DESCRIBE }}</small>
+                        </a>
+                    {% endif %}
                 </div>
             </footer>
         {% endblock fullpage %}