Branchement (Strings)

Le Branchement est activé dans l'onglet Advanced des Paramètres du projet avec l'option de protéger la branche principale contre les modifications.

Lorsqu'il est activé, un menu de branche est présenté sur l'écran du projet où les branches de travail peuvent être sélectionnées. Pour spécifier une branche dans CLI, utilisez le paramètre --branch :

--branch <branch_name>

Les branches sont listées dans l'onglet Branches d'un projet, où les informations de création et de fusion sont présentées. Les branches peuvent également être supprimées ou fusionnées et des emplois créés pour cette branche depuis l'onglet Branches.

Pour lister toutes les branches du projet via API ou CLI, exécutez :

$ phrase branches list --project_id <project_id>

# par exemple.
$ phrase branches list --project_id 1d8ae641902624df63ce6fbd64ff9549$ phrase branches list <project_id>

Pour supprimer une branche via API ou CLI, exécutez :

$ phrase branches delete --project_id <project_id> --name <branch_name>

# par exemple.
$ phrase branches delete --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ phrase branch delete <project_id> <branch_name>

Les rôles Administrateur, Chef de projet et Développeur peuvent créer de nouvelles branches dans l'éditeur de traduction, via API ou dans le CLI.

Pour créer une branche dans l'éditeur de traduction, suivez ces étapes :

Pour créer une branche via API ou CPI, exécutez :

$ phrase branches create --project_id <project_id> --data <data>

Pour créer une branche lors de l'envoi des traductions, exécutez :

$ phrase push --branche <nom_de_branche>

Après que des modifications ont été apportées à une branche, elle peut être fusionnée dans la branche principale afin d'incorporer de nouvelles traductions.

Seules les modifications apportées aux ressources suivantes sont appliquées à la branche principale lors des fusions :

Les modifications apportées à d'autres ressources, telles que les Activités, les Emplois et les Commandes, ne sont pas appliquées.

Conflits

Un conflit se produit lorsqu'une ressource (traduction, clé ou paramètre linguistique) a changé à la fois dans le projet principal et dans la branche entre le moment où une branche est créée et lorsqu'elle est fusionnée dans le projet principal. Par exemple, les traductions et les paramètres de clé (tels que les formes plurielles) peuvent avoir changé dans le projet principal après la création d'une branche, rendant les valeurs dans la branche différentes de celles du projet principal.

Pour fusionner une branche, suivez ces étapes :

Pour fusionner une branche via l'API ou le CPI, exécutez :

$ phrase branches fusionner \\
  --project_id <project_id> \\
  --name <name> \\
  --data '{"strategy":"use_main"}' \
  --access_token <token>

Lors de l'utilisation de la CLI, spécifiez une branche à pousser ou à tirer avec le paramètre --branch.

$ phrase push --branche <nom_de_branche>
$ phrase pull --branch <branch_name>

Si la branche spécifiée n'existe pas dans un projet, le client la crée.

Utilisez --use-local-branch-name pour pousser et tirer en utilisant le nom de la branche d'une branche git active :

$ phrase push --use-local-branch-name
$ phrase pull --use-local-branch-name

Tous les points de terminaison de l'API qui prennent un argument de projet prennent également en charge le paramètre --branch pour effectuer une action sur une branche spécifique d'un projet :

$ phrase upload créer <project_id> \\

  --branch <branch_name>

  --file /path/to/my/file.json \\

  --file-format json \\

  --locale-id abcd1234cdef1234abcd1234cdef1234 \\

  --tags fonctionnalité-géniale,besoins-relecture \\

  --locale-mapping "{"en": "2"}" \

  --format-options "{"foo": "bar"}"