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 #
lingo run| Estado da origem e do destino | Resultado da execução normal na v0 |
|---|---|
| O valor de origem mudou em relação à soma de verificação anterior | Traduzir o valor alterado. |
| Uma chave de origem está ausente no destino | Traduzir o conteúdo ausente. |
| Uma chave de origem foi removida | Remover 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 removida | Reutilizar a tradução dentro do contexto processado. |
| Destino presente e origem inalterada | Manter 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:
lingo run --force --target-locale es --key welcome/titleAqui, 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.
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:
lingo run --force --bucket json --target-locale esIsso 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.