fix(theme): tolerate hyphenated locale keys for Sphinx 9

Sphinx 9 normalizes the `language` config to hyphenated BCP-47 form
(e.g. `de-DE`) before passing it into the Jinja template context, but
`load_languages()` keyed the `languages` dict on the underscored form
derived from Crowdin's locale strings. `versions.html` rendering then
raised `KeyError('de-DE')` on every per-locale build.

`get_language_code` and `get_language_display_name` now accept either
form and fall back to the underscored variant, keeping the theme
compatible with Sphinx 7, 8, and 9 without touching `.po`/`.mo` naming.

Bumps version to 1.2.4.

Signed-off-by: Gabriel Harris-Rouquette <gabizou@me.com>

Author: gabizou

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.2.4
+
+- Fix `KeyError` during per-locale builds on Sphinx 9. Sphinx 9 normalizes the
+  `language` config to the hyphenated BCP-47 form (e.g. `de-DE`) before passing
+  it to the Jinja template context, but the theme's `languages` dict is keyed
+  in the underscored form that Crowdin's locale strings are rewritten to at
+  load time. `get_language_code` / `get_language_display_name` now accept
+  either form and fall back to the underscored variant, so the `versions.html`
+  template renders cleanly under Sphinx 7, 8, and 9.
+
 ## 1.2.3
 
 - Register `translations.js` via `builder.add_js_file()` instead of appending to

src/theme/__init__.py

@@ -1,4 +1,4 @@
-VERSION = (1, 2, 3)
+VERSION = (1, 2, 4)
 __version__ = '.'.join(str(v) for v in VERSION)
 
 

src/theme/languages.py

@@ -12,12 +12,24 @@
 languages = None
 
 
+def _lookup_language(locale_code):
+    # Sphinx <=8 passes the language config through untouched (e.g. ``de_DE``);
+    # Sphinx 9 normalizes it to the hyphenated BCP-47 form (``de-DE``) before it
+    # reaches template context. Our ``languages`` dict is keyed in underscored
+    # form, so accept either and fall back to the underscored variant.
+    if locale_code in languages:
+        return locale_code, languages[locale_code]
+    normalized = locale_code.replace('-', '_')
+    return normalized, languages[normalized]
+
+
 def get_language_code(locale_code):
-    return languages[locale_code]['code']
+    _, lang = _lookup_language(locale_code)
+    return lang['code']
 
 
 def get_language_display_name(locale_code):
-    lang = languages[locale_code]
+    resolved_code, lang = _lookup_language(locale_code)
 
     # Compute display name if not already cached
     if 'display_name' not in lang:
@@ -33,7 +45,7 @@ def get_language_display_name(locale_code):
                 locale.territory = None
 
             try:
-                lang['display_name'] = locale.languages[locale_code].title()
+                lang['display_name'] = locale.languages[resolved_code].title()
             except KeyError:
                 lang['display_name'] = locale.language_name.title()
         except babel.UnknownLocaleError: