Branching (Strings)

La ramification est activée dans l'onglet Avanced des paramètres du projet avec la possibilité de protéger la branche principale contre les modifications.

Lorsqu'elle est activée, une de menu de branche est présentée 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 répertoriées dans la vue Branches 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 tâches créées pour cette branche depuis la vue Branches.

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

$ phrase branches liste <project_id>

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

$ phrase branche delete <project_id> <branch_name>

Les rôles d’administrateur, de chef de projet et de développeur peuvent créer de nouvelles branches dans l’éditeur de traduction, via l’API ou l’ILC.

Pour créer une branche dans l'éditeur de traduction, procédez comme suit :

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

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

Pour créer une branche lors de la poussée de traductions, exécutez :

$ phrase push --branch <branch_name>

Une fois que des modifications ont été apportées à une branche, elle peut être fusionnée à nouveau dans la traduction 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 Tâches et les Commandes, ne sont pas appliquées.

Conflicts

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

Pour fusionner une branche, procédez comme suit :

Pour fusionner une branche via une API ou un CPI, exécutez :

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

Lorsque vous utilisez CLI, spécifiez une branche à pousser ou à tirer avec le paramètre --branch.

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

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

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 create <project_id> \

  --branch <branch_name>

  --file /chemin/vers/mon/fichier.json \

  --file-format json \

  --locale-id abcd1234cdef1234abcd1234cdef1234 \

  --balises fonctionnalité géniale,relecture nécessaire \

  --locale-mapping ‘{"en”:3, “de”:2}’ "2"}" \

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