From 55172ba446764ae08083193b3e625968d2b2c2f9 Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Fri, 11 Jul 2025 10:20:10 +0200 Subject: [PATCH 1/3] feat(user_manual): Make translations more visible by adding language to dropdown handle Signed-off-by: Joas Schilling --- user_manual/Makefile | 2 +- user_manual/_templates/versions.html | 193 ++++++++++++++++++++++++++- user_manual/conf.py | 4 + 3 files changed, 192 insertions(+), 7 deletions(-) diff --git a/user_manual/Makefile b/user_manual/Makefile index 94054b137..558c86df6 100644 --- a/user_manual/Makefile +++ b/user_manual/Makefile @@ -53,7 +53,7 @@ html: versions-template-all: $(foreach lang, $(LANGS), add-lang-to-versions-template-$(lang)) add-lang-to-versions-template-%: - sed -i '/Here goes the Langs/i
$*
' ./_templates/versions.html + sed -i '/Here go the languages/i {% set available_languages = available_languages + ["$*"] %}' ./_templates/versions.html html-all: $(foreach lang, $(LANGS), html-allow-warnings-lang-$(lang)) diff --git a/user_manual/_templates/versions.html b/user_manual/_templates/versions.html index 39ab4da93..196113dcd 100644 --- a/user_manual/_templates/versions.html +++ b/user_manual/_templates/versions.html @@ -1,22 +1,203 @@ {% if READTHEDOCS %} {# Add rst-badge after rst-versions for small badge style. #} + + {% set available_languages = available_languages|sort %}
Read the Docs - v: {{ current_version }} + 🌐 + {% set language_code = language %} + {% if language_code == 'cs' %} + Czech + {% elif language_code == 'da' %} + Danish + {% elif language_code == 'de' %} + German + {% elif language_code == 'el' %} + Greek + {% elif language_code == 'es' %} + Spanish + {% elif language_code == 'en' %} + English + {% elif language_code == 'fi_FI' %} + Finnish + {% elif language_code == 'fr' %} + French + {% elif language_code == 'hr' %} + Croatian + {% elif language_code == 'hu_HU' %} + Hungarian + {% elif language_code == 'id' %} + Indonesian + {% elif language_code == 'it' %} + Italian + {% elif language_code == 'ja_JP' %} + Japanese + {% elif language_code == 'ko' %} + Korean + {% elif language_code == 'mn' %} + Mongolian + {% elif language_code == 'nb_NO' %} + Norwegian + {% elif language_code == 'nl' %} + Dutch + {% elif language_code == 'pl' %} + Polish + {% elif language_code == 'pt_PT' %} + Portuguese + {% elif language_code == 'pt_BR' %} + Portuguese (BR) + {% elif language_code == 'ro' %} + Romanian + {% elif language_code == 'ru' %} + Russian + {% elif language_code == 'sk_SK' %} + Slovakian + {% elif language_code == 'sq' %} + Albanian + {% elif language_code == 'sr' %} + Slovenian + {% elif language_code == 'sv' %} + Swedish + {% elif language_code == 'tr' %} + Turkish + {% elif language_code == 'uk' %} + Ukrainian + {% elif language_code == 'uz' %} + Uzbek + {% elif language_code == 'vi' %} + Vietnamese + {% elif language_code == 'zh_CN' %} + Chinese + {% elif language_code == 'zh_HK' %} + Chinese (HK) + {% elif language_code == 'zh_TW' %} + Chinese (TW) + {% else %} + {{ language_code }} + {% endif %} + + +  ☁️ {{ current_version }}
-
Languages
- +
🌐 {{ _('Languages') }}
+ {% for language_code in available_languages %} +
+ + {% if language_code == 'af' %} + Afrikaans + {% elif language_code == 'ar' %} + Arabic + {% elif language_code == 'br' %} + Breton + {% elif language_code == 'ca' %} + Catalan + {% elif language_code == 'cs' %} + Czech + {% elif language_code == 'da' %} + Danish + {% elif language_code == 'de' %} + German + {% elif language_code == 'el' %} + Greek + {% elif language_code == 'eo' %} + Esperanto + {% elif language_code == 'es' %} + Spanish + {% elif language_code == 'en' %} + English + {% elif language_code == 'fi_FI' %} + Finnish + {% elif language_code == 'fr' %} + French + {% elif language_code == 'hr' %} + Croatian + {% elif language_code == 'hu_HU' %} + Hungarian + {% elif language_code == 'ga' %} + Irish + {% elif language_code == 'gl' %} + Glacian + {% elif language_code == 'id' %} + Indonesian + {% elif language_code == 'it' %} + Italian + {% elif language_code == 'ja_JP' %} + Japanese + {% elif language_code == 'ko' %} + Korean + {% elif language_code == 'mn' %} + Mongolian + {% elif language_code == 'nb_NO' %} + Norwegian (NB) + {% elif language_code == 'nl' %} + Dutch + {% elif language_code == 'nn' %} + Norwegian (NN) + {% elif language_code == 'pl' %} + Polish + {% elif language_code == 'pt_PT' %} + Portuguese + {% elif language_code == 'pt_BR' %} + Portuguese (BR) + {% elif language_code == 'ro' %} + Romanian + {% elif language_code == 'ru' %} + Russian + {% elif language_code == 'si' %} + Sinhala + {% elif language_code == 'sk_SK' %} + Slovakian + {% elif language_code == 'sq' %} + Albanian + {% elif language_code == 'sr' %} + Slovenian + {% elif language_code == 'sv' %} + Swedish + {% elif language_code == 'ta' %} + Tamil + {% elif language_code == 'tr' %} + Turkish + {% elif language_code == 'uk' %} + Ukrainian + {% elif language_code == 'uz' %} + Uzbek + {% elif language_code == 'vi' %} + Vietnamese + {% elif language_code == 'zh_CN' %} + Chinese + {% elif language_code == 'zh_HK' %} + Chinese (HK) + {% elif language_code == 'zh_TW' %} + Chinese (TW) + {% else %} + {{ language_code }} + {% endif %} + +
+ {% endfor %}
-
{{ _('Versions') }}
- {% for slug, url in versions %} -
{{ slug }}
+
☁️ {{ _('Versions') }}
+ {% for slug, url in versions|reverse %} +
+ + {{ slug }} + +
{% endfor %}
diff --git a/user_manual/conf.py b/user_manual/conf.py index 5d0b341fa..47657a496 100644 --- a/user_manual/conf.py +++ b/user_manual/conf.py @@ -308,6 +308,10 @@ current_docs = 'user_manual' html_context['versions'] = generateVersionsDocs(current_docs) html_context['theme_vcs_pageview_mode'] += current_docs +html_context['available_languages'] = [ + 'en', +] + # translation locale_dirs = ['locale/'] # path is example but recommended. gettext_compact = False # optional. From dc8ab79ffe9e7566d6d8d361aa999898f08720a7 Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Fri, 11 Jul 2025 14:09:07 +0200 Subject: [PATCH 2/3] fix: Don't show english twice Signed-off-by: Joas Schilling --- user_manual/conf.py | 1 - 1 file changed, 1 deletion(-) diff --git a/user_manual/conf.py b/user_manual/conf.py index 47657a496..a42eda15d 100644 --- a/user_manual/conf.py +++ b/user_manual/conf.py @@ -309,7 +309,6 @@ html_context['versions'] = generateVersionsDocs(current_docs) html_context['theme_vcs_pageview_mode'] += current_docs html_context['available_languages'] = [ - 'en', ] # translation From ccc5a51754f80d4275f1dd3aa51405a428354028 Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Fri, 11 Jul 2025 14:15:04 +0200 Subject: [PATCH 3/3] fix: Also adjust version selection in admin and developer docs Signed-off-by: Joas Schilling --- admin_manual/_templates/versions.html | 17 ++++++++++++----- developer_manual/_templates/versions.html | 17 ++++++++++++----- user_manual/_templates/versions.html | 1 - 3 files changed, 24 insertions(+), 11 deletions(-) diff --git a/admin_manual/_templates/versions.html b/admin_manual/_templates/versions.html index e8a3a5a13..70c5e22de 100644 --- a/admin_manual/_templates/versions.html +++ b/admin_manual/_templates/versions.html @@ -2,15 +2,22 @@ {# Add rst-badge after rst-versions for small badge style. #}
- Read the Docs - v: {{ current_version }} + ☁️ {{ current_version }}
-
{{ _('Versions') }}
- {% for slug, url in versions %} -
{{ slug }}
+
☁️ {{ _('Versions') }}
+ {% for slug, url in versions|reverse %} +
+ + {{ slug }} + +
{% endfor %}
diff --git a/developer_manual/_templates/versions.html b/developer_manual/_templates/versions.html index e8a3a5a13..70c5e22de 100644 --- a/developer_manual/_templates/versions.html +++ b/developer_manual/_templates/versions.html @@ -2,15 +2,22 @@ {# Add rst-badge after rst-versions for small badge style. #}
- Read the Docs - v: {{ current_version }} + ☁️ {{ current_version }}
-
{{ _('Versions') }}
- {% for slug, url in versions %} -
{{ slug }}
+
☁️ {{ _('Versions') }}
+ {% for slug, url in versions|reverse %} +
+ + {{ slug }} + +
{% endfor %}
diff --git a/user_manual/_templates/versions.html b/user_manual/_templates/versions.html index 196113dcd..455206872 100644 --- a/user_manual/_templates/versions.html +++ b/user_manual/_templates/versions.html @@ -4,7 +4,6 @@ {% set available_languages = available_languages|sort %}
- Read the Docs 🌐 {% set language_code = language %} {% if language_code == 'cs' %}