Internationalisation (i18n)
Priorité : P2 (MOYENNE)
Maintenir une source unique de vérité pour les locales et garantir un routage SEO-friendly par sous-chemin.
Directives de mise en œuvre
- Routage des locales : Suivre l'approche URL en premier pour le SEO. Utiliser des segments dynamiques dans le routeur App (par exemple
app/[lang]/page.tsx) et la configurationi18ndansnext.config.jspour le routeur Pages. - Sélection de la bibliothèque : Utiliser
next-intlpour le routeur App (moderne) oureact-intl/next-translatepour les applications legacy. - Détection : Mettre en œuvre la localisation via middleware (dans
middleware.ts) pour détecter la langue de l'utilisateur à partir des en-têtesAccept-Languageou des cookies et effectuer des redirections. - Côté serveur : Charger les dictionnaires de traduction
messages/*.jsondans les composants serveur pour garder le bundle client léger. Utiliser les motifsgetMessages()ourequestConfig. - SEO : S'assurer que les balises
hreflangsont générées correctement dans l'APImetadatapour toutes les routes traduites. - Génération statique : Utiliser
generateStaticParamspour pré-rendre les versions localisées des pages statiques au moment de la construction.module.exports = { i18n: { locales: ['en', 'fr', 'vi'], defaultLocale: 'en', }, };
3. Spécificités des bibliothèques
Pour une configuration détaillée avec les bibliothèques courantes, consulter :
Anti-patrons
- Pas de chaînes codées en dur dans le JSX : Utiliser des clés de traduction ; ne jamais commiteter du texte brut.
- Pas de bundles de traduction côté client : Charger les dictionnaires côté serveur avec
getMessages(). - Pas de motifs d'URL mélangés pour les locales : Utiliser des sous-chemins ou des domaines de manière cohérente.