Retraduza conteúdos selecionados da CLI v0

Atualize traduções legadas após mudanças na origem ou nas orientações, mantendo o controle do escopo e protegendo as edições aceitas.

Use uma execução normal quando o conteúdo de origem mudar. Use uma execução forçada quando a origem continuar igual, mas a tradução precisar refletir novas instruções ou substituir um valor insatisfatório. Ambas podem substituir edições manuais comuns.

Deixe as mudanças na origem definirem o que processar na execução normal #

sh
lingo run
Estado da origem e do destinoResultado da execução normal na v0
O valor de origem mudou em relação à soma de verificação anteriorTraduzir o valor alterado.
Uma chave de origem está ausente no destinoTraduzir o conteúdo ausente.
Uma chave de origem foi removidaRemover a entrada gerenciada correspondente no destino.
O valor de origem de uma nova chave tem a mesma soma de verificação que o de uma chave removidaReutilizar a tradução dentro do contexto processado.
Destino presente e origem inalteradaManter o valor de destino.

Uma correção manual comum é mantida enquanto a origem não muda, mas não fica protegida de todas as atualizações futuras. As chaves preservadas reservam um valor separado, sob controle humano.

Atualize uma tradução afetada #

Após alterar um modelo, prompt, glossário ou regra, comece pelo idioma e pela chave afetados:

sh
lingo run --force --target-locale es --key welcome/title

Aqui, welcome/title aponta para title dentro de welcome. Em 0.138.10, o comando run aceita chaves exatas, prefixos que respeitam os limites das chaves e padrões glob. Coloque --key 'welcome/**' entre aspas para selecionar descendentes sem expansão pelo shell.

Compare a tradução com o conteúdo de origem, lado a lado, e depois carregue-a na aplicação. Uma execução restrita a um idioma ou a uma chave não atualiza uma base de referência compartilhada já existente. Siga as regras de consolidação do Lockfile para evitar que uma execução normal posterior volte a processar a mesma alteração na origem de forma inesperada.

Defina um escopo de trabalho gerenciável em projetos grandes #

--target-locale, --bucket, --file e --key são seletores que podem ser repetidos. --source-locale altera a origem usada na execução. Parta do inventário de grupos de formato e caminhos configurados e restrinja a seleção, em vez de indicar um arquivo arbitrário que não esteja configurado.

sh
lingo run --target-locale es --bucket json --file 'apps/web/**'

O seletor de arquivos de run aceita correspondências por trecho de texto ou por minimatch nos caminhos configurados encontrados. Já o seletor de arquivos de purge aceita apenas correspondências por trecho de texto; seu seletor de chaves também funciona de forma diferente. Não reutilize seletores de um comando no outro sem conferir as entradas selecionadas.

Para uma atualização mais ampla e planejada:

sh
lingo run --force --bucket json --target-locale es

Isso pode regenerar todo o conteúdo JSON em espanhol selecionado. lingo run --force sem opções abrange o projeto configurado. Preserve o resultado aceito antes de ampliar o escopo e faça uma estimativa para o mesmo escopo de execução forçada ao usar o backend do Lingo.dev.

Em alterações grandes, separar os escopos por arquivo e idioma facilita a revisão das diferenças. Após uma falha, mantenha os resultados dos lotes concluídos com sucesso e tente novamente no escopo afetado antes de forçar uma nova execução de tudo. O processamento paralelo controla a taxa de processamento, não a seleção nem a reversão.

Mantenha os catálogos de interface e os documentos em grupos de formato próprios, excluindo conteúdo gerado e rascunhos. Separe as configurações de pacote quando os destinos ou as engines de localização forem diferentes. Na CI, lingo run --frozen verifica uma base de referência confiável sem traduzir; investigue as falhas em vez de recalcular as somas de verificação para ocultá-las. A receita atual do executor usa um pacote e uma configuração diferentes, então faça a migração antes de adotá-la.

Use purge apenas quando a intenção for excluir #

A técnica antiga de executar purge e depois run deixa as chaves ausentes no destino para que sejam processadas pelo preenchimento normal de lacunas. Ela exclui o resultado antes que a regeneração seja concluída com sucesso e não oferece uma melhoria de desempenho comprovada. Consulte a referência de purge para conferir seus seletores específicos e o risco para o idioma de origem; mantenha uma cópia recuperável até que a regeneração e a revisão sejam concluídas com sucesso.