Branchement (Strings)

Le contenu est traduit de l’anglais par Phrase Language AI.

Disponible pour

Les forfaits Business et Enterprise

Contactez le service commercial pour toute question relative aux licences.

Le branchement est utilisé dans le contrôle de version de logiciels. Des copies de fichiers de projet appelées branches permettent aux équipes de travail sur des versions parallèles du projet en même temps tout en conservant une copie non modifiée. Cela élimine le risque d'écraser accidentellement les modifications apportées par d'autres aux fichiers de projet.

Le projet principal est copié lorsqu'une nouvelle branche est créée, les modifications étant apportées uniquement à cette branche. Lorsque les modifications sont Terminer, la branche est fusionnée dans le projet principal. Plusieurs branches peuvent être travaillées en même temps et, après la fusion, les branches sont automatiquement supprimées. Les branches fusionnées restent disponibles dans l'onglet Fusionné pour un suivi simplifié de l'historique. Les balises d'une branche existante sont copiées vers la nouvelle branche.

Limitations

Tous les rôles à l'exception du traducteur et de l'invité peuvent accéder à la vue Branches.
Les fusions ne peuvent pas être annulées et les branches ne peuvent pas être restaurées.
Les travaux créés dans une branche spécifique ne sont pas visibles dans le projet principal et vice versa. Lorsqu'une branche est fusionnée dans le projet principal, tous les travaux ouverts qu'elle contient sont perdus.
Les rapports dans la vue Rapports reflètent uniquement le statut de la branche actif. La fusion d'une branche dans le projet principal met à jour les rapports du projet principal.
La vue Activité contient uniquement les activités de la branche actif. Les activités dans les branches ne sont pas visibles dans le projet principal et vice versa. Les activités dans une branche sont perdues lors de sa fusion dans le projet principal.
La synchronisation GitHub ne peut être utilisée que sur le projet principal et non sur les branches.
Les commentaires effectués dans une branche ne sont pas visibles dans le projet principal et vice versa.
Les commandes créées dans une branche ne sont pas visibles dans le projet principal et vice versa. Lorsqu'une branche est fusionnée dans le projet principal, toutes les commandes ouvertes qu'elle contient sont perdues.
Les traducteurs ne peuvent pas être restreints à des branches spécifiques mais reçoivent l'autorisation de travailler sur des paramètres régionaux spécifiques. Les traducteurs doivent être formés sur la manière de travailler avec des branches.

Activer le branchement

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

Une fois activé, un menu de branche Branch Menu 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écutez :

$ 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 delete --project_id <Identifiant_du_projet> --name <nom_de_la_branche>

# par ex.
$ phrase branches delete --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ phrase branche supprimer <Identifiant_du_projet> <nom_de_la_branche>

Créer une branche

Les rôles administrateur, chef de projet, Designer et Developer peuvent Créer de nouvelles branche dans l'onglet Branches, via API ou dans la CLI. Les branche peuvent être Créer à partir de n'importe quelle autre branche, pas seulement la branche principale. Jusqu'à 5 niveaux de branche sont pris en charge.

Pour Créer une branche depuis l'interface utilisateur, suivez ces étapes :

Depuis une page projet, Sélectionner l'onglet Branches.
Cliquez sur Créer branche.

La fenêtre Créer branche s'ouvre.
Indiquez un nom pour la branche.
Sélectionner une branche de base dans la liste des branche existantes.
Cliquez sur Créer.

La nouvelle branche est ajoutée à la liste.

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

$ Phrase branches Créer --project_id <Identifiant_projet> --data <data>

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

$ Phrase push --branche <nom_de_la_branche>

Synchroniser les branche

La synchronisation garantit que la branche de travail reste alignée avec les dernières modifications de la branche dont elle est issue. De cette façon, les traducteurs peuvent travailler avec une version mise à jour du contenu également dans les projet à long terme.

Pour synchroniser une branche avec sa branche de base, suivez ces étapes :

Dans l'onglet Branches, cliquez sur Synchroniser avec la branche de base Suivant la branche souhaitée.

La page Sync s'affiche avec des informations sur les conflits et les modifier à synchroniser avec la branche principale.
Cliquez sur l'un des modifier détectés pour l'examiner avant la synchronisation.

Un tableau avec des détails sur le modifier sélectionné s'affiche.
Sélectionner Sync et confirmer pour appliquer les modifier.

Les modifier sont ajoutés à la branche principale et deviennent visibles dans l'éditeur de traduction. Les informations sur la dernière synchronisation sont affichées dans la colonne Synced de l'onglet Branches.

La synchronisation de branche peut également être effectuée via API en exécutant cette commande CLI :

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

use_branch résout les conflits en appliquant les modifier de la branche et, si rien n'est spécifié, il s'agit de l'option par défaut.
use_main résout les conflits en rejetant les modifier de la branche et fait référence à la branche principale. Lorsque vous travaillez avec des branche empilées, la branche principale n'est pas nécessairement la branche réelle du projet.

Fusionner les branche

Une fois la traduction ou le travail spécifique à une version terminé dans une branche, tout modifier peut être fusionné dans la branche principale. Une fois que tout modifier est fusionné dans la chaîne, la branche de haut niveau peut être fusionnée dans la branche principale.

Après une fusion réussie, la branche fusionnée est automatiquement supprimée et apparaît dans l'onglet Merged pour le suivi de l'historique.

Seuls les modifier apportés aux ressources suivantes sont appliqués à la branche principale lors des fusions :

Locales
Clés
Traductions

Les modifier apportés à d'autres ressources, telles que les activités, les tâches et les commandes, ne sont pas appliqués.

Les branche avec des branche enfant actif ne peuvent pas être fusionner tant que les branche enfant ne sont pas d'abord supprimer ou fusionner.

Conflits

Un conflit se produit lorsqu'une ressource (traduction, clé, ou paramètre linguistique) a changer à la fois dans la branche actuelle et sa branche de base après que la branche a été créer ou synchroniser pour la dernière fois. Des conflits peuvent se produire à n'importe quel niveau de la pile de branche, pas seulement lors de la fusion dans la branche principale.

Pour fusionner une branche, suivre ces étapes :

Depuis l'onglet branche d'un projet, cliquer sur fusionner avec la branche de base Suivant la branche souhaiter.

La page fusionner s'ouvre. Les informations sur les traduction à modifier pendant la fusion sont accessible en cliquant dans les cellules.
S'il y a des conflits, Sélectionner une stratégie de fusion :
- Sélectionner utiliser branche de base pour rejeter les modifications en conflit et conserver les traduction existantes.
- Sélectionner utiliser NomDeBranche pour Remplacer les traduction existantes par les modifications provenant de la branche.
Cliquer sur fusionner et confirmer pour appliquer les modifications.

La branche est fusionner vers la branche de base et supprimer automatiquement. Pour examiner l'historique des branche fusionner, ouvrir l'onglet fusionner dans la page branche.

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

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

use_branch résout les conflits en appliquant les modifier de la branche et, si rien n'est spécifié, il s'agit de l'option par défaut.
use_main résout les conflits en rejetant les modifications provenant de la branche. use_master est également pris en charge.

L'action fusionner supprime également automatiquement la branche fusionner.

Commandes Push et Pull

Lors de l'utilisation de l'interface de ligne de commande, spécifier une branche pour pousser ou tirer avec le paramètre --branche.

$ Phrase push --branche <nom_de_la_branche>
$ 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 actif :

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

API

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"}"