Utiliser globalize.now avec Next.js
Configurez l'internationalisation dans une application Next.js en moins de cinq minutes.
Next.js a un support i18n de première classe via des bibliothèques comme next-intl et next-i18next, mais ces bibliothèques s'attendent à une base de code avec des clés de traduction déjà en place. globalize.now est l'étape avant : il prend une application Next.js pleine d'anglais codé en dur et produit les clés, les fichiers de locale et les composants refactorisés que next-intl (ou n'importe quelle bibliothèque runtime) peut servir.
Prérequis
- Un projet Next.js (App Router ou Pages Router)
- Un dépôt Git
- Node.js 18+
- Une bibliothèque runtime i18n choisie (next-intl recommandé)
Comment configurer globalize.now avec Next.js
Installez votre bibliothèque runtime
Ajoutez next-intl ou la bibliothèque que vous préférez pour que l'application puisse charger les messages par locale au moment de l'exécution.
npm install next-intlConfigurez le routage basique de next-intl
Câblez le middleware, les fournisseurs et les segments de route comme décrit dans la documentation de next-intl, ou ignorez cette étape si vous l'avez déjà terminée.
Exécutez l'installateur de compétences Globalize
À partir de la racine du projet Next.js, installez les compétences pour que l'agent puisse s'aligner avec votre configuration de routage.
npx globalize-skillsConfirmez la détection de next-intl
Laissez l'agent vérifier que les fournisseurs et les chemins de messages correspondent aux conventions que globalize.now attend pour Next.js.
Examinez la disposition proposée du fichier de locale
Inspectez le répertoire de messages suggéré et les noms de fichiers pour qu'ils suivent le motif messages-par-locale que vous avez choisi.
Refactorisez les littéraux en appels de traduction
Approuvez les mises à jour qui remplacent l'anglais intégré par t() ou des helpers équivalents câblés à votre fournisseur.
Poussez vers Git
Fusionnez la branche et poussez pour que globalize.now puisse garder les traductions synchronisées lors des futurs pushes Git.
Problèmes courants
next-intl s'attend à une structure de message spécifique
Résolution : globalize.now détecte automatiquement la convention next-intl et écrit du JSON qui correspond à vos dossiers de locale configurés, réduisant la refonte manuelle.
J'ai déjà quelques chaînes traduites — globalize.now les écrasera-t-il ?
Résolution : Les clés existantes sont préservées autant que possible, et les nouveaux littéraux sont ajoutés progressivement pour que les traducteurs ne perdent pas le travail antérieur.
Questions fréquemment posées
globalize.now fonctionne-t-il avec next-intl et next-i18next ?
Oui. globalize.now se concentre sur la structure du dépôt — clés, catalogues JSON et sites d'appel de composants — tandis que next-intl ou next-i18next continue à charger les messages au moment de l'exécution. Choisissez le runtime qui correspond à votre modèle de routage ; globalize.now adapte sa sortie à ce choix. Vous exécutez toujours npx globalize-skills une fois par amorçage de projet sauf si vous actualisez intentionnellement les compétences.
globalize.now supporte-t-il à la fois App Router et Pages Router ?
Oui. Les compétences de l'agent détectent le style de routeur que vous utilisez et alignent l'extraction avec les fichiers de mise en page, les gestionnaires de route et les fournisseurs corrects. globalize.now ne remplace pas le routage Next.js ; il garantit que les chaînes circulant à travers ces routes sont clés. Après la configuration, les composants serveur App Router et les composants client référencent tous les deux les mêmes fichiers de locale que votre runtime attend.
Puis-je utiliser globalize.now avec une application Next.js qui possède déjà une i18n partielle ?
Oui. Pointez l'agent vers le dépôt et il étendra les bundles de messages existants, comblant les lacunes où les littéraux subsistent. C'est courant quand seules les pages marketing ont été traduites en premier. globalize.now fusionne les nouvelles clés sans supprimer les traductions plus anciennes, ce qui permet aux équipes de migrer écran par écran.
globalize.now traite-t-il différemment les composants serveur et les composants client ?
globalize.now réécrit les littéraux en fonction du helper que votre stack utilise pour chaque limite, en respectant les règles Next.js concernant l'endroit où les hooks et les fournisseurs peuvent s'exécuter. La sortie JSON reste partagée entre les bundles serveur et client, vous ne dupliquez donc pas les catalogues. Vous suivez toujours la documentation Next.js pour marquer les composants client quand l'interactivité l'exige.
Comment globalize.now s'intègre-t-il à la génération statique de Next.js ?
Les fichiers de locale vivent dans Git, donc `next build` continue de regrouper le même JSON que vos routes SSG ou SSR importent déjà via next-intl. globalize.now ne modifie pas le pipeline de génération statique au-delà de garantir que les chaînes proviennent de fichiers de données au lieu de littéraux. Quand une nouvelle copie est déployée, un autre push Git actualise les traductions avant le déploiement suivant.
Dois-je installer next-intl avant d'exécuter npx globalize-skills ?
Installer next-intl en premier est idéal quand vous savez déjà que c'est votre runtime, car l'agent peut câbler les fournisseurs immédiatement. Si vous n'avez pas encore choisi de bibliothèque, vous pouvez toujours exécuter npx globalize-skills — les compétences aident à recommander une stack — mais vous devrez peut-être relancer la configuration après l'installation des dépendances. Les deux chemins aboutissent à des clés enregistrées dans Git et à une synchronisation à chaque push.
Essayez globalize.now avec Next.js
Commencez à partir de la racine de votre projet :
npx globalize-skillsRetour à la page d'accueil pour le contexte produit et la tarification →