Fallback to en if locale is not available for version

Author: Felix Kleinekathoefer

src/theme/context.py

@@ -6,6 +6,16 @@ def _split_environment_variable(name):
     return value and value.split()
 
 
+def build_locale_map():
+    locales = {}
+    for k, v in os.environ.items():
+        if not k.startswith("LOCALES_"):
+            continue
+        k = k[len("LOCALES_"):].replace('_', '.')
+        locales[k.lower()] = v.split()
+    return locales
+
+
 def setup_html_context():
     github_user = os.environ.get('GITHUB_USER')
     github_repo = os.environ.get('GITHUB_REPO')
@@ -16,7 +26,7 @@ def setup_html_context():
         'conf_py_path': '/source/',
 
         # List of supported languages
-        'locales': _split_environment_variable('LOCALES'),
+        'locales': build_locale_map(),
 
         # Current version and list of documented versions
         'current_version': os.environ.get('VERSION'),

src/theme/scripts/list-translations

@@ -40,8 +40,8 @@ for language in r.json()['data']:
     if language['data']['translationProgress'] >= 5 or language['data']['languageId'].startswith('en-'):
         locales.append(languages[language['data']['languageId']])
     else:
-        print("Skipping %s with %d%% completion" %
-              (language['data']['languageId'], language['data']['translationProgress']), file=sys.stderr)
+        print("[%s] Skipping %s with %d%% completion" %
+              (branchId, language['data']['languageId'], language['data']['translationProgress']), file=sys.stderr)
 
 # Sort locales
 locales.sort()

src/theme/templates/versions.html

@@ -17,10 +17,10 @@
     <div id="versions" class="rst-other-versions">
 
         {# Languages #}
-        {% if locales %}
+        {% if locales[current_version] %}
             <dl id="languages">
                 <dt>{% trans %}Languages{% endtrans %}</dt>
-                {% for locale in locales %}
+                {% for locale in locales[current_version] %}
                     {% if locale != 'translate' %}
                         <dd><a href="{{ page_link(language=locale) }}">{{ language_flag(locale) }}</a></dd>
                     {% endif %}
@@ -33,8 +33,15 @@
             <dl>
                 <dt>{% trans %}Versions{% endtrans %}</dt>
                 {% for version in versions %}
-                    <dd><a {{ mark_current(version, current_version) }}
-                            href="{{ page_link(version=version) }}">{{ version }}</a></dd>
+                    <dd>
+                        {%  if language and language in locales[version] %}
+                        <a {{ mark_current(version, current_version) }}
+                            href="{{ page_link(version=version) }}">{{ version }}
+                        </a>
+                        {% else %}
+                        <a href="{{ page_link(version=version, language="en") }}">{{ version }} (en)</a>
+                        {% endif %}
+                    </dd>
                 {% endfor %}
             </dl>
         {% endif %}
@@ -48,14 +55,14 @@
         {% endif %}
 
         {# Contribute #}
-        {% if github_page_link or (locales and 'translate' in locales) %}
+        {% if github_page_link or (locales and 'translate' in locales[current_version]) %}
             <dl>
                 <dt>{% trans %}Contribute{% endtrans %}</dt>
                 {% if github_page_link %}
                     <dd><a href="{{ github_page_link() }}">{{ _("Source") }}</a></dd>
                     <dd><a href="{{ github_page_link('edit') }}">{{ _("Edit") }}</a></dd>
                 {% endif %}
-                {% if locales and 'translate' in locales %}
+                {% if locales and 'translate' in locales[current_version] %}
                     <dd><a href="{{ page_link(language='translate') }}">{{ _("Translate") }}</a></dd>
                 {% endif %}
             </dl>