Gestione della traduzione

Branching (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Disponibile per

  • Piani Business ed Enterprise

Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

Disponibile per

  • Piano Enterprise (legacy)

Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

Il branching è utilizzato nel controllo delle versioni del software. Le copie dei file di progetto chiamate rami consentono ai team di lavorare su versioni parallele del progetto contemporaneamente mantenendo una copia non modificata. Questo elimina il rischio di sovrascrivere accidentalmente le modifiche degli altri ai file di progetto.

Il progetto principale viene copiato quando viene creato un nuovo ramo con modifiche che vengono apportate solo a quel ramo. Quando le modifiche sono complete, il ramo viene fuso di nuovo nel progetto principale. È possibile lavorare su più rami contemporaneamente e dopo la fusione, i rami possono essere eliminati. I tag di un ramo esistente vengono copiati nel nuovo ramo.

Limitazioni

  • Tutti i ruoli tranne Traduttore e Ospite hanno accesso alla vista Rami.

  • Le fusioni non possono essere annullate e i rami non possono essere ripristinati.

  • I Lavori creati in un ramo specifico non sono visibili nel progetto principale e viceversa. Quando un ramo viene fuso nel progetto principale, eventuali lavori aperti in esso vengono persi.

  • I rapporti nella vista Rapporti riflettono solo lo stato del ramo attivo. Fondere un ramo nel progetto principale aggiorna i rapporti del progetto principale.

  • La vista Attività contiene solo attività nel ramo attivo. Le attività nei rami non sono visibili nel progetto principale e viceversa. Le attività in un ramo vengono perse quando viene fuso nel progetto principale.

  • La sincronizzazione di GitHub può essere utilizzata solo sul progetto principale e non sui rami.

  • Commenti fatti in un ramo non sono visibili nel progetto principale e viceversa.

  • Ordini creati in un ramo non sono visibili nel progetto principale e viceversa. Quando un ramo viene fuso nel progetto principale, eventuali ordini aperti in esso vengono persi.

  • I traduttori non possono essere limitati a rami specifici ma ricevono il permesso di lavorare su specifici locali. I traduttori dovrebbero essere istruiti su come lavorare con i rami.

Abilita il Branching

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 Branch Menu 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 vista Rami dove vengono presentate le informazioni sulla creazione e fusione. I rami possono anche essere eliminati o fusi e possono essere creati lavori per quel ramo dalla vista Rami.

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

$ phrase branches list <project_id>

Per eliminare un ramo tramite API o CLI, esegui:

$ phrase branch delete <project_id> <branch_name>

Crea un Ramo

Le funzioni 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, segui questi passaggi:

  1. Dalla pagina di un Progetto, seleziona la scheda Rami.

  2. Clicca Crea ramo.

    Si apre la finestra Crea ramo.

  3. Fornisci un nome per il branch.

  4. Clicca Crea ramo.

    Il nuovo branch è aggiunto all'elenco.

Per creare un branch tramite API o CPI, esegui:

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

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

$ phrase push --branch <branch_name>

Unire i Branch

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

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

  • 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 un branch è creato 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 che un branch è stato creato, rendendo i valori nel branch diversi da quelli nel progetto principale.

Per unire un branch, segui questi passaggi:

  1. Dalla vista Branch di un progetto, seleziona un branch da unire e fai clic su Confronta e Unisci.

    Si apre la pagina Unire branch. Le informazioni sulle traduzioni da modificare durante l'unione possono essere accessibili facendo clic nelle celle.

  2. Se ci sono conflitti, seleziona una strategia di unione:

    • Seleziona Usa Progetto Principale per rifiutare le modifiche in conflitto e preservare le traduzioni esistenti.

    • Seleziona Usa Branch Menu NomeBranch per sostituire le traduzioni esistenti con le modifiche dal branch.

  3. Clicca Unire Branch.

    Il branch è unito al progetto principale.

Per unire un branch tramite API o CPI, esegui:

$ frase branch unire \
  --project_id <project_id> \
  --name <name> \
  --data '{"strategy":"use_main"}' \
  --access_token <token>
  • usa_branch risolve i conflitti applicando le modifiche dal branch e se non specificato è il predefinito.

  • usa_main risolve i conflitti rifiutando le modifiche dal branch. usa_master è anche supportato.

Push e pull

Quando si utilizza CLI, specifica un branch da pushare o pullare con il parametro --branch.

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

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

Usa --usa-nome-branch-locale per pushare e pullare usando il nome del branch di un git branch attivo:

$ frase push --usa-nome-branch-locale
$ frase pull --usa-nome-branch-locale

API

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

$ frase caricare creare <project_id> \

  --branch <branch_name>

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

  --file-format json \

  --locale-id abcd1234cdef1234abcd1234cdef1234 \

  --tags fantastico-caratteristica,ha-bisogno-di-correzione \

  --impostazioni-locali "{"en": "2"}" \

  --opzioni-formato "{"foo": "bar"}" 
Questo articolo ti è stato utile?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.