From 24a8207e0a572d1f733b58159c9803fba319f983 Mon Sep 17 00:00:00 2001
From: Sylvestre Ledru <sylvestre@debian.org>
Date: Sun, 22 Mar 2026 20:40:25 +0100
Subject: [PATCH] Auto-detect locales in build-docs-l10n.sh from coreutils
 source

Replace hardcoded FTL_TO_URL and LANG_NAMES maps with dynamic
detection. ftl_to_url() derives URL codes from FTL filenames
(e.g., fr-FR -> fr, zh-Hans -> zh-Hans). locale_display_name()
uses python3+babel for native language names with fallback to the
code itself. New locales are now picked up automatically without
editing the scripts.
---
 scripts/build-docs-l10n.sh    | 19 ++++++++----
 scripts/patch-mdbook-theme.sh | 54 ++++++++++++++++++++++-------------
 2 files changed, 47 insertions(+), 26 deletions(-)

diff --git a/scripts/build-docs-l10n.sh b/scripts/build-docs-l10n.sh
index 94493f7b5..ea47afec2 100755
--- a/scripts/build-docs-l10n.sh
+++ b/scripts/build-docs-l10n.sh
@@ -14,11 +14,18 @@ set -euo pipefail
 
 COREUTILS_DIR="$(cd "${1:?Usage: $0 <coreutils-dir>}" && pwd)"
 
-# ftl filename -> URL lang code (when they differ)
-declare -A FTL_TO_URL=(
-  [fr-FR]="fr" [es-ES]="es" [zh-Hans]="zh" [zh-Hant]="zh-Hant"
-  [pt-BR]="pt-BR" [nb-NO]="nb-NO"
-)
+# Convert FTL locale code to URL code: strip region when language == region
+# (e.g., fr-FR -> fr, es-ES -> es) but keep distinct ones (zh-Hans, pt-BR, nb-NO)
+ftl_to_url() {
+  local code="$1"
+  local lang="${code%%-*}"
+  local region="${code#*-}"
+  if [ "${region,,}" = "${lang,,}" ]; then
+    echo "$lang"
+  else
+    echo "$code"
+  fi
+}
 
 # Discover available locales from the coreutils source (l10n already copied in)
 # Use ls utility as reference
@@ -27,7 +34,7 @@ for ftl in "$COREUTILS_DIR"/src/uu/ls/locales/*.ftl; do
   [ -f "$ftl" ] || continue
   ftl_name=$(basename "$ftl" .ftl)
   [ "$ftl_name" = "en-US" ] && continue
-  url_code="${FTL_TO_URL[$ftl_name]:-$ftl_name}"
+  url_code=$(ftl_to_url "$ftl_name")
   LANG_MAP[$url_code]="$ftl_name"
 done
 
diff --git a/scripts/patch-mdbook-theme.sh b/scripts/patch-mdbook-theme.sh
index 609c6b9e4..04d16cd9e 100755
--- a/scripts/patch-mdbook-theme.sh
+++ b/scripts/patch-mdbook-theme.sh
@@ -9,25 +9,39 @@ L10N_DIR="${2:?Usage: $0 <coreutils-docs-dir> <coreutils-l10n-dir>}"
 
 HEAD_HBS="$DOCS_DIR/theme/head.hbs"
 
-# Language display names (ftl filename -> display name)
-declare -A LANG_NAMES=(
-  [en-US]="English"
-  [ar]="العربية" [ast]="Asturianu" [ca]="Català" [cs]="Čeština"
-  [da]="Dansk" [de]="Deutsch" [eo]="Esperanto" [es-ES]="Español"
-  [fi]="Suomi" [fr-FR]="Français" [he]="עברית" [id]="Bahasa Indonesia"
-  [it]="Italiano" [ja]="日本語" [kab]="Taqbaylit" [ko]="한국어"
-  [nb-NO]="Norsk Bokmål" [ne]="नेपाली" [pl]="Polski" [pt]="Português"
-  [pt-BR]="Português (Brasil)" [ru]="Русский" [sv]="Svenska"
-  [tr]="Türkçe" [uk]="Українська" [vi]="Tiếng Việt"
-  [zh-Hans]="中文 (简体)" [zh-Hant]="中文 (繁體)"
-)
+# Convert FTL locale code to URL code: strip region when language == region
+# (e.g., fr-FR -> fr, es-ES -> es) but keep distinct ones (zh-Hans, pt-BR, nb-NO)
+ftl_to_url() {
+  local code="$1"
+  local lang="${code%%-*}"
+  local region="${code#*-}"
+  # If region is the language uppercased (fr-FR, es-ES, etc.), simplify to just the language
+  if [ "${region,,}" = "${lang,,}" ]; then
+    echo "$lang"
+  else
+    echo "$code"
+  fi
+}
 
-# ftl filename -> URL lang code (used in /coreutils/docs-{code}/)
-declare -A FTL_TO_URL=(
-  [en-US]="en" [fr-FR]="fr" [es-ES]="es" [zh-Hans]="zh" [zh-Hant]="zh-Hant"
-  [pt-BR]="pt-BR" [nb-NO]="nb-NO"
-)
-# For others, the ftl name IS the URL code (ar, de, it, ja, etc.)
+# Generate display name for a locale code
+# Uses python3+babel if available, otherwise falls back to the code itself
+locale_display_name() {
+  local code="$1"
+  if command -v python3 > /dev/null 2>&1; then
+    local name
+    name=$(python3 -c "
+try:
+    from babel import Locale
+    print(Locale.parse('${code}'.replace('-', '_')).get_display_name())
+except Exception:
+    print('${code}')
+" 2>/dev/null)
+    # Capitalize first letter for consistency
+    echo "${name^}"
+  else
+    echo "$code"
+  fi
+}
 
 # Scan l10n repo to find which locales have translations
 # Use a representative utility (ls) to find available locales
@@ -37,8 +51,8 @@ for ftl in "$L10N_DIR"/src/uu/ls/locales/*.ftl; do
   ftl_name=$(basename "$ftl" .ftl)
   [ "$ftl_name" = "en-US" ] && continue
 
-  display="${LANG_NAMES[$ftl_name]:-$ftl_name}"
-  url_code="${FTL_TO_URL[$ftl_name]:-$ftl_name}"
+  url_code=$(ftl_to_url "$ftl_name")
+  display=$(locale_display_name "$ftl_name")
   LANGS_JSON="$LANGS_JSON, ['$url_code', '$display']"
 done