From bcaeb4dd5bd8d46e4f3e1887e967cea199ce0e27 Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Fri, 11 Jul 2025 10:20:10 +0200 Subject: [PATCH] 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 | 194 ++++++++++++++++++++++++++- user_manual/conf.py | 4 + 3 files changed, 192 insertions(+), 8 deletions(-) diff --git a/user_manual/Makefile b/user_manual/Makefile index 4389b6b38..91207f1ac 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..455206872 100644 --- a/user_manual/_templates/versions.html +++ b/user_manual/_templates/versions.html @@ -1,22 +1,202 @@ {% 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.