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 Vendas para perguntas sobre licenciamento.

    Disponível para

    • Plano Enterprise (legado)

    Entre em contato com Vendas para perguntas sobre licenciamento.

    Importante

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

    Clientes existentes podem optar pela nova modelo de ramificação selecionando Trocar para nova ramificação na aba Branches de um projeto.

    A ramificação legada 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 ramificações 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 uma nova ramificação é criada, com alterações sendo feitas apenas nessa ramificação. Quando as alterações estão completas, a ramificação é mesclada de volta ao projeto principal. Várias ramificações podem ser trabalhadas ao mesmo tempo e, após a mesclagem, as ramificações são automaticamente excluídas. Ramificações mescladas permanecem disponíveis na aba Mescladas para rastreamento simplificado do histórico. Tags de uma ramificação existente são copiadas para a nova ramificação.

    Limitações

    • Todos os papéis exceto Tradutor e Convidado têm acesso à visualização Branches.

    • Mesclagens não podem ser revertidas e ramificações não podem ser desfeitas.

    • 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 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 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 ao 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 ao projeto principal, quaisquer pedidos abertos nele são perdidos.

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

    Ativar Ramificação

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

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

    --branch <branch_name>

    Ramos são listados na aba Ramos de um projeto, onde informações sobre 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 Ramos.

    Dica

    Clique Alternar para nova ramificação na aba Ramificações para acessar a nova interface e recursos de ramificação.

    Para listar todas as ramificações do projeto via API ou CLI, execute:

    $ phrase branches list --project_id <project_id>

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

    Para excluir uma ramificação via API ou CLI, execute:

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

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

    Criar um Ramo (Legado)

    Os papéis de Admin, Gerente de Projetos e Desenvolvedor podem criar novas ramificações no editor de tradução, via API ou no CLI.

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

    1. Na página de um Projeto, selecione a aba Ramificações.

    2. Clique Criar ramo.

      A janela Criar ramo se abre.

    3. Forneça um nome para a ramificação.

    4. Clique Criar ramo.

      A nova ramificação é adicionada à lista.

    Para criar uma ramificação via API ou CPI, execute:

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

    Para criar uma ramificação ao enviar traduções, execute:

    $ frase push --ramo <nome_do_ramo>

    Mesclar Ramos (Legado)

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

    Apenas as 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 mudado no projeto principal após a criação de um ramo, fazendo com que os valores no ramo sejam diferentes dos do projeto principal.

    Para mesclar um ramo, siga estes passos:

    1. Na visualização de Ramos de um projeto, selecione um ramo para mesclar e clique em Comparar e Mesclar.

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

    2. Se houver conflitos, selecione uma estratégia de mesclagem:

      • Selecione Usar Projeto Principal para rejeitar as alterações conflitantes e preservar as traduções existentes.

      • Selecione Usar Branch Menu NomeDoRamo para substituir as traduções existentes pelas 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 branches merge \\
  --project_id <project_id> \\
  --name <name> \\
  --data '{"strategy":"use_main"}' \
  --access_token <token>

    • usar_ramo resolve conflitos aplicando mudanças do ramo e, se não especificado, é o padrão.

    • usar_main resolve conflitos rejeitando mudanças do ramo. usar_master também é suportado.

    Push e Pull (Legado)

    Ao usar CLI, especifique um ramo para enviar ou puxar com o parâmetro --branch.

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

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

    Use --usar-nome-do-ramo-local para enviar e puxar usando o nome do ramo de um ramo git ativo:

    $ phrase push --usar-nome-do-ramo-local
