Vue d’ensemble

gtx-cli permet de traduire automatiquement les fichiers Markdown (MD et MDX) de votre projet.

Nous allons suivre ces 4 étapes :

Étape 1 : Ajoutez vos variables d’environnement

Ajoutez votre clé d’API de production et l’ID du projet à vos variables d’environnement. C’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-de-projet>

Étape 2 : Installer gtx-cli

Installez l’outil gtx-cli dans votre projet.

npm i gtx-cli

yarn add --dev gtx-cli

bun add --dev gtx-cli

pnpm add --save-dev gtx-cli

Étape 3 : Configurez le fichier gt.config.json de votre projet

Créez un fichier gt.config.json à la racine de votre projet avec le contenu suivant :

{
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "files": {
    "mdx": {
      "include": ["docs/[locale]/**/*.mdx"]
    }
  }
}

Modifiez defaultLocale et locales pour qu’ils correspondent aux locales de votre projet.

Si vos fichiers sont au format MD, vous pouvez utiliser la clé md au lieu de mdx. Le tableau de chaînes dans la clé include doit être un motif glob qui fait correspondre tous vos fichiers MDX.

Il doit utiliser l’espace réservé [locale] pour faire correspondre la locale du fichier.

Consultez la documentation de configuration pour en savoir plus sur le fichier gt.config.json.

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

Ajoutez la commande gtx-cli translate à votre processus de build ou de CI, avant la commande de build, pour intégrer automatiquement les traductions à votre projet.

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

Cela générera des traductions pour toutes vos locales et les enregistrera 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 Markdown chaque fois qu’il est modifié.

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 la commande gtx-cli translate avant de valider.
• Pour configurer le chemin de sortie des traductions, consultez la documentation de configuration.

Prochaines étapes

• Consultez le guide d’utilisation de l’outil CLI.