Integração do GitHub

A integração da Crowdin com o GitHub torna os arquivos de origem e de tradução sincronizados com o repositório GitHub e o projeto de tradução Crowdin. Todos os arquivos traduzidos e aprovados serão automaticamente pressionados como um pedido de extração para o ramo l10n no repositório GitHub.

Conectando o GitHub com Crowdin

Primeiro, abra Configurações do projeto, Integrações tab em Crowdin. Então você tem duas opções. Você pode usar sua conta GitHub ou a integração GitHub Enterprise Account.

Para integrar através da sua Conta GitHub, você pode clicar Configurar Integração e então autorizar a conexão com Crowdin no lado GitHub:

Caso o repositório que você precisa é privado, e você tem acesso limitado ou nenhum, pergunte ao proprietário do repositório para lhe fornecer o Token de acesso. Em seguida, insira o token no campo Token e clique Configurar Integração.

Para integrar via Conta GitHub Enterprise você deve criar um token de acesso. Certifique-se de selecionar todos os escopos necessários: - Acesso a seus repositórios públicos ou controle total de repositórios privados (dependendo do tipo de repositório que deseja traduzir) - Controle total dos ganchos do repositório (para que você possa obter alguns arquivos novos ou mudanças nos antigos traduzidos também) - Atualizar todos os dados do usuário

Em seguida, insira o token de acesso e o URL básico nos campos correspondentes. CliqueConfigurar Integração para prosseguir.

Após a integração bem-sucedida, um diálogo pop-up apareceria na sua guia Configurações do projeto, Integrações no Crowdin. No pop-up recém-exibido, continue o processo de configuração da integração, selecionando o repositório necessário e os ramos que devem ser traduzidos.

Recomenda-se alternar o processamento de frases duplicadas para a configuração Mostrar (Recomendado para versões), de modo as frases iguais serão ocultas nas ramificações.

Serviço de ramos

Quando as traduções terminarem e seus idiomas estiverem prontos, o Crowdin enviará uma solicitação de mesclagem com traduções para o seu sistema de controle de versão. Para cada ramo que está em localização, a Crowdin cria ramificação de serviço adicional com traduções. Nós não nos comprometemos diretamente com o ramo mestre assim você pode verificar as traduções primeiro.

Por padrão, l10n \ _ é adicionado ao nome da ramificação do serviço criado. Se necessário, pode ser facilmente alterado.

Ramos para sincronizar automaticamente

Quando você configura a integração, seleciona as ramificações de repositórios existentes que devem ser adicionadas ao projeto Crowdin. Para adicionar ramificações futuras do GitHub ao Crowdin automaticamente, crie um padrão para os nomes das ramificações. Se um nome de ramificação segue um determinado padrão, ele será automaticamente adicionado ao Crowdin.

Por exemplo, você adiciona um padrão *feature nas configurações de integração do GitHub. Nesse caso, as futuras ramificações que contêm essa palavra no final do título serão adicionadas ao projeto.

Para adicionar um padrão para nomes de ramificações, siga estas etapas:

  1. Clique Editar na seção de integração do GitHub.
  2. No diálogo pop-up, clique em Mostrar configurações avançadas no canto inferior esquerdo.
  3. No campo Ramos para sincronizar automaticamente, usar seletores de caractere curinga, como ‘*’, ‘?’, ‘[set]’, ‘' e outros para identificar os ramos necessários.
  4. Clique Salvar.

Selecionando conteúdo para sincronização

Para fazer a integração funcionar, você precisa especificar quais arquivos de origem devem ser traduzidos e como o Crowdin deve estruturar os arquivos traduzidos em seu repositório. No caso, você verá um ícone vermelho com um ponto de exclamação ao lado do nome da ramificação do serviço. Isso significa que você não escolheu um conteúdo para sincronização.

There are two ways to do that: configuring online, or manually, creating a configuration file.

Configurando online

Este procedimento é o mesmo para todas as integrações com sistemas de controle de versão (VCS). Verifica Integrações VCS: Configuração Online para saber como selecionar o conteúdo para sincronização online.

Criando arquivo de configuração

Arquivo de configuração crowdin.yaml deve ser armazenado no repositório do GitHub junto com cada ramificação separada que você deseja traduzir, então Crowdin sabe quais arquivos devem ser enviados exatamente para traduções.

Ele deve ter a mesma estrutura necessária para a Ferramenta de sincronização, mas as credenciais do seu projeto não devem ser armazenadas no cabeçalho do arquivo por motivos de segurança. Read more about creating a configuration file.

Synchronization Schedule

Para configurar o agendamento de sincronização - clique em Editar e escolha o intervalo de atualização.

sincronização tempo do github

Verificando o status da sincronização

Depois que a integração é configurada, todas as informações relacionadas, são armazenadas nas Configurações do Projeto, aba Integrações, seção GitHub.
Por padrão, a sincronização é processada, automaticamente, a cada 10 minutos. Se houver necessidade de iniciá-lo instantaneamente, clique em Sincronizar agora.

sincronização tempo agora

Veja também

Este artigo foi útil?