Branching (Strings)

Il Branching è abilitato nella scheda Avanzate delle Impostazioni del progetto con l'opzione di proteggere il ramo principale dalle modifiche.

Quando abilitato, un menu dei rami viene presentato sulla schermata del progetto dove possono essere selezionati i rami di lavoro. Per specificare un ramo in CLI, usa il parametro --branch:

--branch <branch_name>

I rami sono elencati nella scheda Rami di un progetto, dove vengono presentate informazioni sulla creazione e fusione. I rami possono anche essere eliminati o fusi e possono essere creati lavori per quel ramo dalla scheda Rami.

Per elencare tutti i rami per il progetto tramite API o CLI, esegui:

$ frase rami elenco --project_id <project_id>

# ad es.
$ frase rami elenco --project_id 1d8ae641902624df63ce6fbd64ff9549$ frase rami elenco <project_id>

Per eliminare un ramo tramite API o CLI, eseguire:

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

# ad es.
$ frase rami elimina --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ frase ramo elimina <project_id> <branch_name>

I ruoli di Amministratore, Project Manager e Sviluppatore possono creare nuovi rami nell'editor di traduzione, tramite API o nella CLI.

Per creare un ramo nell'editor di traduzione, seguire questi passaggi:

Per creare un ramo tramite API o CPI, eseguire:

$ frase rami crea --project_id <project_id> --data <data>

Per creare un ramo durante il caricamento delle traduzioni, eseguire:

$ frase push --branch <branch_name>

Dopo che sono state apportate modifiche a un ramo, può essere unito di nuovo nella traduzione principale per incorporare eventuali nuove traduzioni.

Solo le modifiche alle seguenti risorse vengono applicate al ramo principale durante le unioni:

Le modifiche ad altre risorse, come Attività, Lavori e Ordini, non vengono applicate.

Conflitti

Un conflitto si verifica quando una risorsa (traduzione, chiave o impostazioni locali) è cambiata sia nel progetto principale che nel branch tra il momento in cui viene creato un branch e quando viene unito di nuovo al progetto principale. Ad esempio, le traduzioni e le impostazioni delle chiavi (come le forme plurali) possono 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, segui questi passaggi:

Per unire un branch tramite API o CPI, esegui:

$ frase branch unisci \
  --project_id <project_id> \
  --nome <nome> \
  --data '{"strategia":"usa_principale"}' \
  --access_token <token>

Quando si utilizza CLI, specifica un branch da inviare o ricevere con il parametro --branch.

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

Se il ramo specificato non esiste in un progetto, il cliente lo crea.

Usa --use-local-branch-name per eseguire push e pull utilizzando il nome del ramo di un ramo git attivo:

$ frase push --use-local-branch-name
$ frase 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:

$ frase upload create <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"}"