Integrações

Integre a tradução em repositórios e CMS, execute a localização em CI, recolha evidências do Crowdin ou investigue comentários do Jira.

Use o Lingo.dev com as ferramentas onde a sua equipa escreve, traduz e revê conteúdos. Cada ligação tem uma função distinta. Algumas devolvem os conteúdos traduzidos ao sistema de origem; outras recolhem evidências ou ajudam a investigar comentários.

Traduza conteúdos no sistema onde já estão #

Estas ligações nativas leem os conteúdos de origem selecionados, traduzem-nos com um motor de localização e gravam o resultado no sistema de origem, com as permissões de acesso que conceder no fornecedor.

LigaçãoO que inicia o trabalhoPara onde vão as traduções
GitHubEventos configurados no repositório ou um comando de tradução com âmbito definidoUm pedido de integração com as traduções das alterações no ramo predefinido, ou commits no ramo de um pedido de integração elegível.
PayloadSincronização manual ou notificações de alterações na origem enviadas pelo pluginCampos localizados nas mesmas coleções e globais, nos idiomas de destino selecionados.
WordPressSincronização manual ou gravações de conteúdo publicado comunicadas pelo pluginA tradução associada a cada publicação no Polylang ou no WPML, nos idiomas selecionados.
Centro de Ajuda do ZendeskSincronização manualVersões por idioma das categorias, secções e artigos selecionados.

A configuração do fornecedor define o âmbito de acesso. No GitHub, selecione os repositórios e os padrões de ficheiros de origem. No Payload, selecione as coleções e os elementos globais com campos localizados. No WordPress, selecione os tipos de publicação. No Zendesk, selecione as categorias, secções e artigos separadamente: selecionar uma categoria não seleciona os respetivos elementos subordinados.

O comportamento da publicação também depende do fornecedor. O modo Publicar do Payload não grava num documento publicado com alterações por publicar até que estas sejam publicadas ou revertidas, uma vez que a publicação da tradução também as tornaria públicas. No Zendesk, gravar um rascunho pode remover uma versão já publicada num determinado idioma até que seja publicada novamente. Leia a secção sobre publicação do fornecedor antes da primeira gravação, sobretudo se já existirem traduções.

Execute a tradução no seu pipeline #

O GitHub Actions, o GitLab CI, o Bitbucket Pipelines e o Buildkite executam a CLI no seu próprio executor. As configurações de exemplo começam com artefactos disponíveis para transferência ou com um único ramo de confiança, para que possa verificar o resultado antes de alargar as permissões de escrita no repositório. Com .lingo/lock.json incluído num commit, lingo check faz falhar um pedido de integração ou de fusão se o conteúdo de origem tiver sido alterado desde a última tradução ou se faltar um ficheiro de destino. Não é necessária uma chave de API.

O seu pipeline gere o agendamento, os segredos, a retenção dos resultados e a criação de commits ou pedidos de integração. A chave de API do Lingo.dev autoriza a tradução; a credencial do fornecedor autoriza a escrita no repositório. Automatizar traduções em CI explica como manter associadas as revisões da origem, os resultados concluídos e as verificações da aplicação.

Faça medições de traduções ou investigue comentários #

O Crowdin envia para o Radar a atividade suportada ao nível de cada cadeia de texto. Use esta ligação para examinar traduções produzidas no Crowdin sem transferir o respetivo workflow de geração ou revisão. Configure uma medição para a pergunta a que pretende responder e, em seguida, examine o texto recolhido e o respetivo resultado. Esta ligação não sincroniza as traduções corrigidas de volta para o Crowdin.

O Jira parte de um problema comunicado. Ao adicionar a etiqueta lingo, pede ao workflow de triagem que examine a ocorrência e proponha alterações ao glossário, às regras ou à voz da marca. São as pessoas que aplicam ou rejeitam cada sugestão e depois decidem se querem voltar a traduzir os conteúdos afetados nas ligações existentes. A triagem do Jira não traduz o conteúdo da ocorrência como um projeto de localização.

Conclua a primeira execução antes de alargar o âmbito #

A página de cada fornecedor orienta uma primeira execução de âmbito reduzido, passando pela autorização, configuração, verificação dos resultados e recuperação. Use essa execução para perceber o que a ligação lê e altera. A disponibilidade da ligação pode depender das permissões da organização e do acesso às funcionalidades; uma credencial do fornecedor, por si só, não concede acesso a um motor de localização.

Ao desativar uma ligação, impeça novos acionamentos e trate das credenciais do fornecedor separadamente. Desligar a ligação não anula os conteúdos entregues, os comentários publicados ou as medições registadas. A secção de recuperação do fornecedor explica que estado é mantido e o que acontecerá quando voltar a ligar.

Para um workflow gerido pela aplicação, consulte DevTools para saber mais sobre as interfaces de API, CLI e JavaScript.