Documentação

Mantenha traduções com sugestões

Permita que falantes nativos corrijam o texto do seu site, analise suas sugestões e aplique-as por meio de pull requests comuns.

Um modelo acerta a maioria das frases. Mesmo um leitor nativo percebe as que ele errou. Com as sugestões, esse leitor corrige o texto no seu site, você revisa tudo na 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. Os passos abaixo pressupõem que o projeto já foi internacionalizado, conforme descrito em Internacionalizar um projeto. Tudo aqui fica no ambiente de trabalho do projeto em Localização.

Ativar contribuições

Para que as contribuições funcionem, são necessários dois elementos em .coroid/i18n.json: a vinculação de sugestões do projeto e uma versão do mecanismo que as suporte. O assistente de internacionalização adiciona ambos por padrão.

Para um projeto sem esses elementos configurados, abra Colaboradores e selecione Propor ativar contribuições. O Coroid cria uma tarefa que adiciona os dois elementos e você mescla seu pull request. Até lá, Colaboradores indica o que está faltando.

Convidar colaboradores

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

  • Revisar. Mantenha Revisar 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 original 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, mas 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 no contexto real.

  1. Em Configurações → Acesso e gastos → 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. Em Colaboradores, selecione Preparar tarefa de integração do site. Essa tarefa adiciona o pacote do seletor do Coroid ao seu site. Ele só é carregado quando o endereço da página contém ?coroid-translate=1, portanto visitantes comuns não baixam nada.
  3. Um colaborador acessa seu site com esse parâmetro, clica em uma frase e a janela pop-up do Coroid abre com a chave, o texto original 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.

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

Revisão

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

Localização
Loja virtual
inglês origem · 5 idiomas · verificado há 2 horas em 3f2c9a1
  • Visão geral
  • Strings
  • Sugestões
  • Trocar
  • Colaboradores
  • Automações
  • Configurações
Sugestões
Preparar tarefa de correção
Precisa de revisãoAprovadoAplicada
  • 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

Sugestões na área de trabalho: correções aguardando decisão, verificadas em relação à fonte sincronizada. Dados ilustrativos.

O Coroid compara o texto original de cada sugestão com o da branch padrão sincronizada. Se o texto original mudou depois que o colaborador o viu, a aprovação é bloqueada e a linha indica isso; rejeite a sugestão para que o colaborador possa tentar 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 original alteradoO texto original mudou antes de ser aplicado
InválidaA sugestão falhou nas verificações do mecanismo, por exemplo por causa de um placeholder incorreto.
RejeitadaUm revisor a recusou

Aplicar sugestões aprovadas

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

  • Agora. Em Sugestões, selecione Preparar tarefa de correção, ou Confirmar em Frases. Uma única tarefa processa até 500 sugestões aprovadas no projeto, juntamente com as alterações feitas no ambiente de trabalho.
  • Todas as noites. O assistente instala correções noturnas por padrão; caso contrário, selecione Instalar correções noturnas em Automações. A programação é executada às 02:00 Ele opera em UTC, não realiza chamadas de modelo e só cria uma tarefa quando algo é aprovado. Pause ou retome-o a partir da agenda na Factory.

Strings mescladas fora do Coroid

As pessoas também alteram strings em pull requests que o Coroid não criou. O assistente instala Traduzir strings mescladas fora do Coroid por padrão; caso contrário, instale-o em Automações. Quando um pull request desse tipo é mesclado ao 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 essa mesclagem. Se não houver nada para traduzir, nada acontece.

Isso requer o Traduções verificação em pull requests e a Revisar todas as PR automação, de modo que a verificação seja executada antes da mesclagem.

Mover configurações para outra organização

A exportação e importação de configurações incluem a agenda noturna e a automação de strings mescladas. 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.