Voltar a traduzir conteúdo selecionado da CLI v0
Atualize traduções antigas após alterações ao conteúdo de origem ou às orientações, mantendo o controlo do âmbito e protegendo as edições aceites.
Utilize uma execução normal quando o conteúdo de origem mudar. Force a execução quando a origem se mantiver igual, mas a tradução precisar de refletir novas instruções ou substituir um valor insatisfatório. Ambas as opções podem substituir edições manuais comuns.
Deixe que as alterações na origem determinem o que processar numa execução normal #
lingo run| Estado da origem/do destino | Resultado de uma execução normal da v0 |
|---|---|
| O valor de origem mudou face à soma de verificação anterior | Traduzir o valor alterado. |
| Uma chave de origem está em falta no destino | Traduzir o conteúdo em falta. |
| Uma chave de origem foi removida | Remover a respetiva entrada gerida 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 nesse contexto de processamento. |
| O destino existe e a origem não foi alterada | Manter o valor de destino. |
Uma correção manual comum mantém-se enquanto a origem não mudar, mas não fica protegida de todas as atualizações futuras. As chaves preservadas reservam um valor separado, sob controlo humano.
Atualize uma tradução afetada #
Depois de alterar um modelo, uma instrução de entrada, um glossário ou uma 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 pela shell.
Compare a tradução com a origem, lado a lado, e depois carregue-a na aplicação. O processamento limitado a um idioma ou a uma chave não atualiza uma base de referência partilhada existente. Siga as regras de consolidação do Lockfile para evitar que uma execução normal posterior volte inesperadamente a processar a mesma alteração na origem.
Selecione um volume de trabalho gerível num projeto de grande dimensão #
--target-locale, --bucket, --file e --key são seletores que pode repetir. --source-locale altera a origem utilizada na execução. Comece pelo inventário de grupos/caminhos configurados e restrinja a seleção a partir daí, em vez de indicar um ficheiro arbitrário que não esteja configurado.
lingo run --target-locale es --bucket json --file 'apps/web/**'A correspondência de ficheiros do comando run aceita subcadeias ou padrões minimatch nos caminhos configurados detetados. No comando purge, a correspondência de ficheiros aceita apenas subcadeias; a correspondência de chaves também funciona de forma diferente. Não reutilize seletores de um comando no outro sem verificar as entradas selecionadas.
Para uma atualização deliberadamente mais abrangente:
lingo run --force --bucket json --target-locale esEsta operação pode voltar a gerar todo o conteúdo JSON em espanhol selecionado. lingo run --force sem opções abrange o projeto configurado. Preserve os resultados aceites antes de alargar o âmbito e estime o mesmo âmbito de execução forçada quando utilizar o serviço de processamento do Lingo.dev.
Para alterações de grande dimensão, separar o processamento por ficheiro e por idioma facilita a revisão das diferenças. Após uma falha, mantenha os resultados dos blocos concluídos com êxito e volte a tentar processar o âmbito relevante antes de forçar uma nova execução de tudo. O processamento paralelo controla o volume processado por unidade de tempo, não a seleção nem a reversão.
Mantenha os catálogos da interface e os documentos em grupos separados por formato, excluindo o conteúdo gerado e os rascunhos. Separe as configurações de pacotes quando os destinos ou os motores de localização forem diferentes. Em CI, lingo run --frozen verifica uma base de referência de confiança sem traduzir; investigue as falhas em vez de recalcular as somas de verificação para as ocultar. A receita de execução atual utiliza um pacote e uma configuração diferentes, pelo que deve migrar antes de a adotar.
Utilize o comando purge apenas quando pretender eliminar conteúdo #
A técnica antiga de executar purge seguido de run deixa chaves em falta no destino, para que sejam processadas pelo preenchimento normal de lacunas. Esta técnica elimina os resultados antes de a regeneração ser concluída com êxito e não oferece uma melhoria de desempenho comprovada. Consulte a referência do comando purge para confirmar os 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 êxito.