-
Piani Business ed Enterprise
Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.
-
Piano Enterprise (legacy)
Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.
Il branching viene utilizzato nel controllo della versione del software. Le copie dei file di progetto chiamate branch consentono ai team di lavorare contemporaneamente su versioni parallele del progetto mantenendone una copia non modificata. Ciò elimina il rischio di sovrascrivere accidentalmente le modifiche altrui ai file di progetto.
Il progetto principale viene copiato quando viene creato un nuovo branch con modifiche apportate solo a quel branch. Quando le modifiche vengono completate, il branch viene unito nuovamente al progetto principale. È possibile lavorare su più branch contemporaneamente e dopo l'unione è possibile eliminare i branch. I tag di un branch esistente vengono copiati nel nuovo branch.
Limitazioni
-
Tutti i ruoli tranne Traduttore e Ospite hanno accesso alla vista .
-
Le fusioni non possono essere ripristinate e i branch non possono essere annullati.
-
I lavori creati in un branch specifico non sono visibili nel progetto principale e viceversa. Quando un branch viene unito al progetto principale, tutti i lavori aperti al suo interno vanno persi.
-
I rapporti nella visualizzazione riflettono solo lo stato del branch attivo. L'unione di un branch nel progetto principale aggiorna i rapporti sul progetto principale.
-
La visualizzazione contiene solo attività nel branch attivo. Le attività nei branch non sono visibili nel progetto principale e viceversa. Le attività in un branch vengono perse quando lo si unisce al progetto principale.
-
GitHub Sync può essere utilizzato solo sul progetto principale e non sui branch.
-
I commenti fatti in un branch non sono visibili nel progetto principale e viceversa.
-
Gli creati in un branch non sono visibili nel progetto principale e viceversa. Quando un branch viene unito al progetto principale, tutti gli ordini aperti al suo interno vanno persi.
-
I traduttori non possono essere limitati a branch specifici ma ricevono l'autorizzazione a lavorare su impostazioni locali specifiche. I traduttori dovrebbero essere istruiti su come lavorare con i branch.
Il branching è abilitato nella scheda delle con la possibilità di proteggere il branch principale dalle modifiche.
Quando abilitato, nella schermata del progetto viene visualizzata una del menu branch in cui è possibile selezionare i branch di lavoro. Per specificare un branch nella CLI, utilizzare il parametro
--branch:
--branch <branch_name>
I branch sono elencati nella visualizzazione in cui vengono presentate le informazioni di creazione e unione. I branch possono anche essere eliminati o uniti e creati lavori per quel branch dalla visualizzazione .
Per elencare tutti i branch per il progetto tramite API o CLI, eseguire:
$ elenco branch frase <project_id>
Per eliminare un branch tramite API o CLI, esegui:
$ frase branch delete <project_id> <nome_branch>
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 i passaggi riportati di seguito:
-
Da una pagina , selezionare la scheda .
-
Fai clic su Crea branch.
Si apre la finestra .
-
Fornisci un nome per il branch.
-
Fai clic su Crea branch.
Il nuovo branch viene aggiunto all'elenco.
Per creare un branch tramite API o CPI, esegui:
$ phrase branch create --project_id <project_id> --data <data>
Per creare un branch durante il push delle traduzioni, esegui:
$ frase push --branch <nome_branch>
Dopo che sono state apportate modifiche a un branch, può essere unito nuovamente alla traduzione principale per incorporare eventuali nuove traduzioni.
Solo le modifiche alle seguenti risorse vengono applicate al branch principale durante le fusioni:
-
Impostazioni locali
-
Chiavi
-
Traduzioni
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 nel progetto principale tra il momento in cui viene creato un branch e quando viene accorpata al progetto principale. Ad esempio, traduzioni e impostazioni di chiavi come 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, segui i passaggi riportati di seguito:
-
Dalla visualizzazione di un progetto, selezionare un branch per l'unione e fare clic su Confronta e Unisci.
Si apre la pagina . Le informazioni sulle traduzioni da modificare durante l'unione sono accessibili facendo clic nelle celle.
-
In caso di conflitti, selezionare una strategia di unione:
-
Seleziona per rifiutare le modifiche in conflitto e conservare le traduzioni esistenti.
-
Seleziona Usa
BranchName per sostituire le traduzioni esistenti con modifiche dal branch.
-
-
Fai clic su Unisci branch.
Il branch viene unito al progetto principale.
Per unire un branch tramite API o CPI, esegui:
$ frase branch unisci \
--project_id <project_id> \
--name <name> \
--data '{"strategy":"use_master"}' \
--access_token <token>
-
use_branchrisolve i conflitti applicando le modifiche dal branch e se non specificato è predefinito. -
use_masterrisolve i conflitti rifiutando le modifiche dal branch.
Quando usi CLI, specifica un branch da cui effettuare il push o il pull con il parametro --branch.
$ frase push --branch <nome_branch> $ frase pull --branch <nome_branch>
Se il branch specificato non esiste in un progetto, viene creato dal cliente.
Usa --use-local-branch-name per effettuare push e pull usando il nome del branch di un branch git attivo:
$ frase push --use-local-branch-name $ frase pull --use-local-branch-name
Tutti gli endpoint API che accettano un argomento di progetto supportano anche il parametro --branch per eseguire un'azione su un branch specifico di un progetto:
$ frase caricamento creare <project_id> \
--branch <branch_name>
--file /path/to/my/file.json \
--file-format json \
--locale-id abcd1234cdef1234abcd1234cdef1234 \
--tags impressionante-caratteristica, necessità-proofreading \
--locale-mapping '{"en": "2"}" \
--format-options "{"foo": "bar"}"