Estação de trabalho de Localização

Coroid traduz seu produto com o mesmo mecanismo que utiliza para seus próprios treze idiomas. Seus catálogos permanecem como arquivos no seu repositório. Qualquer alteração neles chega como uma tarefa e um pull request, e apenas as strings novas, alteradas ou com erros são enviadas ao modelo.

A Localização é a segunda parte da Globalização no menu principal. Ao abrir um projeto ali, é exibida sua área de trabalho: as seções à esquerda e a seção aberta ao lado delas. Projetos que ainda não são multilíngues começam com o Assistente de Internacionalização.

A área de trabalho#

Sugestões, Colaboradores e Automações são abordados em Mantenha traduções com sugestões. Acima dessas seções, sob Internacionalização, a barra lateral contém Prontidão global e Cultura.

A área de trabalho lê os catálogos do seu branch padrão. Quando eles mudam, Coroid os lê novamente na próxima vez que alguém abrir o projeto; até então, a Visão geral indica que está lendo-os. O Coroid nunca executa o código do seu repositório para fazer isso. Catálogos que usam um adaptador personalizado não são exibidos; suas strings ainda são verificadas nas tarefas.

Visão geral: uma linha por idioma#

A Visão geral começa com quatro totais: strings, idiomas, quanto já foi traduzido e quantas strings precisam de trabalho. Abaixo deles, cada idioma percorre uma linha com três etapas:

1. Internacionalizar. O catálogo do idioma existe e contém strings.
2. Localizar. Cada string é traduzida a partir do texto-fonte atual.
3. Verificar. Nenhuma string está com erro: todas são analisadas, mantêm os placeholders do fonte e possuem as formas plurais necessárias para o idioma.

A próxima etapa de um idioma é onde sua linha para. Uma parada verde indica conclusão, um anel turquesa é a parada que precisa de trabalho e uma âmbar indica strings com erros.

A barra abaixo de Localizar lê desde o início: verde-escuro para strings revisadas por pessoas, verde-claro para strings escritas por um modelo, âmbar para strings que precisam de atenção e a parte vazia para strings que estão faltando. O texto abaixo da barra nomeia a lacuna, como 42 strings faltando, e abre exatamente essas strings.

Idiomas derivados de outro idioma por regras, como o inglês britânico do inglês americano, exibem Derivado e atualizado quando suas regras foram aplicadas a todas as strings.

Traduza o que falta#

Proprietários e administradores veem uma ação no topo da Visão geral, Traduzir com o número de strings que precisam de trabalho: faltando, alteradas no fonte ou com erros. Elas são traduzidas na área de trabalho, em duas etapas:

1. Memória de tradução. Uma string que outro projeto da sua organização já traduziu, com exatamente o mesmo texto-fonte, reutiliza essa tradução. As traduções feitas por pessoas têm prioridade sobre as feitas por máquina. Isso não gera chamada ao modelo e não custa nada.
2. O modelo Tradutor. O mecanismo vinculado ao seu repositório traduz o restante através do gateway de tradução, verificando cada resposta em relação aos placeholders e formas plurais.

Enquanto ele roda, um painel abaixo dos totais mostra quantas strings foram escritas e quanto o processo gastou, e a barra de cada idioma se preenche com tinta listrada à medida que suas strings chegam. Parar de traduzir encerra o processo; o que foi escrito permanece.

As traduções não vão direto para o seu repositório. Elas aguardam Commit juntamente com suas outras alterações, marcadas como traduções automáticas, para que você possa verificá-las em Strings primeiro. Uma string que alguém já editou, ou que um colaborador sugeriu, é deixada com eles.

Strings#

Strings lista cada string com seu texto-fonte e seu valor em um idioma. É aberto em Precisa de trabalho: as strings que estão ausentes, cuja fonte foi alterada, que estão corrompidas ou que permanecem iguais à versão original. Escolha outro idioma, um catálogo ou procure por chaves e texto.

Selecione uma string para vê-la em todos os idiomas. Placeholders e marcações aparecem como chips bloqueados, pois devem permanecer exatamente como estão na tradução. Para o idioma escolhido, os detalhes também indicam quem escreveu o valor, o que há de errado com ele e, para mensagens plurais, quais formas plurais o idioma requer.

Editar e confirmar#

Proprietários e administradores corrigem traduções em Strings. Selecione uma string, escolha Editar em um idioma e salve a alteração. O editor exibe os placeholders da versão original como chips que podem ser inseridos e verifica a alteração conforme você digita: os placeholders, as formas plurais exigidas pelo idioma, termos do seu glossário e o comprimento. Coroid faz nova validação contra o branch padrão ao salvar.

Sugerir no editor propõe uma tradução para aquela string específica: a partir da memória de tradução caso outro projeto já a tenha, ou do modelo de Tradutor caso contrário. Escolha Usar esta para inseri-la no editor; nada é salvo até que você confirme a alteração.

