Gerenciamento de tradução
    1. Phrase
    2. Phrase Strings
    3. Gerenciamento de tradução

    Ramificação (Strings)

    O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

    Disponível para

    • Planos Business e Enterprise

    Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.

    Disponível a partir de

    • Plano Enterprise (legado)

    Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.

    Importante

    A partir de 10 de dezembro de 2025, a nova ramificação está habilitada por padrão para todos os novos clientes.

    Clientes existentes podem optar pelo novo modelo de ramificação selecionando Mudar para nova ramificação na aba Ramos de um projeto.

    A ramificação de legado será descontinuada a partir de 1 de junho de 2026.

    A ramificação é usada no controle de versão de software. Cópias de arquivos de projeto chamadas ramos permitem que equipes trabalhem em versões paralelas do projeto ao mesmo tempo, mantendo uma cópia não editada. Isso elimina o risco de sobrescrever acidentalmente as alterações de outros nos arquivos do projeto.

    O projeto principal é copiado quando um novo ramo é criado, com as alterações sendo feitas apenas nesse ramo. Quando as alterações estão Concluir, o ramo é mesclado de volta ao projeto principal. Múltiplos ramos podem ser trabalhados ao mesmo tempo e, após a mesclagem, os ramos são excluídos automaticamente. Ramos mesclados permanecem disponíveis na aba Mesclado para rastreamento de histórico simplificado. Tags de um ramo existente são copiadas para o novo ramo.

    Limitações

    • Todas as funções exceto tradutor e convidado têm acesso à visualização de Ramos.

    • Mesclagens não podem ser revertidas e ramos não podem ser recuperados.

    • Trabalhos criados em um ramo específico não são visíveis no projeto principal e vice-versa. Quando um ramo é mesclado ao projeto principal, quaisquer trabalhos abertos nele são perdidos.

    • Relatórios na visualização de Relatórios refletem apenas o estado do ramo ativo. Mesclar um ramo ao projeto principal atualiza os relatórios do projeto principal.

    • A visualização de Atividade contém apenas atividades no ramo ativo. Atividades em ramos não são visíveis no projeto principal e vice-versa. Atividades em um ramo são perdidas ao mesclá-lo no projeto principal.

    • A sincronização do GitHub só pode ser usada no projeto principal e não em ramos.

    • Comentários feitos em um ramo não são visíveis no projeto principal e vice-versa.

    • Pedidos criados em um ramo não são visíveis no projeto principal e vice-versa. Quando um ramo é mesclado no projeto principal, quaisquer pedidos abertos nele são perdidos.

    • Tradutores não podem ser restritos a ramos específicos, mas recebem permissão para trabalho em locales específicos. Tradutores devem ser instruídos sobre como trabalhar com ramos.

    Ativar ramificação

    A ramificação é ativada na aba Advanced das configurações do projeto com a opção de proteger o ramo principal contra alterações.

    Quando ativado, um menu de ramo Branch Menu é apresentado na tela do projeto, onde ramos de trabalho podem ser selecionados. Para especificar um ramo na CLI, usar o parâmetro --branch:

    --branch <branch_name>

    Ramos são listados na aba Branches de um projeto, onde informações de criação e mesclagem são apresentadas. Ramos também podem ser excluídos ou mesclados e trabalhos criados para esse ramo a partir da aba Branches.

    Dica

    Clique em Switch to new branching na aba Branches para acessar a nova interface e recursos de ramificação.

    Para listar todos os ramos para o projeto via API ou CLI, execute:

    $ phrase branches list --project_id <project_id>

# ex.
$ phrase branches list --project_id 1d8ae641902624df63ce6fbd64ff9549$ phrase branches list <project_id>

    Para excluir um ramo via API ou CLI, execute:

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

