Internationalisation des Sites Web
Flux de travail complet pour ajouter la prise en charge multilingue aux sites Next.js avec les meilleures pratiques SEO.
Quand utiliser cette compétence
- Ajout de nouvelles versions linguistiques à un site existant
- Mise en place de l'i18n (internationalisation) pour un nouveau site
- Configuration SEO pour plusieurs langues
- L'utilisateur mentionne : "ajouter une langue", "traduction", "localisation", "hreflang", "multilingue"
Langues prises en charge
Marchés cibles courants :
- 🇺🇸 Anglais (en) - Marché mondial
- 🇯🇵 Japonais (ja) - Marché asiatique
- 🇨🇳 Chinois (zh) - Marché chinois
Prise en charge étendue pour :
- Coréen (ko), Portugais (pt), Espagnol (es), Français (fr), Allemand (de)
- Arabe (ar), Vietnamien (vi), Hindi (hi), Indonésien (id), Thaï (th)
- Chinois traditionnel (zh-hk), Italien (it), Russe (ru)
Flux de travail d'internationalisation
Copiez cette liste de contrôle et suivez votre progression :
Progression i18n :
- [ ] Étape 1 : Préparer les fichiers de base
- [ ] Étape 2 : Ajouter les nouveaux fichiers de langue
- [ ] Étape 3 : Mettre à jour les fichiers de configuration
- [ ] Étape 4 : Ajouter les traductions
- [ ] Étape 5 : Configurer les éléments SEO
- [ ] Étape 6 : Valider et tester
Étape 1 : Préparer les fichiers de base
Assurez-vous que les fichiers anglais (en.json) existent comme modèles :
Répertoires requis :
i18n/messages/en.json- Traductions principalesi18n/pages/landing/en.json- Traductions de la page d'accueil
Vérifier la structure :
# Vérifier si les fichiers de base existent
ls i18n/messages/en.json
ls i18n/pages/landing/en.json
S'ils manquent, créez-les avec des clés de traduction complètes pour votre site Web.
Étape 2 : Ajouter les nouveaux fichiers de langue
Exécutez le script d'ajout de langue :
node scripts/i18n-add-languages.mjs
Ce que fait ce script :
- Copie
en.jsonvers tous les fichiers de langue cibles - Met à jour
i18n/locale.tsavec les nouvelles locales - Met à jour
i18n/request.tsavec les correspondances de langue - Met à jour
public/sitemap.xmlavec les nouvelles URL de langue
Configuration du script (dans i18n-add-languages.mjs) :
- Tableau
languages- Liste des langues à ajouter - Objet
languageNames- Noms d'affichage des langues - Tableau
targetDirs- Répertoires contenant les fichiers de traduction
Voir WORKFLOW.md pour un guide étape par étape détaillé.
Étape 3 : Vérifier les mises à jour de configuration
Vérifier i18n/locale.ts :
export const locales = ["en", "ja", "zh", "ko", ...];
export const localeNames: any = {
en: "English",
ja: "日本語",
zh: "中文",
ko: "한국어",
...
};
Vérifier i18n/request.ts :
- Correspondances de codes de langue configurées
- Présence des correspondances
zh-CN→zh,zh-HK→zh-hk
Vérifier public/sitemap.xml :
- Toutes les versions linguistiques listées
- Balises
hreflangprésentes pour chaque URL
Étape 4 : Ajouter les traductions
Option A : Utilisation de la traduction IA (plus rapide mais nécessite une relecture) :
# Ajouter les traductions des données structurées et des prix
node scripts/i18n-add-schema.js
Configurez les traductions dans l'objet translations du script.
Option B : Traduction manuelle (recommandée pour la qualité) :
Modifiez chaque fichier de langue avec les traductions appropriées :
# Ouvrir le fichier de langue
code i18n/messages/ja.json
Bonnes pratiques de traduction :
- Utilisez des locuteurs natifs dans la mesure du possible
- Maintenez les mots-clés SEO dans la langue cible
- Adaptez le contenu à la culture locale, ne vous contentez pas de traduire
- Gardez un formatage cohérent (espaces réservés, variables)
Voir reference/locale-codes.md pour la référence des codes de langue.
Étape 5 : Configurer les éléments SEO
Balises hreflang - Automatiques via le sitemap, mais vérifiez :
Voir reference/hreflang-guide.md pour un guide complet.
Balises méta localisées - Traduisez dans chaque fichier de langue :
{
"metadata": {
"title": "Titre de votre site",
"description": "Votre description SEO"
}
}
Structure d'URL - Vérifiez le format correct :
- Anglais :
https://example.com/ouhttps://example.com/en/ - Japonais :
https://example.com/ja/ - Chinois :
https://example.com/zh/
Étape 6 : Valider et tester
Construire le projet :
npm run build
CRITIQUE : Corrigez toute erreur avant de continuer.
Tests manuels :
-
Sélecteur de langue :
- Visitez chaque version linguistique
- Vérifiez que le sélecteur de langue affiche toutes les langues
- Cliquez sur chaque lien de langue, vérifiez que la page correcte se charge
-
Affichage du contenu :
- Vérifiez que toutes les pages s'affichent correctement dans chaque langue
- Assurez-vous qu'il n'y a pas de texte non traduit (vérifiez la présence d'anglais dans les pages non anglaises)
- Testez l'affichage correct des caractères spéciaux (japonais, chinois, arabe)
-
Éléments SEO :
- Inspectez que l'attribut
<html lang="...">correspond à la langue de la page - Vérifiez la présence des balises
<link rel="alternate" hreflang="..."> - Vérifiez que les balises méta sont dans la langue correcte
- Inspectez que l'attribut
Validation automatisée :
# Vérifier le sitemap
curl https://your-site.com/sitemap.xml | grep hreflang
# Valider hreflang (utiliser un outil en ligne)
# Google Search Console > Internationalisation > hreflang
Liste de contrôle SEO - Voir reference/seo-checklist.md.
Si la validation échoue :
- Examinez attentivement les messages d'erreur
- Vérifiez les fichiers de configuration pour les fautes de frappe
- Assurez-vous que les codes de langue sont corrects
- Revenez à l'Étape 3 et corrigez les problèmes
Ne continuez que lorsque toutes les validations réussissent.
Notes importantes
Normes de codes de langue
Utilisez l'ISO 639-1 (codes à deux lettres) avec des variantes régionales optionnelles :
en- Anglaisja- Japonaiszh- Chinois simplifiézh-hk- Chinois traditionnel (Hong Kong)pt- Portugaispt-br- Portugais brésilien
Voir reference/locale-codes.md pour la liste complète.
Implications SEO
Une i18n correcte améliore le SEO en :
- Ciblant les utilisateurs dans leur langue maternelle
- Évitant les pénalités pour contenu dupliqué
- Aidant les moteurs de recherche à diffuser la bonne version linguistique
Erreurs SEO courantes à éviter :
- ❌ Redirection automatique basée sur l'IP (empêche les moteurs de recherche d'explorer toutes les versions)
- ❌ Balises hreflang manquantes (provoque des problèmes de contenu dupliqué)
- ❌ Structure d'URL incohérente entre les langues
- ❌ Balises méta non traduites
Qualité des traductions
Traduction IA vs Traduction humaine :
- ✅ IA : Rapide, rentable, bonne pour une première ébauche
- ⚠️ IA : Peut manquer les nuances culturelles, nécessite une relecture
- ✅ Humaine : Meilleure qualité, adaptation culturelle
- ⚠️ Humaine : Plus lente, plus coûteuse
Approche recommandée :
- Utilisez l'IA pour générer des traductions initiales
- Faites relire et affiner par un locuteur natif
- Testez avec des utilisateurs du marché cible
- Itérez en fonction des commentaires
Routage i18n dans Next.js
Le système utilise next-intl pour le routage :
- Détection automatique de la locale depuis l'URL
- Composant de sélecteur de langue
- Navigation localisée
Configuration dans i18n/locale.ts et i18n/request.ts.
Tâches post-internationalisation
Après avoir ajouté les langues :
- Soumettre le sitemap mis à jour à Google Search Console
- Créer des propriétés Search Console distinctes pour chaque langue/région
- Surveiller le trafic organique international dans Analytics
- Tester A/B les traductions si les taux de conversion diffèrent selon la langue
- Configurer des alertes pour les erreurs d'exploration internationales
Emplacements des scripts
Tous les scripts i18n se trouvent dans le répertoire scripts/ :
i18n-add-languages.mjs- Ajouter de nouveaux fichiers de languei18n-add-schema.js- Ajouter des traductions de données structurées
Documents de référence
- WORKFLOW.md - Flux de travail détaillé étape par étape
- reference/hreflang-guide.md - Guide de mise en œuvre hreflang
- reference/locale-codes.md - Référence des codes de langue
- reference/seo-checklist.md - Liste de contrôle SEO internationale
Pour le dépannage, consultez la section de dépannage de WORKFLOW.md.