Integração GitHub

A integração do Crowdin com o GitHub, torna os ficheiros de origem e tradução, sincronizados com o repositório do GitHub e projeto de tradução do Crowdin. Todos os ficheiros traduzidos e aprovados, serão automaticamente, enviados como um pull request para o ramo l10n no repositório do GitHub.

Conectar o GitHub com o Crowdin

Primeiro, abre as Definições do Projeto, navegador Integrações no Crowdin. Depois, terás duas opções. You can either use your GitHub Account or GitHub Enterprise Account integration.

Para integrar através da tua Conta GitHub, podes clicar Configurar Integração e, em seguida, autorizar a conexão com o Crowdin no lado do GitHub:

Caso o repositório que precisas é privado, e tens acesso limitado ou nenhum, pergunta ao proprietário do repositório para fornecer-te o Token de Acesso. Depois, insere o toke no campo Token e clica Configurar Integração.

Para integrar através da Conta GitHub Enterprise, deves criar um token de acesso. Make sure to select all the required scopes:

  • Access to your public repositories or full control of private repositories(depending on the type of repository you wish to translate)
  • Full control of repository hooks(so you could get some new files or changes in the old ones translated as well)
  • Update all user data

Then insert your access token and Base URL into corresponding fields. Click Set Up Integration to proceed.

After successful integration, a pop-up dialogue would appear on your Project Settings, Integrations tab in Crowdin. No pop-up recém-exibido, continua o processo de configuração da integração, ao selecionar o repositório necessário e os ramos que devem ser traduzidos.

Recomenda-se alternar o processamento de frases duplicadas, para a definição Mostrar (Recomendado para versões), para que as frases iguais sejam ocultadas nos ramos.

Ramos de Serviço

Quando as traduções terminarem e os teus idiomas estiverem prontos, o Crowdin envia um pull request com as traduções para o teu sistema de controlo de versão. Para cada ramo que está em localização, o Crowdin cria ramos de serviço adicionais com traduções. Não comprometemo-nos diretamente, para o ramo principal para que possa verificar as traduções, primeiro.

By default, l10n_ is added to the created service branch name. If necessary it can be easily changed.

Branches to Sync Automatically

When you set up the integration you select existing repository branches that should be added to the Crowdin project. To add future branches from GitHub to Crowdin automatically, create a pattern for the branch names. If a branch name follows a certain pattern, it will be automatically added to Crowdin.

For example, you add a pattern *feature in the GitHub integration settings. In this case, the future branches that contain this word at the end of the title will be added to the project.

To add a pattern for branch names, follow these steps:

  1. Click Edit in the GitHub integration section.
  2. In the pop-up dialogue click Show Advanced Settings in the bottom left corner.
  3. In the Branches to Sync Automatically field, use wildcard selectors such as ‘*’, ‘?’, ‘[set]’, ‘' and others to identify the necessary branches.
  4. Clica em Guardar.

Selecionar Conteúdo para Sincronização

Para obter a integração a funcionar, deves especificar quais ficheiros de origem devem ser traduzidos e como o Crowdin deve estruturar ficheiros traduzidos no teu repositório. Caso, vires um ícone vermelho com uma marca de exclamação ao lado do nome do ramo de serviço, isto significa, que não escolheste o conteúdo para a sincronização.

Existem duas maneiras de fazer isso: configurar online, ou manualmente, ao criar um ficheiro de configuração.

Configuração Online

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

Criar Ficheiro de Configuração

O ficheiro de configuração crowdin.yaml deve ser armazenado no repositório do GitHub, com o ramo separado que queres traduzir, para que o Crowdin saiba, exatamente, quais ficheiros devem ser, enviados para as traduções.

Ele deve ter a mesma estrutura necessária para a Ferramenta de Sincronização, mas as credenciais do teu projeto, não devem ser armazenadas no cabeçalho do ficheiro por razões de segurança. Lê mais sobre criar um ficheiro de configuração.

Agenda de Sincronização

Para configurar o agendamento de sincronização – clica Editar e escolhe o intervalo de atualização.

tempo de sincronização do github

Verificar o Estado de Sincronização

Once the integration is set up, all the related information is stored in the same place – Project Settings, Integrations tab, GitHub section. Por padrão, a sincronização é processada, automaticamente, a cada 10 minutos. Se houver necessidade de iniciá-lo, instantaneamente – clica Sincronizar Agora.

sincronização do github agora

Ver Também

Este artigo foi útil?