Gerenciamento de versões

Mantenha um processo de localização ágil e evite atrasos na tradução de textos adicionados ou novos recursos do produto. Integre as ramificações do seu projeto com o Crowdin e permita que os tradutores acessem imediatamente todos os novos textos.

Ramificações

Quando várias pessoas estão trabalhando no desenvolvimento de produtos, as ramificações ajudam a gerenciar diferentes versões do conteúdo. Se você tiver um projeto contínuo, poderá adicionar ramificações ao Crowdin e permitir que os tradutores traduzam os textos em paralelo com o desenvolvimento, para evitar atrasos na implantação.

A ramificação no Crowdin parece uma pasta comum marcada com um ícone especial e possui um comportamento específico para sequências de caracteres duplicadas.
O exemplo de uma estrutura de arquivos no sistema de controle de versão (VCS) e Crowdin:

Criação de ramificação

Existem algumas maneiras de adicionar ramificações ao Crowdin:

• Integrar projetos Crowdin com GitLab, GitHub, ou Bitbucket. É uma opção recomendada, pois as ramificações selecionadas para localização no seu sistema de controle de versão (VCS) serão criadas automaticamente no Crowdin
• Use CLI ou API para adicionar novas ramificações
• Create branches manually by going to Content > Files > New Version Branch

Criação de ramificação usando API

Para criar um ramo via API, use o Adicionar diretório método com is_branch=1 parâmetro:

Adicionar arquivo, Atualizar arquivo, Carregar Traduções e outros métodos que manipulam arquivos e pastas funcionam com parâmetro branch={branch_name}.

Gerenciamento de ramificação usando CLI

Não há necessidade de executar um comando específico para criar ramificações de versão se a CLI for usada. O ramo da versão seria criado automaticamente enquanto o upload de arquivos. Exemplo dos arquivos de origem / upload de traduções para o ramo de versão especificado:

$ crowdin upload sources -b branch_name

$ crowdin upload translations -b branch_name

Duplicatas

Como as ramificações são as diferentes versões do mesmo recurso do produto, o conteúdo da localização nelas geralmente é duplicado. To help translators translate versions consistently and avoid additional translation costs, we have the Show within a version branch option that allows hiding duplicated strings only between versions. If your source files contain strings with apparent identifiers (keys), it’s better to use a strict version of this option. Em outros casos, sinta-se à vontade para usar uma normal.

Quando essa opção é selecionada, apenas nos textos originais que foram carregadas pela primeira vez no sistema devem ser convertidas. Todas as cadeias duplicadas obterão automaticamente as traduções das cadeias originais.

Fluxo de trabalho sugerido

Para garantir que as versões funcionem sem problemas no seu projeto Crowdin, recomendamos o seguinte fluxo de trabalho:

1. Carregue seus arquivos de projeto no projeto Crowdin usando um dos seguintes métodos disponíveis.
2. Open your project and go to the Settings tab.
3. Scroll down to the Translations > Duplicate Strings and choose the option recommended for versions.

A captura de tela abaixo mostra como o fluxo de trabalho funciona na prática. Todos os textos de Master, Branch 1 e Branch 2 são transferidos para o servidor de tradução imediatamente após aparecerem, mesmo que as ramificações não sejam mescladas com o ramo Master ainda.

Exportar traduções

As traduções de todas as ramificações de versão são colocadas em um arquivo ZIP quando são baixadas pela interface da web. Use the CLI or API to download the translations for each branch individually.

Exportar traduções usando API

Exportar traduções do ramo da versão especificada:

Download de traduções do ramo da versão especificada:

Exportar traduções usando CLI

Download de traduções do ramo da versão especificada:

$ crowdin download -b branch_name

Mesclando ramificações

A ramificação Master conterá novos textos das ramificações Feature assim que elas forem mescladas. Durante a sincronização com o Crowdin, todos os textos no ramo Master são preenchidos com traduções do ramo apropriado.

Após a sincronização do arquivo de ramificação atualizado Master com Crowdin, a ramificação Feature can pode ser removido do Crowdin. Todas as traduções armazenadas na ramificação Master permanecerá.

Verificação da tradução da ramificação

Você pode verificar as traduções na produção usando apenas a ramificação Feature antes que as alterações sejam mescladas com a ramificação Master. Essa implementação de teste oferece uma opção de reversão rápida para a versão de ramificação original Master, se necessário.

Veja também

• Configuração VCS
• Baixar traduções