branching (Strings)

Branching è abilitato nella scheda Advanced di impostazioni progetto con l'opzione di proteggere il branch principale dalle modifiche.

Quando abilitato, un menu branch viene presentato nella schermata progetto dove è possibile selezionare i branch di lavoro. Per specificare un branch in CLI, usare il parametro --branch:

--branch <branch_name>

I branch sono elencati nella scheda Branches di un progetto, dove vengono presentate le informazioni su creazione e merging. I branch possono anche essere eliminati o uniti e i lavori creati per quel branch dalla scheda Branches.

Per elencare tutti i branch per progetto tramite API o CLI, eseguire:

$ phrase branches list --project_id <project_id>

# ad es.
$ phrase branches elenco --project_id 1d8ae641902624df63ce6fbd64ff9549$ phrase branches elenco <project_id>

Per eliminare un branch tramite API o CLI, esegui:

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

# ad es.
$ phrase branches eliminare --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ phrase branch eliminare <project_id> <branch_name>

I ruoli amministratore, project manager e sviluppatore possono creare nuovi branch nell'editor di traduzione, tramite API o nella CLI.

Per creare un branch nell'editor di traduzione, segui questi passaggi:

Per creare un branch tramite API o CLI, esegui:

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

Per creare un branch durante il push delle Phrase, esegui:

$ phrase push --branch <branch_name>

Dopo aver apportato modifiche a un branch, è possibile unirlo nuovamente alla Phrase principale per incorporare eventuali nuove Phrase.

Durante l'unione, al branch principale vengono applicate solo le modifiche alle seguenti risorse:

Le modifiche ad altre risorse, come attività, lavori e ordine, non vengono applicate.

Conflitti

Un conflitto si verifica quando una risorsa (traduzione, chiave o impostazioni locali) è stata modificata sia nel progetto principale che nel branch tra il momento in cui un branch viene creato e quello in cui viene unire al progetto principale. Ad esempio, le traduzioni e le impostazioni chiave (come le forme plurali) potrebbero essere cambiate nel progetto principale dopo la creazione di un branch, rendendo i valori nel branch diversi da quelli nel progetto principale.

Per unire un branch, seguire questi passaggi:

Per unire un branch tramite API o CPI, eseguire:

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

Quando si usa la CLI, specificare un branch da cui eseguire push o pull con il parametro --branch.

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

Se il branch specificato non esiste in un progetto, il cliente lo Crea.

Usare --use-local-branch-name per eseguire push e pull usando il nome branch di un branch git attivo:

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

Tutti gli endpoint API che richiedono un argomento progetto supportano anche il parametro --branch per eseguire un'azione su un ramo specifico di un progetto:

$ Phrase upload Crea <project_id> \\

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