i18n & Localisation
Règle de Lecture Sélective
Commencez par :
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Chargez ensuite uniquement les documents, scripts, ressources ou exemples hérités qui correspondent à la tâche réelle de l'utilisateur.
Bonnes pratiques en matière d'internationalisation (i18n) et de localisation (L10n).
1. Concepts Fondamentaux
| Terme | Signification |
|---|---|
| i18n | Internationalisation – rendre l'application traduisible |
| L10n | Localisation – traductions réelles |
| Locale | Langue + Région (en-US, tr-TR) |
| RTL | Langues s'écrivant de droite à gauche (Arabe, Hébreu) |
2. Quand Utiliser i18n
| Type de Projet | i18n Nécessaire ? |
|---|---|
| Application web publique | ✅ Oui |
| Produit SaaS | ✅ Oui |
| Outil interne | ⚠️ Peut-être |
| Application mono-région | ⚠️ Penser à l'avenir |
| Projet personnel | ❌ Optionnel |
3. Schémas de Mise en Œuvre
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
Next.js (next-intl)
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
Python (gettext)
from gettext import gettext as _
print(_("Welcome to our app"))
4. Structure des Fichiers
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
5. Bonnes Pratiques
À FAIRE ✅
- Utiliser des clés de traduction, pas du texte brut
- Espacer (namespacer) les traductions par fonctionnalité
- Gérer la pluralisation
- Adapter les formats de date/chiffres par locale
- Prévoir le RTL dès le début
- Utiliser le format de message ICU pour les chaînes complexes
À NE PAS FAIRE ❌
- Ne pas coder en dur les chaînes dans les composants
- Ne pas concaténer les chaînes traduites
- Ne pas oublier la longueur du texte (l'allemand est 30% plus long)
- Ne pas négliger la mise en page RTL
- Ne pas mélanger les langues dans le même fichier
6. Problèmes Courants
| Problème | Solution |
|---|---|
| Traduction manquante | Repli sur la langue par défaut |
| Chaînes codées en dur | Utiliser un script de vérification |
| Format de date | Utiliser Intl.DateTimeFormat |
| Format de nombre | Utiliser Intl.NumberFormat |
| Pluralisation | Utiliser le format de message ICU |
7. Support RTL
/* Propriétés logiques CSS */
.container {
margin-inline-start: 1rem; /* Pas margin-left */
padding-inline-end: 1rem; /* Pas padding-right */
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
8. Liste de Vérification
Avant la mise en production :
- Toutes les chaînes destinées à l'utilisateur utilisent des clés de traduction
- Les fichiers de locale existent pour toutes les langues prises en charge
- Le formatage des dates/chiffres utilise l'API Intl
- La mise en page RTL a été testée (si applicable)
- La langue de repli est configurée
- Aucune chaîne codée en dur dans les composants
Script
| Script | Objectif | Commande |
|---|---|---|
scripts/i18n_checker.py | Détecter les chaînes codées en dur & traductions manquantes | python scripts/i18n_checker.py <chemin_du_projet> |