$ phrase pull --usar-nome-do-ramo-local

    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 create <project_id> \\

  --branch <branch_name>

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

  --file-format json \\

  --locale-id abcd1234cdef1234abcd1234cdef1234 \

  --tags recurso-incrível,precisa-revisão \\

  --locale-mapping "{"en": "2"}" \

  --format-options "{"foo": "bar"}"

    Nova Ramificação

    Disponível para

    • Planos Business e Enterprise

    Entre em contato com Vendas para perguntas sobre licenciamento.

    Importante

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

    Clientes existentes podem optar pela nova modelo de ramificação selecionando Trocar para nova ramificação na aba Branches de um projeto.

    A nova experiência de ramificação introduz uma arquitetura redesenhada para melhorar o desempenho, a estabilidade e a flexibilidade, além de expandir as capacidades de controle de versão. Ela permite que as equipes trabalhem em várias versões de seu conteúdo em paralelo, mantenham ramificações de longa duração atualizadas e mesclem alterações de forma mais eficiente.

    Novos recursos incluem:

    • Ramificações de múltiplos níveis (empilhadas)

      As ramificações podem ser criadas a partir de qualquer outra ramificação, não apenas da ramificação principal. Até 5 níveis de ramificação são suportados.

    • Sincronização de alterações entre ramificações

      Ramificações de longa duração podem se tornar desatualizadas à medida que as alterações se acumulam em suas ramificações base. A nova ramificação introduz uma capacidade de sincronização que ajuda a prevenir inconsistências.

    Ramificações que permanecem não mescladas por mais de 30 dias desde sua criação contam para Strings palavras gerenciadas.

    Criar uma Ramificação

    Os papéis de Admin, Gerente de Projetos, Designer e Desenvolvedor podem criar novas ramificações na aba Ramificações, via API ou na CLI.

    Para criar uma ramificação pela interface, siga estes passos:

    1. Na página de um Projeto, selecione a aba Ramificações.

    2. Clique Criar ramo.

      A janela Criar ramo se abre.

    3. Forneça um nome para a ramificação.

    4. Selecione uma Ramificação base na lista de ramificações existentes.

    5. Clique em Criar.

      A nova ramificação é adicionada à lista.

    Para criar uma ramificação via API ou CPI, execute:

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

    Para criar uma ramificação ao enviar traduções, execute:

    $ frase push --ramo <nome_do_ramo>

    Sincronizar Ramos

    A sincronização garante que o ramo de trabalho permaneça alinhado com as últimas alterações do ramo de origem. 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 o ramo base ao lado do ramo desejado.

      A página Sincronizar é exibida com informações sobre quaisquer conflitos e alterações a serem sincronizadas 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 se tornam visíveis no editor de tradução. Informações sobre a última sincronização são exibidas na coluna Sincronizado da aba Ramos.

    A sincronização de ramos 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 mudanças do ramo e, se não especificado, é o padrão.

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

    Mesclar Ramos

    Após concluir a tradução ou o trabalho 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 é automaticamente excluído e aparece na aba Mesclado para rastreamento de histórico.

    Apenas alterações nos seguintes recursos são aplicadas ao ramo base durante as 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 estes passos:

    1. Na aba Ramos de um projeto, clique em Mesclar com o ramo base ao lado do ramo desejado.

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

    2. Se houver conflitos, selecione uma estratégia de mesclagem:

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

      • Selecione Usar Branch Menu NomeDoRamo para substituir as traduções existentes pelas alterações do ramo.

    3. Clique em Mesclar e confirme para aplicar as alterações.

      O ramo é mesclado ao ramo base e excluído automaticamente. Para revisar o histórico do ramo mesclado, abra a aba Mesclados na página Ramos.

    Para mesclar um ramo via API ou CPI, execute:

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

    • usar_ramo resolve conflitos aplicando mudanças do ramo e, se não especificado, é o padrão.

    • usar_main resolve conflitos rejeitando mudanças do ramo. usar_master também é suportado.

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

    Push e Pull (Legado)

    Ao usar CLI, especifique um ramo para enviar ou puxar com o parâmetro --branch.

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

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

    Use --usar-nome-do-ramo-local para enviar e puxar usando o nome do ramo de um ramo git ativo:

    $ phrase push --usar-nome-do-ramo-local
$ phrase pull --usar-nome-do-ramo-local

    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 create <project_id> \\

  --branch <branch_name>

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

  --file-format json \\

  --locale-id abcd1234cdef1234abcd1234cdef1234 \

  --tags recurso-incrível,precisa-revisão \\

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