Documentação

Mantenha as traduções com sugestões

Deixe falantes nativos corrigirem o texto do seu site, analise suas sugestões e aplique-as por meio de pull requests normais.

Um modelo acerta a maioria das frases. Mesmo assim, um leitor nativo ainda identifica as que ele errou. Com as sugestões, esse leitor corrige o texto do seu site, você analisa no Coroid e a alteração chega ao seu repositório como um pull request comum.

É assim que o Coroid mantém seu próprio produto em treze idiomas. As etapas abaixo pressupõem que o projeto esteja configurado conforme descrito em Traduza seu projeto.

Ative contribuições

Para contribuir, são necessárias duas coisas em .coroid/i18n.json: a vinculação de sugestões do projeto e uma versão do motor que as suporte. Na Colaboradores guia, selecione Propor ativar contribuições. O Coroid cria uma tarefa que adiciona ambas as funcionalidades e você mescla seu pull request. Até lá, o guia indicará o que está faltando.

Convide colaboradores

Selecione Convidar colaborador, insira um endereço de e-mail e os idiomas que eles podem traduzir.

  • Analise. Mantenha Analisar sugestões antes de aplicá-las ativado para novos colaboradores. Com essa opção desativada, uma sugestão é aprovada imediatamente, mas somente quando o texto-fonte corresponder ao do seu repositório sincronizado.
  • Sem vaga. O colaborador não é adicionado à sua organização e não ocupa uma vaga de membro. O acesso se limita apenas a este projeto e aos idiomas escolhidos.
  • Os convites expiram. A pessoa deve fazer login ou criar uma conta com o endereço convidado e aceitar o convite em até sete dias.

Revogar o acesso impede novas sugestões e mantém o histórico da pessoa.

O seletor no seu site

Os colaboradores sugerem alterações diretamente no seu site, onde veem o texto em contexto.

  1. Em Configuração → Origens do site, adicione cada endereço do site, uma origem HTTPS por linha, e ative-o. Novas origens ficam desativadas até que um proprietário ou administrador as habilite.
  2. Na Colaboradores guia, selecione Preparar tarefa de integração do site. Essa tarefa adiciona o pacote do seletor do Coroid ao seu site. Ele é carregado apenas quando o endereço da página contém ?coroid-translate=1, portanto visitantes comuns não baixam nada.
  3. Um colaborador abre seu site com esse parâmetro, clica em uma frase e o pop-up do Coroid aparece com a chave, o texto-fonte e a tradução atual.
ACMENeuheitenAngeboteMarken
Weiter zur Kasse gehen

Kostenloser Versand ab 50 € und 30 Tage Rückgabe.

Bestellung prüfen
Modo de traduçãoClique em qualquer textoSair
Sugira uma tradução
Chave
ui · cart.checkout
Origem em inglês
Proceed to checkout
Tradução atual
Weiter zur Kasse gehen
Sua tradução
Zur Kasse

Mantenha as partes entre chaves e colchetes exatamente como estão.

Enviar sugestão

Um site de cliente em modo de tradução: o colaborador clica em um título e sugere uma redação em alemão melhor no pop-up do Coroid. Dados ilustrativos.

O pop-up verifica os placeholders antes de enviar as sugestões. Os colaboradores fazem login no Coroid dentro do pop-up; seu site nunca processa suas credenciais. Sugestões anônimas não são aceitas.

Revisão

A Sugestões guia lista todas as sugestões com sua chave, idioma, texto-fonte, tradução atual e a proposta. Filtre por status ou idioma e aprove ou rejeite cada uma. Também é possível rejeitar várias de uma vez.

Loja virtual
Configurado · origem en · 4 localidades de destino
Visão geralConfiguraçãoConfiguraçãoColaboradoresSugestõesAutomações
Precisa de revisãoAprovadoAplicada
Preparar tarefa de correção
  • cart.checkoutdeLena · Alemão
    en
    Proceed to checkout
    de
    Weiter zur Kasse gehen
    de
    Zur Kasse
    AprovarRejeitar
  • product.inStockfrHugo · Francês
    en
    In stock
    fr
    En stock
    fr
    Disponible
    AprovarRejeitar
  • nav.dealsdeLena · Alemão

    A origem enviada difere do repositório sincronizado.

    en
    Weekly deals
    de
    Angebote
    de
    Angebote der Woche
    AprovarRejeitar

A aba Sugestões: correções aguardando revisão, verificadas em relação à origem sincronizada. Dados ilustrativos.

O Coroid compara o texto-fonte de cada sugestão com o da branch padrão sincronizada. Se o texto-fonte mudou depois que o colaborador o viu, a aprovação é bloqueada e a linha indica isso; rejeite-a para que o colaborador possa sugerir novamente.

StatusSignificado
Precisa de revisãoAguardando revisor
AprovadaPronta para a próxima tarefa de correção
EnfileiradaUma tarefa de correção está aplicando a alteração
AplicadaEscrita em um pull request; entra em vigor após mesclar e implantar
Texto-fonte alteradoO texto-fonte mudou antes de ser aplicado
InválidaA sugestão não passou nas verificações do motor, por exemplo por ter um placeholder quebrado
RejeitadaUm revisor a recusou

Aplicar sugestões aprovadas

Existem duas maneiras de transformar sugestões aprovadas em um pull request. Ambas usam a mesma tarefa de correção: ela executa o comando apply-claim do motor selecionado, verifica cada texto-fonte novamente, grava apenas os catálogos de destino e informa o que foi aplicado, o que ficou desatualizado e o que era inválido.

  • Agora. Na Sugestões guia, selecione Preparar tarefa de correção. Uma única tarefa processa até 500 sugestões aprovadas no projeto.
  • Todas as noites. Na Automações guia, selecione Instalar correções noturnas. O agendamento ocorre às 02:00 UTC, não faz chamadas ao modelo e cria uma tarefa somente quando há sugestões aprovadas. Pause ou retome o agendamento na Factory.

Frases mescladas fora do Coroid

As pessoas também alteram frases em pull requests que o Coroid não gerou. Instale Traduzir strings mescladas fora do Coroid na Automações aba. Quando um pull request é mesclado no seu branch padrão, o Coroid lê a verificação de tradução que já executou no pull request. Se houver strings ausentes ou desatualizadas, ele cria uma tarefa de tradução para esse merge. Caso não haja nada a ser traduzido, nada acontece.

Isso requer o Traduções controle em pull requests e o Revisar cada PR da automação, para que a verificação seja executada antes do merge.

Auditorias e avisos

O Auditoria de tradução controle verifica todo o catálogo em um cronograma. Para receber notificações quando ocorrer uma falha, instale Avisos de auditoria com falha na Automações aba. Ele envia uma mensagem pelas ferramentas de mensageria configuradas na sua organização, como Slack ou e-mail. Falhas provenientes de QA de tarefas e pull requests não geram notificações; elas já aparecem no local onde o trabalho está sendo feito.

Mover configurações para outra organização

A exportação e importação de configurações mantêm o cronograma noturno e as automações de hook. Elas chegam pausadas no projeto de destino, as origens do site chegam desativadas e os colaboradores não são copiados: convide-os novamente na nova organização.