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 assim, um leitor nativo percebe as que ele errou. Com as sugestões, esse leitor corrige o texto no seu site, você revisa 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 seja internacionalizado, conforme descrito em Internacionalizar um projeto. Tudo aqui fica na bancada de trabalho do projeto em Localização.

Ativar contribuições

As contribuições precisam de duas coisas 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 ambas por padrão.

Para um projeto configurado sem elas, abra Contribuidores e selecione Propor ativar contribuições. O Coroid abre uma tarefa que adiciona ambas, e você mescla seu pull request. Até então, Contribuidores explica o que está faltando.

Convidar contribuidores

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

  • Revisão. Mantenha Revisar sugestões antes de aplicar ativado para novos contribuidores. Com ele desativado, uma sugestão é aprovada imediatamente, mas somente quando o texto de origem corresponder ao seu repositório sincronizado.
  • Sem vaga. Um contribuidor 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.
  • Uma conta do Coroid. A pessoa aceita em até sete dias fazendo login no Coroid com o endereço convidado ou criando uma conta gratuita a partir do convite. Essa conta tem sua própria área de trabalho, não um espaço na sua.

Revogar o acesso impede novas sugestões e preserva o histórico da pessoa.

O seletor no seu site

Os contribuidores sugerem a partir do seu site, onde veem o texto em contexto.

  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 permanecem desativadas até que um proprietário ou administrador as habilite.
  2. Em Contribuidores, selecione Preparar tarefa de integração do site. A tarefa adiciona o pacote de seleção 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 string e o pop-up do Coroid é exibido com a chave, a origem 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. 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

Sugestões lista todas as sugestões com sua chave, idioma, origem, 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.

Localização
Loja virtual
inglês origem · 5 idiomas · verificado há 2 horas em 3f2c9a1
  • Prontidão mundial
  • Cultura
  • 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.

Coroid compara a origem de cada sugestão com o ramo padrão sincronizado. Se a origem mudou após o colaborador visualizá-la, a aprovação é cancelada e a linha indica isso; rejeite-a para que o colaborador possa sugerir novamente.

StatusSignificado
Precisa de revisãoAguardando revisor
AprovadoPronto para a próxima tarefa de correção
Em filaUma tarefa de correção está aplicando-a
AplicadoEscrito em um pull request; entra em vigor assim que for mesclado e implantado
Origem alteradaO texto original foi alterado antes de ser aplicado
InválidoNão passou nas verificações do mecanismo, como um placeholder incorreto
RejeitadoUm revisor o 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 mecanismo definido, verifica cada origem 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. Em Sugestões, selecione Preparar tarefa de correção, ou Commit em Strings. Uma tarefa processa até 500 sugestões aprovadas no projeto, juntamente com as alterações feitas na bancada de trabalho.
  • Todas as noites. O assistente instala as correções noturnas por padrão; caso contrário, escolha Instalar correções noturnas em Automações. O agendamento é executado às 02:00 UTC, não faz chamada ao modelo e cria uma tarefa somente quando algo for aprovado. Pause ou retome-o pelo agendamento 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 tal pull request é mesclado no seu branch padrão, o Coroid lê a verificação de Globalização que já foi feita no pull request. Se houver strings ausentes ou desatualizadas, ele cria uma tarefa de tradução para essa mesclagem. A tarefa traduz apenas as strings que o pull request adicionou ou alterou (com coroid-i18n 1.19.0 ou versão posterior), de modo que mesclagens traduzidas ao mesmo tempo nunca afetem as strings umas das outras, e abre um pull request com elas. Se a verificação bloquear texto ou frases no código, também cria uma tarefa para internacionalizar esse código. Se não houver nada a ser feito, nada acontece. As strings deixadas por uma tarefa aguardam Traduzir a lista de pendências noturnamente, instalado no mesmo local: toda noite ele lê seu branch padrão e cria uma tarefa para tudo o que ainda estiver pendente, e nada acontece quando não há nada.

Isso requer o Globalização verificação nos pull requests e o Revisar cada PR automação, para 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 carregam o agendamento noturno e a automação de strings mescladas. Elas chegam pausadas no projeto de destino, as origens de site chegam desativadas e os colaboradores não são copiados: convide-os novamente na nova organização.