Présentation

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

Nous suivrons ces 4 étapes :

Étape 1 : Ajoutez vos variables d’environnement

Ajoutez votre clé d’API de production et l’id de projet à vos variables d’environnement. Ceci est nécessaire pour utiliser l’outil gtx-cli. Vous les obtiendrez depuis le tableau de bord General Translation.

GT_API_KEY=<votre-clé-api>
GT_PROJECT_ID=<votre-id-projet>

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

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

npx gtx-cli configure

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

Ajoutez la commande gtx-cli translate à votre pipeline de build ou de CI avant la commande de build afin d’ajouter automatiquement les traductions à votre projet.

{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <votre commande de build>"
  }
}

Cela va générer des traductions pour toutes vos locales et les enregistrer dans votre projet. Si vous souhaitez valider ces files 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 fois que votre projet change.

Remarques

• Vous pouvez ajouter automatiquement des traductions à votre projet avec la commande gtx-cli translate.
• Si vous souhaitez valider vos fichiers de traduction, exécutez plutôt 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 de l’outil CLI.