Integração GitLab
Crowdin’s integration with GitLab makes source and translation files synchronized with GitLab repository and Crowdin translation project. All translated and approved files will be automatically pushed as a merge request to the l10n branch in GitLab repository.
Connecting GitLab with Crowdin
First, open Project Settings, Integrations tab in Crowdin. Go to the GitLab section. Then you have two options. Você pode usar sua conta do GitLab ou a conta do GitLab Enterprise para 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:
To integrate via GitLab Enterprise Account you should create an access token. Make sure to select the required scopes: - Access your API - Read user information
Em seguida, insira o token de acesso e o URL básico nos campos correspondentes. CliqueConfigurar Integração para prosseguir.
After the successful integration, a pop-up dialogue would appear in your Project Settings, Integrations tab in Crowdin. Use it to continue the process of integration setup selecting necessary repository and branches that should be translated.
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
When translations are finished and your languages are ready to go live, Crowdin sends merge request with translations to your version control system. 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.
By default, l10n_ is added to the created service branch name. In case of necessity, it can be easily changed.
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 GitLab 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 GitLab. 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:
- Clique Editar na seção de integração do GitLab.
- No diálogo pop-up, clique em Mostrar configurações avançadas no canto inferior esquerdo.
- No campo Ramos para sincronizar automaticamente, usar seletores de caractere curinga, como ‘*’, ‘?’, ‘[set]’, ‘' e outros para identificar os ramos necessários.
- 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 colocado no repositório do GitLab juntamente com cada ramo separado que 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.
Verificando o status da sincronização
Tendo concluído o processo de configuração de integração, na abaConfigurações do projeto, Integrações, todas as informações sobre integração serão armazenadas lá. Por padrão, a sincronização é processada a cada 10 minutos automaticamente. No caso, há uma necessidade para lançá-lo instantaneamente, clique em Sincronizar agora.
