Integração do GitHub

A integração com o GitHub torna os arquivos de origem e 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

First, open Project Settings, Integrations tab in Crowdin. Then you have two options. Você pode usar sua conta do GitHub ou a integração da conta do GitHub Enterprise.

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 aos seus repositórios públicos ou controle total de repositórios privados (dependendo do tipo de repositório que você deseja traduzir)
  • Controle total dos ganchos do repositório (para que você possa obter alguns novos arquivos ou alterações nos antigos também traduzidos)
  • Atualizar todos os dados do usuário

Em seguida, insira seu token de acesso e URL base nos campos correspondentes. Clique em Configurar Integração para continuar.

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 mudar a manipulação de textos duplicados para a configuração Mostrar (Recomendado para versões), para que as textos iguais fiquem 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 recurso *padrão nas configurações de integração do GitHub. Nesse caso, as futuras ramificações que contenham essa palavra no final do título serão adicionados 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 em 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.

Há duas maneiras de fazer isso: configurando online ou manualmente, criando um arquivo de configuração.

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

Configuration file crowdin.yaml should be stored in the GitHub repository along with each separate branch that you want to translate, so Crowdin knows what files exactly should be sent for translations.

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 na guia Configurações do projeto, Integrações, seção GitHub. Por padrão, a sincronização é processada a cada 10 minutos automaticamente. Se houver necessidade de iniciá-lo instantaneamente, clique em Sincronizar agora.

sincronização tempo agora

Veja também

Este artigo foi útil?