Integração GitLab

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

Conectar o GitLab com o Crowdin

Primeiro, abre as Definições do Projeto, navegador Integrações no Crowdin. Vai à secção do GitLab. Depois, terás duas opções. Podes usar a tua Conta do GitLab ou GitLab Enterprise para a integração.

To integrate via your GitLab Account you can click Set Up Integration and then authorize the connection with Crowdin on the GitLab side:

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

  • Access your API
  • Read user information

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

After the successful integration, a pop-up dialogue would appear in your Project Settings, Integrations tab in Crowdin. Usa-o para continuar o processo de configuração da integração, ao selecionar o repositório necessário e os ramos que devem ser traduzidas.

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 merge 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. In case of necessity, 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 GitLab 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 GitLab 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 GitLab 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 tem que ser colocado no repositório do GitLab, 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.

Verificar o Estado de Sincronização

Having completed the process of integration setup, in the Project Settings, Integrations tab, all the information about integration will be stored there. Por padrão, a sincronização é processada, automaticamente, a cada 10 minutos. No caso, há uma necessidade para iniciá-lo, instantaneamente – clica Sincronizar Agora.

Ver Também

Este artigo foi útil?