next-intl

Aperçu

Ce tutoriel vous montrera comment gérer automatiquement les fichiers de traduction de votre projet dans next-intl.

Nous suivrons ces 4 étapes :

Étape 1 : Ajoutez vos variables d'environnement

Ajoutez votre clé API de production et l'ID de projet à vos variables d'environnement. Ceci est nécessaire pour utiliser l'outil gtx-cli. Vous obtenez ces informations depuis le tableau de bord General Translation.

GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>

Étape 2 : Installez gtx-cli

Installez l'outil gtx-cli dans votre projet.

npm i --save-dev gtx-cli

Étape 3 : Créer un fichier gt.config.json

Créez un fichier gt.config.json à la racine de votre projet.

{
  "defaultLocale": "en",
  "locales": ["zh", "es", "ja"],
  "files": {
    "json": {
      "include": ["i18n/[locale]/*.json"]
    },
  },
}

N'hésitez pas à personnaliser le fichier gt.config.json selon vos besoins. Consultez la documentation de configuration pour plus d'informations.

Mettez à jour le format de fichier json de sorte que le chemin include corresponde à la structure de votre projet.

Étape 4 : Ajoutez la commande gtx-cli translate à votre processus de build

Ajoutez la commande gtx-cli translate à votre processus de build ou CI avant la commande de build pour ajouter automatiquement des traductions à votre projet.

{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <your build command>"
  }
}

Cela générera des traductions pour toutes vos locales et les enregistrera dans votre projet. Si vous souhaitez valider ces fichiers dans votre dépôt, vous pouvez plutôt exécuter cette commande avant de faire un commit.

C'est terminé ! Maintenant, votre projet mettra automatiquement à jour tous vos fichiers JSON de traduction chaque fois que votre projet change.

Notes

• Vous pouvez ajouter automatiquement des traductions à votre projet avec la commande gtx-cli translate.
• Si vous souhaitez valider vos fichiers de traduction, vous pouvez plutôt exécuter la commande gtx-cli translate avant de faire un commit.
• Pour configurer le chemin de sortie de vos traductions, consultez la documentation de configuration.

Prochaines étapes

• Consultez le guide d'utilisation pour l'outil CLI.
• Si vous souhaitez voir les traductions en direct pendant le développement (pensez au rechargement à chaud), consultez le composant <T>.