feat(i18n): francais comme langue principale, anglais accessible
Le site s'affiche desormais en francais par defaut, avec un selecteur de langue permettant de basculer vers l'anglais. Choix de conception : les chaines sources restent en anglais Elles servent d'identifiants gettext, et le francais est fourni par catalogue avec BABEL_DEFAULT_LOCALE = 'fr'. Le code reste ainsi dans une seule langue -- la meme que ses commentaires et docstrings -- tandis que ce qu'un membre voit est du francais. Consequence qui rend la migration praticable : une chaine non encore traduite retombe en anglais, pas sur un identifiant brut. Les gabarits peuvent donc etre migres un par un sans jamais laisser le site a moitie casse. Selection de la langue (app/i18n.py) 1. choix explicite via le selecteur, garde en session 2. sinon en-tete Accept-Language du navigateur, restreint a fr et en 3. sinon francais Un choix explicite prime toujours, y compris sur un navigateur anglophone. Selecteur Extrait en partiel et inclus dans les deux branches de la mise en page : barre laterale une fois connecte, ET page d'authentification. Quelqu'un qui ne lit pas la langue courante doit pouvoir en changer AVANT de se connecter -- le laisser derriere l'authentification aurait ete un defaut d'accessibilite. Chaque langue est ecrite dans sa propre langue. La route /lang/<locale> valide le Referer avant de rediriger : sans ce controle, elle constituait une redirection ouverte. Migre dans cette passe navigation complete, page de connexion, les cinq pages d'erreur, et l'integralite des messages flash de routes/auth.py. 64 chaines, dont aucune non traduite. Verification 25 tests, dont deux garde-fous d'integrite : un catalogue .mo manquant ou une entree non traduite font echouer la suite. Sans cela, une compilation oubliee servirait de l'anglais partout, en silence et sans rien dans les journaux. Un test existant a du etre corrige, et c'est instructif test_login_failure_message_does_not_reveal_account_existence cherchait la sous-chaine anglaise 'attempt(s) remaining'. La page etant desormais en francais, elle etait absente des deux cotes, l'assertion passait, et le mode strict a signale le faux succes. Le test comparait donc l'anglais, pas le comportement. Il compare desormais les messages flash rendus, quelle que soit la langue. La faille SEC-AUTH-006 reste ouverte, et le test la documente toujours. Les catalogues .po ET .mo sont versionnes : le deploiement est un simple miroir de fichiers, sans etape de compilation. messages.pot, regenerable, ne l'est pas. docs/translations.md documente le processus, les deux pieges (concatenation de phrases, traduction a l'import), et l'etat de la migration. A noter pour la suite : les chaines dans les blocs <script> ne peuvent pas etre balisees telles quelles, il faudra les passer par des attributs data- -- ce qui rejoint le chantier de sortie de unsafe-inline (OPS-010). Co-Authored-By: Claude Opus 5 <[email protected]>
This commit is contained in:
+75
@@ -0,0 +1,75 @@
|
||||
"""Language selection.
|
||||
|
||||
French is the primary language of the site; English remains available.
|
||||
|
||||
Source strings stay in English and act as gettext message ids, with the
|
||||
French wording supplied by translations/fr/LC_MESSAGES/messages.po. That
|
||||
keeps the codebase in one language — the same one as its comments and
|
||||
docstrings — while what a member actually sees defaults to French.
|
||||
|
||||
Consequence worth knowing: an English page is what you get when a string
|
||||
has no French translation yet. A missing entry degrades to English rather
|
||||
than to a raw identifier, which is why the migration can proceed template
|
||||
by template without ever leaving the site in a broken state.
|
||||
"""
|
||||
|
||||
from flask import request, session
|
||||
|
||||
#: Locales the site is served in, in order of preference.
|
||||
SUPPORTED_LOCALES = ('fr', 'en')
|
||||
|
||||
#: Language names as written in their own language, for the switcher.
|
||||
LOCALE_NAMES = {
|
||||
'fr': 'Français',
|
||||
'en': 'English',
|
||||
}
|
||||
|
||||
#: Session key holding an explicit user choice.
|
||||
LOCALE_SESSION_KEY = 'locale'
|
||||
|
||||
DEFAULT_LOCALE = 'fr'
|
||||
|
||||
|
||||
def select_locale():
|
||||
"""Pick the locale for the current request.
|
||||
|
||||
Order of precedence:
|
||||
|
||||
1. an explicit choice the user made through the language switcher,
|
||||
kept in the session;
|
||||
2. the browser's Accept-Language header, restricted to what we serve;
|
||||
3. French.
|
||||
|
||||
Note that step 2 only ever selects English for someone whose browser
|
||||
actually asks for it. Everyone else gets French, including browsers
|
||||
sending no header at all.
|
||||
|
||||
Returns:
|
||||
str: A locale code from SUPPORTED_LOCALES.
|
||||
"""
|
||||
chosen = session.get(LOCALE_SESSION_KEY)
|
||||
if chosen in SUPPORTED_LOCALES:
|
||||
return chosen
|
||||
|
||||
# best_match returns None when nothing overlaps.
|
||||
if request:
|
||||
negotiated = request.accept_languages.best_match(SUPPORTED_LOCALES)
|
||||
if negotiated:
|
||||
return negotiated
|
||||
|
||||
return DEFAULT_LOCALE
|
||||
|
||||
|
||||
def set_locale(locale):
|
||||
"""Record an explicit language choice for this session.
|
||||
|
||||
Args:
|
||||
locale: Requested locale code.
|
||||
|
||||
Returns:
|
||||
bool: True if it was accepted, False if unsupported.
|
||||
"""
|
||||
if locale not in SUPPORTED_LOCALES:
|
||||
return False
|
||||
session[LOCALE_SESSION_KEY] = locale
|
||||
return True
|
||||
Reference in New Issue
Block a user