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.

Une fois 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, utiliser 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 tâches créées pour cette branche depuis l'onglet Branches.

Pour lister toutes les branches d'un projet via API ou CLI, exécuter :

$ phrase branches list --project_id <Identifiant_du_projet>

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

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

$ phrase branches supprimer --project_id <Identifiant> --name <branch_name>

# par ex.
$ phrase branches supprimer --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ phrase branche supprimer <Identifiant> <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 la CLI.

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

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

$ phrase branches créer --project_id <Identifiant> --data <data>

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

$ phrase push --branche <branch_name>

Une fois les modifications apportées à une branche, elle peut être fusionnée dans la traduction principale afin d'incorporer toute nouvelle traduction.

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 travaux et les commandes, ne sont pas appliquées.

Conflits

Un conflit survient lorsqu'une ressource (traduction, clé ou paramètre linguistique) a été modifiée à la fois dans le projet principal et dans la branche entre le moment où une branche est créée et celui où 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 été modifiés dans le projet principal après la création d'une branche, rendant les valeurs de la branche différentes de celles du projet principal.

Pour fusionner une branche, suivez ces étapes :

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

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

Lors de l'utilisation de l'interface de ligne de commande, spécifiez une branche pour effectuer un push ou un pull avec le paramètre --branch.

$ phrase push --branche <branch_name>
$ Phrase pull --branche <branch_name>

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

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

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

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

$ Phrase charger Créer <Identifiant_projet> \

  --branch <branch_name>

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

  --file-format json \

  --locale-id abcd1234cdef1234abcd1234cdef1234 \

  --tags awesome-feature,needs-proofreading \

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

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