Gerenciamento de tradução

Branching (Strings)

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

Disponível a partir de

  • Planos de negócios e empresarial

Entre em contato com Comércio para perguntas de licenciamento.

Disponível a partir de

  • Plano Enterprise (legado)

Entre em contato com Comércio para perguntas de licenciamento.

O ramificação é usado no controle de versão de software. Cópia de arquivos de projeto chamados ramos permitem que equipes trabalhem em versões paralelas do projeto ao mesmo tempo e ainda mantenham uma cópia não editada. Isso elimina os riscos de substituir accidentalmente as alterações de outras pessoas para arquivos do projeto.

O projeto principal é copiado quando um novo ramo é criado, com alterações feitas apenas a esse ramo. Quando as alterações são concluídas, o ramo é mesclado novamente no projeto principal. Vários ramos podem ser trabalhados ao mesmo tempo e, após a mesclagem, os ramos podem ser excluídos. Códigos de um ramo existente são copiados no novo ramo.

Limitations

  • Todas as funções com exceção do tradutor e do convidado têm acesso à visualização Ramo.

  • As mesclagens não podem ser revertidas e os ramos não podem ser desmarcados.

  • Os 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, todos os trabalhos abertos nele são perdidos.

  • Relatórios na visão de relatórios refletem apenas a situação do ramo ativo. A mesclagem de um ramo no projeto principal atualiza os relatórios do projeto principal.

  • A exibição de Atividades contém apenas as atividades no ramo ativo. As atividades nos ramos não são visíveis no projeto principal e vice versa. As atividades em um ramo são perdidas quando são mescladas no projeto principal.

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

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

  • Os ordenados criados em um ramo não são visíveis no projeto principal e vice versa. Quando um ramo é mesclado ao projeto principal, todos os pedidos abertos nele são perdidos.

  • Os tradutores não podem ser limitados a ramos específicos, mas têm permissão para trabalhar em localidades específicas. Os tradutores devem ser instruídos em como trabalhar com ramos.

Ativar ramificação

O ramificação está habilitado na guia Advanced das configurações do projeto, com a opção de proteger o ramo principal de alterações.

Quando ele está ativado, um branch_menu.png de menu ramificado é apresentado na tela do projeto, onde ramos de trabalho podem ser selecionados. Para especificar um ramo no CLI, use o parâmetro --ramo:

--branch <branch_name>

Os ramos são listados na exibição de ramos onde são apresentadas informações de criação e merge. Os ramos também podem ser excluídos ou mesclados e trabalhos criados para esse ramo a partir da exibição Ramos.

Para listar todos os ramos para o projeto por meio da API ou CLI, execute:

$ lista de ramos de expressão <project_id>

Para excluir um ramo por meio da API ou CLI, execute:

$ phrase branch delete <project_id> <branch_name>

Criar um ramo

As funções de administrador, gerente de projeto e desenvolvedor podem criar novos ramos no editor de tradução, via API ou no CLI.

Para criar um ramo no editor de tradução, siga estes passos:

  1. Em uma página de projeto, selecione a aba de Ramo.

  2. Clique em Criar ramo.

    A janela Criar ramo é aberta.

  3. Forneça um nome para o ramo.

  4. Clique em Criar ramo.

    O novo ramo está adicionado à lista.

Para criar um ramo por meio da API ou CPI, execute:

$ ramos de expressão criam --project_id <project_id> --data <data>

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

$ phrase push --branch <branch_name>

Fazer merge

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 fusões:

  • Locais

  • Chaves

  • Traduções

As alterações de outros recursos, como atividades, trabalhos e pedidos, não são aplicadas.

Conflitos

Ocorre um conflito quando um recurso (tradução, chave ou local) foi alterado no projeto principal entre o momento em que um ramo é criado e quando ele é mesclado de volta ao projeto principal. Por exemplo, as traduções e as 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 dos do projeto principal.

Para fazer o merge de um ramo, siga estes passos:

  1. No modo de exibição de Ramificações de um projeto, selecione um ramo para merge e clique em Comparar e Mesclar.

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

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

    • Selecione Usar projeto principal para reprovar as alterações conflitantes e preservar as traduções existentes.

    • Selecione Usar branch_menu.png ramoNome para substituir traduções existentes por alterações do ramo.

  3. Clique em Unir ramo.

    O ramo é mesclado ao projeto principal.

Para fazer o merge de um ramo por meio da API ou CPI, execute:

$ ramos da expressão merge \
  --project_id <project_id> \
  --name <name>\
  --data '{"strategy":"use_master"}' \
  --access_token <token>
  • O use_branch resolve os conflitos aplicando alterações do ramo e, se não for especificado, é o padrão.

  • O use_master resolve os conflitos rejeitando as alterações do ramo.

Push e pull

Ao usar CLI, especifique um ramo para empurrar ou retirar com o parâmetro --ramo.

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

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

Use --use-local-branch-name para empurrar e puxar usando o nome do ramo de git ativo:

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

API

Todos os endpoints da API que tomam um argumento de projeto também aceitam o parâmetro --ramo 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 \

  --códigos com recurso incrível, precisam de revisão de prova \

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