As alterações salvas ficam aguardando em uma barra abaixo das strings, onde é possível revisar ou descartar cada uma delas. Confirmar transforma todas elas, juntamente com as sugestões aprovadas de colaboradores e traduções automáticas, em uma única tarefa. A tarefa aplica exatamente esses valores com o mecanismo definido e abre uma pull request. Uma confirmação pode conter até 5.000 alterações; as demais aguardam a próxima vez. Enquanto essa pull request não for mesclada, as strings exibirão Não confirmada ou Sendo aplicada.

Uma tradução automática já confirmada permanece como tradução automática no cache do mecanismo, portanto ainda é classificada como Máquina até que seja revisada por uma pessoa.

A edição requer que o recurso de contribuições esteja ativado no arquivo de configuração; Assistente de internacionalização ativa essas opções por padrão. Os colaboradores também podem sugerir uma redação melhor no seu próprio site.

Trocar arquivos#

Em Troca, faça o download das strings para uma agência, uma ferramenta de tradução ou uma planilha e importe as traduções de volta.

Uma exportação contém as strings que precisam de trabalho ou todas as strings. Placeholders e mensagens plurais são transferidos exatamente como foram escritos.

Uma importação exibe cada linha antes que algo seja mantido. Novas traduções e alterações podem ser aceitas. Coroid ignora uma chave que o projeto não possui, uma tradução feita a partir de uma fonte que foi alterada posteriormente, placeholders corrompidos e mensagens plurais sem uma forma exigida pelo idioma. As linhas aceitas viram alterações aguardando Confirmar, assim como as edições feitas em Strings.

JSON, arquivos .strings e Android não indicam qual idioma contêm. Coroid extrai essa informação do nome do arquivo, como storefront-de.json, ou solicita.

Verificar cada alteração#

A Verificação de globalização Funciona na verificação de tarefas e em pull requests. Ele analisa as strings que uma alteração afeta em todos os idiomas, bem como o código adicionado pela alteração. Na Visão geral, Visualizar a última verificação em Verificar abre a execução mais recente. Quando um problema de tradução bloqueia uma tarefa, o agente de desenvolvedor corrige isso por meio de uma sessão de tradução para essa tarefa; ele nunca edita manualmente os catálogos de outros idiomas.

O modelo Tradutor#

A tradução possui sua própria função nos perfis do AI, Tradutor, ao lado de Arquiteto, Desenvolvedor, QA e Revisor. Por padrão, utiliza o Hy-MT2, um modelo de tradução, com o GPT-6 Luna como alternativa, quando a política da sua organização permitir. Altere o mapeamento em um perfil do AI da mesma forma que qualquer outra função.

O mecanismo também agrupa as strings por tamanho, valida cada resposta de acordo com seus placeholders e regras de plural, e repete ou encaminha para escalonamento uma string que falhar.

Custos#

As traduções estão disponíveis em todos os planos. As chamadas de tradução passam pelo gateway de tradução do Coroid e são cobradas como uso de modelo para a sua organização, da mesma forma que as execuções de agentes. As tarefas de tradução contam para as horas de agente do seu plano, assim como qualquer outra tarefa.

Com a rota de Tradutor padrão, a tradução custa cerca de dois centavos por 1.000 strings por idioma. Traduzir um catálogo de 2.000 strings para dez idiomas custa aproximadamente US$ 0,33, conforme medido por nós.

• Só as alterações geram custos. O mecanismo mantém um cache indexado pelo texto original, de modo que strings não alteradas nunca sejam enviadas novamente.
• Cada tarefa e cada execução possuem um limite de tradução. A sessão de uma tarefa é interrompida no seu limite de gastos, US$ 1 por padrão; uma Traduzir execução na área de trabalho é interrompida em US$ 5. Um projeto pode definir um limite menor em Configurações → Acesso e gastos.
• O memória de tradução não tem custo algum. As strings que sua organização já Traduziu em outro lugar são reutilizadas sem necessidade de chamada ao modelo.
• A leitura não tem custo algum. A área de trabalho e a verificação de Globalização leem seus catálogos; eles não fazem chamadas ao modelo.

Traduzindo fora do Coroid#

O mecanismo é uma ferramenta de linha de comando, coroid-i18n. Seu próprio CI pode executar a mesma versão fixada com sua própria chave OpenRouter. Dentro do Coroid, as tarefas sempre utilizam o gateway de tradução, de modo que os gastos e limites permaneçam em um único lugar.

Relacionado#

• Globalização
• A verificação de Globalização
• Internacionalizar um projeto
• Manter traduções com sugestões
• Políticas e portas de qualidade
• Verificações, execuções e resultados
• Perfis do AI