Que fait Aide à l'internationalisation ?
Aide à gérer l'internationalisation (i18n) et la localisation (l10n) dans les applications multilingues.
Quand l'utiliser
- L'utilisateur demande un support i18n
- Ajout de nouvelles langues
- Recherche de chaînes non traduites
- Gestion des fichiers de traduction
- L'utilisateur mentionne "traduction", "i18n", "l10n", "locale"
Instructions
1. Détecter le framework i18n
JavaScript/React :
- react-i18next
- react-intl (FormatJS)
- i18next
- LinguiJS
Vue :
- vue-i18n
Python :
- gettext
- Django i18n
- Flask-Babel
Ruby/Rails :
- Gemme I18n (intégrée)
Recherchez les imports, fichiers de configuration ou répertoires de traduction.
2. Trouver les chaînes codées en dur
Recherchez le texte non traduit :
// Mauvais : codé en dur
<button>Envoyer</button>
<p>Bienvenue, {user.name} !</p>
// Bon : traduit
<button>{t('common.submit')}</button>
<p>{t('welcome.message', { name: user.name })}</p>
Motifs de recherche :
- Chaînes dans les balises JSX/template
- Messages d'alerte/d'erreur
- Étiquettes et espaces réservés de formulaires
- Texte des boutons
- Messages de validation
Exclure : commentaires de code, console.log, chaînes de test
3. Extraire dans les fichiers de traduction
Format react-i18next (JSON) :
{
"common": {
"submit": "Envoyer",
"cancel": "Annuler"
},
"welcome": {
"message": "Bienvenue, {{name}} !"
}
}
Format Gettext (.po) :
msgid "submit_button"
msgstr "Envoyer"
msgid "welcome_message"
msgstr "Bienvenue, %(name)s !"
4. Organiser les clés de traduction
Bonnes pratiques :
- Espaces de noms par fonctionnalité :
users.profile.title - Grouper les chaînes communes :
common.buttons.save - Décrire le contexte, pas le contenu :
errors.login.invalidpaserrors.wrong_password - Convention de nommage cohérente
5. Vérifier la couverture des traductions
Comparez les fichiers de langue pour trouver les traductions manquantes :
en.json : 150 clés
es.json : 142 clés (8 manquantes)
fr.json : 150 clés ✓
Manquantes dans es.json :
- users.profile.bio
- settings.privacy.title
[...]
6. Gérer la pluralisation
Différentes langues ont des règles de pluriel différentes :
// react-i18next
t('items', { count: 0 }) // "0 éléments"
t('items', { count: 1 }) // "1 élément"
t('items', { count: 5 }) // "5 éléments"
// Fichier de traduction
{
"items_zero": "{{count}} élément",
"items_one": "{{count}} élément",
"items_other": "{{count}} éléments"
}
7. Formatage des dates, heures et nombres
Utilisez le formatage adapté à la langue :
// Nombres
const price = new Intl.NumberFormat('fr-FR', {
style: 'currency',
currency: 'EUR'
}).format(29.99);
// Dates
const date = new Intl.DateTimeFormat('fr-FR').format(new Date());
8. Support RTL (de droite à gauche)
Pour l'arabe, l'hébreu :
- CSS :
direction: rtl; - HTML :
<html dir="rtl"> - Propriétés logiques :
margin-inline-startau lieu demargin-left
9. Générer un modèle de traduction
Créez un modèle pour une nouvelle langue :
# Copier les clés depuis la langue de base, valeurs vides
cp locales/en.json locales/de.json
# Marquer pour traduction
10. Bonnes pratiques
- Conserver les traductions dans des fichiers séparés
- Utiliser des clés, pas le texte source comme clé
- Fournir du contexte aux traducteurs
- Tester avec des chaînes longues (l'allemand est souvent plus long)
- Utiliser ICU MessageFormat pour les chaînes complexes
- Éviter de concaténer des chaînes traduites
- Extraire tout le texte destiné à l'utilisateur
Fichiers de support
templates/i18n-config.js: Exemples de configurationtemplates/locale-file.json: Modèle de fichier de traduction