gt-next & gt-react

Aperçu

Ce tutoriel va vous montrer comment gérer automatiquement les fichiers de traduction de votre projet lorsque vous utilisez gt-next ou gt-react.

Remarque : Ceci ne doit être utilisé que lorsque vous livrez une version de production. Si vous utilisez gt-next ou gt-react en développement, cette commande n'est pas nécessaire.

Nous allons suivre ces 4 étapes :

Ajoutez vos variables d'environnement

Configurez votre projet avec la commande npx gtx-cli configure

Exécutez gtx-cli translate

Astuce : Évitez les tracas liés à l'utilisation des fichiers de traduction grâce au composant <T>.

Étape 1 : Ajoutez vos variables d'environnement

Ajoutez votre clé API de production et l'identifiant de votre 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.

.env

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

Étape 2 : Configurez votre projet avec la commande `npx gtx-cli configure`

Exécutez la commande gtx-cli configure pour configurer votre projet.

npx gtx-cli configure

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

Ajoutez la commande gtx-cli translate à votre processus de build ou d'intégration continue avant la commande de build afin d'ajouter automatiquement les traductions à votre projet.

package.json

{
  "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 exécuter cette commande avant de valider.

C'est terminé ! Désormais, votre projet mettra automatiquement à jour tous vos fichiers JSON de traduction à chaque modification de votre projet.

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 valider.
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 des traductions en direct lors du développement (rechargement à chaud), jetez un œil au composant <T>.