Integrações
Integre a tradução de conteúdo de repositórios e CMS, execute a localização em CI, colete evidências do Crowdin ou investigue feedback do Jira.
Use o Lingo.dev com as ferramentas que sua equipe já usa para escrever, traduzir e revisar conteúdo. Cada conexão tem uma função diferente. Algumas devolvem o conteúdo traduzido ao sistema de origem; outras coletam evidências ou ajudam a investigar feedback.
Traduza conteúdo no próprio sistema de origem #
Essas conexões nativas leem o conteúdo de origem selecionado, fazem a tradução com um engine de localização e gravam o resultado no mesmo sistema, usando as permissões de acesso que você concede no provedor.
| Conexã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 escopo definido | Um pull request de tradução para alterações na branch padrão ou commits na branch de um pull request elegível. |
| Payload | Sincronização manual ou notificações do plugin sobre alterações no conteúdo de origem | Campos localizados nas mesmas coleções e globais, nos idiomas de destino selecionados. |
| WordPress | Sincronização manual ou ao salvar conteúdo publicado, com notificação pelo plugin | A tradução de cada post vinculada no Polylang ou no WPML, nos idiomas selecionados. |
| Central de Ajuda do Zendesk | Sincronização manual | Versões em outros idiomas das categorias, seções e artigos selecionados. |
A configuração do provedor define o escopo de acesso. No GitHub, selecione os repositórios e os padrões de arquivos de origem. No Payload, selecione as coleções e os globais com campos localizados. No WordPress, selecione os tipos de post. No Zendesk, selecione categorias, seções e artigos separadamente: selecionar uma categoria não seleciona os itens dentro dela.
O comportamento de publicação também varia conforme o provedor. No Payload, o modo Publicar não grava em documentos publicados com alterações ainda não publicadas até que elas sejam publicadas ou revertidas, pois publicar a tradução também colocaria essas alterações no ar. No Zendesk, gravar um rascunho pode tirar do ar uma versão de idioma já publicada até que ela seja republicada. Consulte a seção sobre publicação do provedor antes da primeira gravação, especialmente se já houver traduções.
Execute a tradução no seu pipeline #
GitHub Actions, GitLab CI, Bitbucket Pipelines e Buildkite executam a CLI no seu próprio executor. As receitas partem de artefatos para download ou de uma única branch confiável, para que você possa conferir o resultado antes de ampliar as permissões de escrita no repositório. Com .lingo/lock.json incluído em um commit, lingo check reprova uma solicitação de pull ou merge quando um arquivo de origem foi alterado desde a última tradução ou quando falta um arquivo de destino. Não é necessária nenhuma chave de API.
Seu pipeline cuida do agendamento, dos segredos, da retenção dos resultados e da criação de commits ou pull requests. A chave de API do Lingo.dev autoriza a tradução; a credencial do provedor autoriza a gravação no repositório. Automatize traduções em CI explica como manter juntas as revisões do código-fonte, os resultados concluídos e as verificações da aplicação.
Meça traduções ou investigue feedback #
O Crowdin envia ao Radar as atividades compatíveis de cada string. Use essa conexão para examinar traduções produzidas no Crowdin sem transferir o workflow de geração ou revisão. Configure uma medição para a pergunta que você quer responder e confira o texto coletado e o resultado da medição. Essa conexão não sincroniza as traduções corrigidas de volta para o Crowdin.
O Jira parte de um problema relatado. Ao adicionar a etiqueta lingo, você solicita que o workflow de triagem examine o problema e proponha alterações no glossário, nas regras ou na voz da marca. As pessoas aplicam ou descartam cada sugestão e depois decidem se querem traduzir novamente o conteúdo afetado nas conexões. A triagem do Jira não traduz o conteúdo do chamado como um projeto de localização.
Conclua a primeira execução antes de ampliar o escopo #
A página de cada provedor orienta uma execução inicial de escopo reduzido, passando por autorização, configuração, conferência dos resultados e recuperação. Use essa execução para entender o que a conexão lê e altera. A disponibilidade da conexão pode depender das permissões da organização e do acesso a recursos; a credencial do provedor, por si só, não concede acesso a um engine de localização.
Ao desativar uma conexão, interrompa novos acionamentos e cuide das credenciais do provedor separadamente. Desconectar não desfaz o conteúdo entregue, os comentários publicados nem as medições registradas. A seção de recuperação do provedor explica o que permanece e o que acontece ao reconectar.
Para um workflow gerenciado pela aplicação, siga para DevTools e conheça as interfaces de API, CLI e JavaScript.