# gt: General Translation CLI tool: Suivre les traductions par branche
URL: https://generaltranslation.com/fr/docs/cli/guides/branching.mdx
---

title: Suivre les traductions par branche
description: Comment suivre séparément les traductions pour chaque branche Git avec General Translation lorsque vous travaillez sur des fonctionnalités.
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/managing-translations
    - /docs/cli/guides/configuring
    - /docs/cli/guides/using-auto-jsx

---

La gestion des branches permet de suivre séparément les traductions pour chaque branche Git. Utilisez cette fonctionnalité lorsqu’une branche de fonctionnalité ajoute ou modifie du contenu et que vous souhaitez isoler ces traductions de la production jusqu’à la fusion de la branche.

*Remarque : La gestion des branches est une fonctionnalité de General Translation Cloud et nécessite une offre payante. Sans cela, la création d’une branche autre que la branche par défaut bascule sur la branche par défaut.*

## Activer la gestion des branches [#enable]

Ajoutez `--enable-branching` à la commande [`gt translate`](/docs/cli/reference/commands/translate). Le CLI détecte votre branche Git actuelle et associe les nouvelles traductions à celle-ci.

```bash
npx gt translate --enable-branching
```

Pour définir vous-même le nom de la branche au lieu de le détecter à partir de Git, ajoutez `--branch`.

```bash
npx gt translate --enable-branching --branch my-feature-branch
```

Vous pouvez également activer la gestion des branches dans `gt.config.json`. Les options de la CLI priment sur ces valeurs.

```json title="gt.config.json"
{
  "branchOptions": {
    "enabled": true,
    "autoDetectBranches": true,
    "remoteName": "origin"
  }
}
```

## Comment fonctionne l’héritage [#inheritance]

Lorsque la gestion des branches est activée, le CLI identifie votre branche actuelle et la branche par défaut (à partir du HEAD distant), puis détermine leur lien :

* **Branche de départ :** la branche à partir de laquelle la vôtre a été créée. Une nouvelle branche de fonctionnalité hérite de toutes les traductions existantes de cette branche, afin que le contenu partagé ne soit ni retraduit ni facturé deux fois.
* **Branches entrantes :** les branches fusionnées dans la vôtre. Leurs traductions sont intégrées à votre branche.

Les nouvelles traductions restent associées à votre branche de fonctionnalité jusqu’à sa fusion. Après sa fusion dans la branche par défaut, les traductions de la branche de fonctionnalité y sont automatiquement intégrées.

## Exemple de workflow [#workflow]

1. Créez une branche de fonctionnalité et ajoutez du nouveau contenu.

   ```bash
   git checkout -b feature/new-landing-page
   ```

2. Traduisez avec la gestion des branches activée. Les nouvelles traductions sont rattachées à `feature/new-landing-page`.

   ```bash
   npx gt translate --enable-branching
   ```

3. Fusionnez la branche de fonctionnalité, puis traduisez sur la branche par défaut pour y intégrer ses traductions.

   ```bash
   git checkout main
   git merge feature/new-landing-page
   npx gt translate --enable-branching
   ```

## Résoudre les problèmes de détection de branche [#troubleshoot]

* **Branche non détectée :** définissez-la manuellement avec `--branch <branch>`.
* **Remote non standard :** si votre remote n’est pas `origin`, définissez `--remote-name <name>` ou `branchOptions.remoteName`.
* **Utiliser uniquement la branche actuelle :** ajoutez `--disable-branch-detection` pour ignorer le suivi de la branche entrante et de la branche parente.

```bash
npx gt translate --enable-branching --branch my-branch --disable-branch-detection
```
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/managing-translations
- /docs/cli/guides/configuring
- /docs/cli/guides/using-auto-jsx