# General Translation Changelog: gtx-cli 2.3.0: Exécutions de traduction plus rapides et plus fiables URL: https://generaltranslation.com/fr/blog/gtx-cli_v2_3_0.mdx Docs index: https://generaltranslation.com/llms.txt Description: Authors: Fernando Aviles Published: 2025-09-12 ## Vue d’ensemble Dans **gtx-cli 2.3.0**, nous avons mis à jour le comportement des commandes [`translate`](/docs/cli/reference/commands/translate) et [`upload`](/docs/cli/reference/commands/upload) et accru la visibilité sur le pipeline de traduction. *** ## Translate Historiquement, [`translate`](/docs/cli/reference/commands/translate) déclenchait à la fois les traductions **et** une configuration initiale unique du projet en arrière-plan (génération du contexte et du glossaire visibles dans votre [tableau de bord](https://generaltranslation.com/dashboard/project/context)). Sur les petits projets, c’était rapide ; sur les bases de code plus volumineuses, cette configuration pouvait prendre assez de temps pour provoquer un délai d’expiration, donnant l’impression que la traduction avait échoué. Les utilisateurs avaient donc l’impression que [`translate`](/docs/cli/reference/commands/translate) avait échoué, alors que la configuration se terminait de manière asynchrone et que les traductions étaient bien générées, mais pas téléchargées, ce qui entraînait une expérience utilisateur incomplète et déroutante. ### Configuration La configuration est désormais une étape distincte. Nous l’avons optimisée pour que les dépassements de délai soient rares. Mais comme nous savons qu’elle peut quand même échouer, la traduction ne « dépend » plus de la fin de la configuration. Le pipeline ressemble maintenant à ceci : * **Envoi :** envoyez les fichiers et confirmez que l’opération a réussi. * **Configuration (uniquement si nécessaire) :** lancez une tâche de configuration et attendez ; si elle échoue ou dépasse le délai, nous passons à la suite. * **Traduction :** créez des tâches de traduction à partir des fichiers que vous avez déjà envoyés. Si la configuration se termine à temps, parfait. Si elle échoue ou dépasse le délai, nous continuons et nous vous indiquons ce qui s’est passé. Vous obtenez quand même vos traductions. Voici ce que vous verrez lorsque vous exécuterez `npx gtx-cli translate` : ```bash Starting translation... Files to translate: - your/file/path.mdx - ... Uploading files to General Translation API... ✔ Files uploaded successfully Setting up project... # Si la configuration réussit Setup successfully completed. # Si la configuration expire ⚠ Setup timed out — proceeding without setup: Timed out while waiting for setup generation # Si la configuration échoue ⚠ Setup failed — proceeding without setup: # Dans tous les cas, on passe aux traductions Creating 12 translation(s) [0/12] translations completed your/file/path.mdx [es] ``` Avec ce changement, nous pouvons désormais garantir que vos traductions seront générées, même dans le cas peu probable où la configuration échouerait. Nous apprécions aussi le fait que cela vous donne davantage de visibilité sur la façon et l’endroit dont nous générons le contenu qui influence vos traductions, et que l’ajout de nouvelles étapes de configuration se fasse sans crainte, puisqu’elles n’empêcheront jamais la traduction de s’exécuter. *** ## Téléversement Nous avons également rendu [`upload`](/docs/cli/reference/commands/upload) plus flexible. Les versions précédentes partaient du principe que vous envoyiez toujours un fichier source avec ses traductions. Ce modèle ne convenait pas à tous les flux de travail. Vous pouvez maintenant : * Téléverser **uniquement des fichiers source** (sans traductions pour le moment). * Téléverser **les sources et les traductions en même temps**. Nous continuons à détecter automatiquement les traductions à partir de la structure de votre dépôt et de la configuration. Une fois le téléversement effectué, vous verrez immédiatement les fichiers dans votre [tableau de bord](https://generaltranslation.com/dashboard/project/translations). Si votre `gt.config.json` ressemble à ceci : ```json { "defaultLocale": "en", "locales": ["es", "fr"], "files": { "json": { "include": ["src/i18n/en/**/*.json"] } } } ``` En exécutant `npx gtx-cli upload` : ```bash # Sources uniquement (aucune traduction locale trouvée) : Starting upload... Files to upload: - src/i18n/en/common.json -> es, fr ... Uploading 1 file(s) to General Translation... ✔ Files uploaded successfully Done! # Dans votre tableau de bord, vous verrez : # src/i18n/en/common.json # sans traductions correspondantes pour l'instant. ``` Si des traductions locales sont présentes et automatiquement détectées : ```bash Starting upload... Files to upload: - src/i18n/en/common.json -> es, fr Uploading 3 file(s) to General Translation... ✔ Files uploaded successfully Done! # Dans votre tableau de bord, vous verrez : # src/i18n/en/common.json # ainsi que les versions traduites en espagnol et en français dans le menu déroulant des paramètres régionaux. ``` Si le fichier de traduction d’un paramètre régional est manquant, nous téléversons la source et ignorons cette traduction. Si vous avez des traductions locales mais souhaitez uniquement téléverser les sources, supprimez `locales` de `gt.config.json` avant d’exécuter [`upload`](/docs/cli/reference/commands/upload) : ```json { "defaultLocale": "en", "locales": [], "files": { "json": { "include": ["src/i18n/en/**/*.json"] } } } ``` ### Les téléversements écrasent les traductions existantes > **Attention :** lorsque vous exécutez [`upload`](/docs/cli/reference/commands/upload), tout fichier traduit que nous détectons et téléversons pour un fichier/paramètre régional donné **remplace** ce qui est actuellement enregistré pour ce fichier/paramètre régional. > > * Pour téléverser uniquement les sources, supprimez les paramètres régionaux cibles de `gt.config.json` avant d’exécuter [`upload`](/docs/cli/reference/commands/upload). > * Si vous devez d’abord vérifier les modifications, utilisez un projet distinct ou exportez les traductions actuelles avant de téléverser. > * Les traductions manquantes sont ignorées ; les traductions présentes sont remplacées. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.