# ex.
$ phrase branches delete --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ phrase branch delete <project_id> <branch_name>

    Criar um ramo (legado)

    Funções de admin, gerente de projetos e desenvolvedor podem criar novos ramos no editor de tradução, via API ou na CLI.

    Para criar um ramo no editor de tradução, siga estas etapas:

    1. A partir de uma página de projeto, selecione a aba de ramos.

    2. Clique em Criar ramo.

      A janela Criar ramo abre.

    3. Forneça um nome para o ramo.

    4. Clique em Criar ramo.

      O novo ramo é adicionado à lista.

    Para criar um ramo via API ou CLI, execute:

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

    Para criar um ramo ao enviar traduções, execute:

    $ phrase push --branch <branch_name>

    Mesclar ramos (legado)

    Após as alterações serem feitas em um ramo, ele pode ser mesclado de volta na tradução principal para incorporar quaisquer novas traduções.

    Apenas alterações nos seguintes recursos são aplicadas ao ramo principal durante as mesclagens:

    • Locais

    • Chaves

    • Traduções

    Alterações em outros recursos, como Atividades, Trabalhos e pedidos, não são aplicadas.

    Conflitos

    Um conflito ocorre quando um recurso (tradução, chave ou local) foi alterado tanto no projeto principal quanto no ramo entre o momento em que um ramo é criado e quando ele é mesclado de volta ao projeto principal. Por exemplo, traduções e configurações de chave (como formas plurais) podem ter sido alteradas no projeto principal após a criação de um ramo, tornando os valores no ramo diferentes daqueles no projeto principal.

    Para mesclar um ramo, siga estas etapas:

    1. Na visualização Ramos de um projeto, Selecionar um ramo para mesclar e clique em comparar e mesclar.

      A página mesclar ramo abre. Informações sobre traduções a serem modificadas durante a mesclar podem ser acessadas clicando nas células.

    2. Se houver conflitos, selecionar uma estratégia de mesclar:

      • Selecionar usar projeto principal para rejeitar as alterações conflitantes e preservar as traduções existentes.

      • Selecionar usar Branch Menu NomeDoRamo para Substituir as traduções existentes com alterações do ramo.

    3. Clique em mesclar ramo.

      O ramo é mesclado ao projeto principal.

    Para mesclar um ramo via API ou CPI, execute:

    $ Phrase ramos mesclar \
  --project_id <project_id> \
  --name <name> \
  --data '{"strategy":"use_main"}' \
  --access_token <token>

    • usar_ramo resolve conflitos aplicando alterações do ramo e, se não especificado, é o padrão.

    • usar_principal resolve conflitos rejeitando alterações do ramo. usar_mestre também é suportado.

    Push e Pull (legado)

    Ao usar a CLI, especifique um ramo para fazer push ou pull com o parâmetro --branch.

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

    Se o ramo especificado não existir em um projeto, o cliente o cria.

    Usar --use-local-branch-name para fazer push e pull usando o nome de um ramo git ativo:

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

    API (legado)

    Todos os endpoints da API que aceitam um argumento de projeto também suportam o parâmetro --branch para realizar uma ação em um ramo específico de um projeto:

    $ Phrase upload Criar <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"}"

    Nova ramificação

    Disponível para

    • Planos Business e Enterprise

    Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.

    A nova experiência de ramificação introduz uma arquitetura reprojetada para melhorar o desempenho, a estabilidade e a flexibilidade, além de recursos expandidos de controle de versão. Ela permite que as equipes trabalhem em várias versões de seu conteúdo em paralelo, mantenham ramos de longa duração atualizados e mesclem alterações com mais eficiência.

    Novos recursos incluem:

    • Ramos (empilhados) de vários níveis

      Ramos podem ser criados a partir de qualquer outro ramo, não apenas do ramo principal. São suportados até 5 níveis de ramo.

    • Sincronizando alterações entre ramos

      Ramos de longa duração podem ficar desatualizados à medida que as alterações se acumulam em seus ramos base. A nova ramificação introduz uma capacidade de sincronização que ajuda a evitar inconsistências.

    Ramos que permanecem sem mesclagem por mais de 30 dias desde sua criação contam para as palavras gerenciadas do Strings.

    Criar um ramo

    Funções de admin, gerente de projetos, designer e desenvolvedor podem criar novos ramos na aba Ramos, via API ou na CLI.

    Para criar um ramo a partir da interface do usuário, siga estas etapas:

    1. A partir de uma página de projeto, selecione a aba de ramos.

    2. Clique em Criar ramo.

      A janela Criar ramo abre.

    3. Forneça um nome para o ramo.

    4. Selecione um Ramo base na lista de ramos existentes.

    5. Clique em Criar.

      O novo ramo é adicionado à lista.

    Para criar um ramo via API ou CLI, execute:

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

    Para criar um ramo ao enviar traduções, execute:

    $ phrase push --branch <branch_name>

    Sincronizar ramos

    A sincronização garante que o ramo de trabalho permaneça alinhado com as alterações mais recentes do ramo do qual se originou. Dessa forma, os tradutores podem trabalhar com uma versão atualizada do conteúdo também em projetos de longo prazo.

    Para sincronizar um ramo com seu ramo base, siga estas etapas:

    1. Na aba Ramos, clique em Sincronizar com ramo base ao lado do ramo desejado.

      A página Sincronizar é exibida com informações sobre quaisquer conflitos e alterações a serem sincronizados com o ramo base.

    2. Clique em qualquer uma das alterações detectadas para revisá-la antes de sincronizar.

      Uma tabela com detalhes sobre a alteração selecionada é exibida.

    3. Selecione Sincronizar e confirme para aplicar as alterações.

      As alterações são adicionadas ao ramo base e tornam-se visíveis no editor de tradução. Informações sobre a última sincronização são exibidas na coluna Synced da aba Branches.

    A sincronização de ramo também pode ser realizada via API executando este comando CLI:

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

    • usar_ramo resolve conflitos aplicando alterações do ramo e, se não especificado, é o padrão.

    • use_main resolve conflitos rejeitando alterações do ramo e refere-se ao ramo base. Ao trabalhar com ramos empilhados, o ramo base não é necessariamente o ramo principal do projeto.

    Mesclar ramos

    Após concluir o trabalho de tradução ou específico de versão em um ramo, quaisquer alterações podem ser mescladas no ramo base. Uma vez que todas as alterações sejam mescladas na cadeia, o ramo de nível superior pode ser mesclado no ramo principal.

    Após uma mesclagem bem-sucedida, o ramo mesclado é excluído automaticamente e aparece na aba Merged para rastreamento de histórico.

    Apenas alterações nos seguintes recursos são aplicadas ao ramo base durante mesclagens:

    • Locais

    • Chaves

    • Traduções

    Alterações em outros recursos, como Atividades, Trabalhos e pedidos, não são aplicadas.

    Ramos com ramos secundários ativos não podem ser mesclados até que os ramos secundários sejam excluídos ou mesclados primeiro.

    Conflitos

    Um conflito ocorre quando um recurso (tradução, chave ou local) foi alterado tanto no ramo atual quanto no seu ramo base após o ramo ter sido criado ou sincronizado pela última vez. Conflitos podem ocorrer em qualquer nível da pilha de ramos, não apenas ao mesclar no principal.

    Para mesclar um ramo, siga estas etapas:

    1. Na aba Branches de um projeto, clique em Merge with base branch ao lado do ramo desejado.

      A página Merge é aberta. Informações sobre traduções a serem modificadas durante a mesclar podem ser acessadas clicando nas células.

    2. Se houver conflitos, selecionar uma estratégia de mesclar:

      • Selecione Use Base Branch para rejeitar as alterações conflitantes e preservar as traduções existentes.

      • Selecionar usar Branch Menu NomeDoRamo para Substituir as traduções existentes com alterações do ramo.

    3. Clique em Merge e confirmar para aplicar as alterações.

      O ramo é mesclado ao ramo base e excluído automaticamente. Para revisar o histórico de ramos mesclados, abra a aba Merged na página Branches.

    Para mesclar um ramo via API ou CPI, execute:

    $ Phrase ramos mesclar \
  --project_id <project_id> \
  --name <name> \
  --data '{"strategy":"use_main"}' \
  --access_token <token>

    • usar_ramo resolve conflitos aplicando alterações do ramo e, se não especificado, é o padrão.

    • usar_principal resolve conflitos rejeitando alterações do ramo. usar_mestre também é suportado.

    A ação merge também exclui o ramo mesclado automaticamente.

    Push e Pull (legado)

    Ao usar a CLI, especifique um ramo para fazer push ou pull com o parâmetro --branch.

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

    Se o ramo especificado não existir em um projeto, o cliente o cria.

    Usar --use-local-branch-name para fazer push e pull usando o nome de um ramo git ativo:

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

    API (legado)

    Todos os endpoints da API que aceitam um argumento de projeto também suportam o parâmetro --branch para realizar uma ação em um ramo específico de um projeto:

    $ Phrase upload Criar <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"}"
    Esse artigo foi útil?
    ★ ★ ★ ★ ★

    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.

    Articles related to Administration

    Articles related to Project Manager