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ção | O que inicia o trabalho | Para onde vão as traduções |
|---|---|---|
| GitHub | Eventos configurados no repositório ou um comando de tradução com âmbito definido | Um 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. |
| Payload | Sincronização manual ou notificações de alterações na origem enviadas pelo plugin | Campos localizados nas mesmas coleções e globais, nos idiomas de destino selecionados. |
| WordPress | Sincronização manual ou gravações de conteúdo publicado comunicadas pelo plugin | A tradução associada a cada publicação no Polylang ou no WPML, nos idiomas selecionados. |
| Centro de Ajuda do Zendesk | Sincronização manual | Versõ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.