Recolher traduções para medição

Escolha uma origem compatível e preserve o texto, as revisões e o contexto necessários à medição.

A medição pode começar pelas traduções que a sua equipa já produz. Continue a gerir o texto aceite no repositório ou no sistema de gestão de traduções e escolha como disponibilizá-lo para verificação.

Para ser útil, cada versão tem de ser identificável. Se uma mensagem mudar após a avaliação, a resposta anterior continua a referir-se à redação anterior. Guardar as revisões de origem e de destino em conjunto permite à equipa voltar aos elementos que sustentam a avaliação, em vez de os reconstruir a partir do conteúdo mais recente.

Escolha a origem para o seu workflow #

Ponto de partidaComo medir
Atividade do CrowdinLigue o Crowdin, configure uma medição de eventos e examine o evento e a resposta resultantes no Radar. É necessário ter acesso ao Radar para consultar os respetivos ecrãs.
Commits do GitHubLigue a GitHub App e configure os caminhos de origem e de destino. As alterações a chaves de localização compatíveis no ramo predefinido dão origem a eventos.
Centro de Ajuda do ZendeskLigue o Zendesk. As alterações a artigos publicados dão origem a eventos de origem ou de tradução nos respetivos idiomas.
Ficheiros de tradução locaisUtilize lingo score com um avaliador e um modelo configurados. Os resultados são guardados localmente, fora do histórico de eventos do Radar.
Traduções do Lingo.devCada localização concluída já constitui um evento. Rever traduções do Lingo.dev explica como selecionar motores, idiomas e uma amostra.

Para utilizar outra origem, contacte o Lingo.dev para preparar a recolha de eventos antes de automatizar a entrega.

Recolha atividade do GitHub e do Zendesk #

No GitHub, instale a GitHub App para o repositório pretendido e ligue-a à organização no Lingo.dev. Faça um commit de .lingo/config.json com o idioma de origem, os idiomas de destino e os padrões dos ficheiros de origem. Estes caminhos permitem distinguir as alterações ao texto de origem das alterações às traduções. Examine um evento depois de um commit no ramo predefinido alterar uma chave de localização configurada; um único commit pode gerar eventos para várias chaves e idiomas.

A recolha de atividade do GitHub lê ficheiros JSON, JSONC, YAML, YAML com uma chave na raiz, recursos Android, .strings da Apple, ARB do Flutter, PHP e TypeScript. Alterações no repositório explica como as alterações dão origem a eventos.

No Zendesk, autorize a ligação ao Centro de Ajuda e ative os respetivos idiomas. O Radar regista a atividade dos artigos publicados por idioma. Abra o evento e compare a identidade do artigo, o idioma e o texto com os dados no Zendesk. A recolha de atividade não desencadeia, por si só, uma Sync de tradução nem publica um novo artigo de destino.

Ambas as ligações mantêm as traduções aceites no sistema original. A medição analisa os eventos registados, sem assumir a função de publicação.

Importe o histórico do fornecedor antes de o medir #

Escolha o histórico do fornecedor de que precisa:

  • GitHub: importa até aos 5000 commits mais recentes do ramo predefinido do repositório. Cada commit é lido com o .lingo/config.json guardado nessa revisão. Os commits anteriores à existência dessa configuração não geram eventos.
  • Zendesk: importa as versões atualmente publicadas dos artigos, secções e categorias existentes em cada idioma, com a data da última atualização. As revisões anteriores e as versões em rascunho não são abrangidas por esta recolha.

As novas ligações ao GitHub e ao Zendesk iniciam automaticamente a importação do histórico. Acompanhe o progresso no separador Definições da ligação. Para iniciar ou repetir uma importação mais tarde:

  1. No Studio, selecione o repositório ou o Centro de Ajuda em Ligados e abra o respetivo separador Definições.
  2. Em Histórico de commits, no caso do GitHub, ou Histórico do Centro de Ajuda, no caso do Zendesk, selecione Importar histórico.
  3. Acompanhe o progresso da importação, que contabiliza os itens do fornecedor em fila de espera para recolha.
  4. Aguarde até os eventos que pretende medir estarem visíveis em Radar → Registos e examine as respetivas datas, idiomas e texto.

Nas medições executadas sobre eventos do fornecedor, o separador Preenchimento retroativo também disponibiliza a opção Importar eventos, com os repositórios do GitHub e os Centros de Ajuda do Zendesk ligados. O histórico importado é recolhido sem executar medições. Assim que os eventos pretendidos estiverem visíveis, ative a medição e inicie uma avaliação histórica para o intervalo correspondente.

Se surgirem mais eventos importados após o preenchimento retroativo, execute-o novamente com a opção Apenas eventos ainda não medidos ativada. Se a importação falhar, consulte o progresso e tente novamente no mesmo separador Definições. Verifique o preenchimento retroativo e os resultados da medição separadamente da importação.

Preserve a comparação #

Guarde em conjunto o ID do sistema de origem, o ID do conteúdo, o idioma de destino e a revisão de destino. Para verificar o significado, acrescente a revisão de origem correspondente. Para medir a edição, conserve o rascunho a partir do qual foi produzido o texto de destino editado.

Por exemplo, no seu registo de acompanhamento, a combinação de delivery.promise, do idioma fr e da revisão 42 identifica uma entrada específica do catálogo. A revisão 43 pode alterar a promessa.

Registe a proveniência da tradução quando o workflow fornecer essa informação: uma pessoa, um modelo, um fornecedor de tradução automática ou a reutilização de uma memória de tradução. Se a origem for desconhecida, registe-a como tal. Um utilizador do fornecedor que tenha aprovado uma tradução não é necessariamente a pessoa ou o modelo que a escreveu.

Reúna os elementos necessários para a questão escolhida #

O critério determina o que é necessário recolher. Uma verificação ortográfica pode analisar apenas o texto de destino. Uma verificação de significado precisa dos textos de origem e de destino emparelhados, com contexto para esclarecer ambiguidades. Uma verificação terminológica precisa do termo aplicável e dos limites da sua utilização. Uma verificação de marcadores de posição precisa das regras que estes devem cumprir, enquanto o cálculo da distância de edição precisa do par efetivo de rascunho e texto de destino.

Se faltar a revisão de origem de uma tradução, mantenha-a entre os casos não avaliados na verificação de significado e obtenha o texto de origem antes de a avaliar.

Verifique um evento recolhido #

  1. Configure a medição selecionada antes de gerar atividade de teste na origem ligada.
  2. Localize o evento correspondente. Compare o idioma, o texto, a proveniência e o rascunho disponível com o seu registo.
  3. Abra a resposta da medição e leia o critério ao lado do texto. Verifique se a medição devolveu uma resposta, devolveu N/A ou não foi concluída.
  4. Guarde os identificadores do evento e da medição juntamente com as revisões avaliadas. Aplique qualquer correção aceite no sistema que gere o texto.

No caso da avaliação local, examine o resultado guardado juntamente com os ficheiros de entrada e a configuração do avaliador; este método não cria um evento no Radar.

Num workflow recorrente, conserve o que foi selecionado, recolhido e medido. Medir traduções a partir do seu pipeline aborda a recolha e a recuperação, incluindo novas tentativas e revisões alteradas.