fix: version picker shows wrong version, missing page redirect, unclear stable label

- Use `release` instead of `version` for `current_version` so the picker
  button reflects the actual built version (e.g. 33) instead of always
  showing 'latest'
- Stringify int version slugs in generateVersionsDocs so that
  current_version == slug comparisons work correctly
- Expose `version_stable` in html_context; templates now render
  'stable (33)' so users know which version stable maps to
- Append `/{{ pagename }}.html` to version picker hrefs so switching
  versions lands on the same page, not the manual root

Fixes #13821

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: skjnldsv <skjnldsv@protonmail.com>

Author: skjnldsv

admin_manual/_templates/versions.html

@@ -17,12 +17,12 @@
         <dt>☁️ {{ _('Versions') }}</dt>
         {% for slug, url in versions|reverse %}
         <dd style="width: 32%">
-          <a href="{{ url }}"
+          <a href="{{ url }}/{{ pagename }}.html"
              {% if current_version == slug %}
              style="color: var(--dark-link-color);"
              {% endif %}
           >
-            {{ slug }}
+            {{ slug if slug != 'stable' else 'stable (' ~ version_stable ~ ')' }}
           </a>
         </dd>
         {% endfor %}

conf.py

@@ -82,7 +82,7 @@ def generateVersionsDocs(current_docs):
 	versions_doc = []
 	for v in range(version_start, version_stable + 1):
 		url = 'https://docs.nextcloud.com/server/%s/%s' % (str(v), current_docs)
-		versions_doc.append(tuple((v, url)))
+		versions_doc.append(tuple((str(v), url)))
 	versions_doc.append(tuple(('stable', 'https://docs.nextcloud.com/server/%s/%s' % ('stable', current_docs))))
 	versions_doc.append(tuple(('latest', 'https://docs.nextcloud.com/server/%s/%s' % ('latest', current_docs))))
 	return versions_doc
@@ -93,7 +93,8 @@ def generateVersionsDocs(current_docs):
 	github_branch = 'master'
 
 html_context = {
-	'current_version': version,
+	'current_version': release,
+	'version_stable': str(version_stable),
 	'READTHEDOCS': True,
 
 	# force github plugin

developer_manual/_templates/versions.html

@@ -17,12 +17,12 @@
         <dt>☁️ {{ _('Versions') }}</dt>
         {% for slug, url in versions|reverse %}
         <dd style="width: 32%">
-          <a href="{{ url }}"
+          <a href="{{ url }}/{{ pagename }}.html"
              {% if current_version == slug %}
              style="color: var(--dark-link-color);"
              {% endif %}
           >
-            {{ slug }}
+            {{ slug if slug != 'stable' else 'stable (' ~ version_stable ~ ')' }}
           </a>
         </dd>
         {% endfor %}

user_manual/_templates/versions.html

@@ -92,12 +92,12 @@
         <dt>☁️ {{ _('Versions') }}</dt>
         {% for slug, url in versions|reverse %}
           <dd style="width: 32%">
-            <a href="{{ url }}"
+            <a href="{{ url }}/{{ pagename }}.html"
                {% if current_version == slug %}
                style="color: var(--dark-link-color);"
                {% endif %}
             >
-              {{ slug }}
+              {{ slug if slug != 'stable' else 'stable (' ~ version_stable ~ ')' }}
             </a>
           </dd>
         {% endfor %}