i18n & Localisation
Meilleures pratiques d'internationalisation (i18n) et de localisation (L10n).
1. Concepts clés
| Terme | Signification |
|---|
| i18n | Internationalisation – rendre l'application traduisible |
| L10n | Localisation – traductions réelles |
| Locale | Langue + Région (en-US, tr-TR) |
| RTL | Langues 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 au futur |
| Projet personnel | ❌ Optionnel |
3. Modèles d'implémentation
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(_("Bienvenue dans notre application"))
4. Structure de 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
- Espaces de noms pour les traductions par fonctionnalité
- Gérer la plurilisation
- Adapter les formats de date/nombre par locale
- Planifier le support RTL dès le début
- Utiliser le format de message ICU pour les chaînes complexes
À ÉVITER ❌
- Chaînes codées en dur dans les composants
- Concaténer des chaînes traduites
- Supposer la longueur du texte (l'allemand est 30% plus long)
- Oublier la mise en page RTL
- Mélanger les langues dans un même fichier
6. Problèmes courants
| Problème | Solution |
|---|
| Traduction manquante | Repli vers la langue par défaut |
| Chaînes codées en dur | Utiliser un linter/script de vérification |
| Format de date | Utiliser Intl.DateTimeFormat |
| Format de nombre | Utiliser Intl.NumberFormat |
| Plurilisation | Utiliser le format de message ICU |
7. Support RTL
.container {
margin-inline-start: 1rem;
padding-inline-end: 1rem;
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
8. Liste de vérification
Avant de livrer :
Script
| Script | Objectif | Commande |
|---|
scripts/i18n_checker.py | Détecter les chaînes codées en dur et les traductions manquantes | python scripts/i18n_checker.py <chemin_du_projet> |
Quand utiliser
Cette compétence est applicable pour exécuter le workflow ou les actions décrits dans l'aperçu.
Limitations
- Utiliser cette compétence uniquement lorsque la tâche correspond clairement au périmètre décrit ci-dessus.
- Ne pas considérer le résultat comme un substitut à une validation spécifique à l'environnement, des tests ou un examen par un expert.
- S'arrêter et demander des clarifications si les entrées requises, les autorisations, les limites de sécurité ou les critères de succès sont absents.