Aproveite traduções existentes na CLI v0
Preencha as chaves ausentes de catálogos legados, preserve os valores existentes e estabeleça uma base de referência confiável para o conteúdo de origem.
A V0 pode partir de catálogos criados em outras ferramentas. O processamento incremental padrão compara as chaves de origem e de destino e adiciona as entradas ausentes sem gerar novamente os valores existentes. Esse comportamento é diferente do preenchimento de arquivos ausentes feito pela CLI atual.
Preserve o trabalho já feito #
Configure o bucket do catálogo em i18n.json e salve uma cópia recuperável das traduções de destino aprovadas. Confira se os valores existentes são traduções de fato: textos provisórios no idioma de origem podem esconder as lacunas que você pretende preencher.
Por exemplo, este conteúdo de origem tem três chaves:
{
"welcome": "Welcome back",
"button.save": "Save",
"button.cancel": "Cancel"
}O catálogo de destino já existente em espanhol contém duas:
{
"welcome": "Te damos la bienvenida de nuevo",
"button.save": "Guardar"
}A tarefa padrão de preenchimento de lacunas adiciona button.cancel e preserva os valores existentes, a menos que somas de verificação anteriores indiquem uma alteração na origem que exija uma nova tradução.
Execute para um único idioma e confira as diferenças #
lingo run --target-locale esConfira as adições, as remoções de chaves que já não existem na origem e os valores gerados novamente para chaves alteradas. Verifique o idioma e o carregamento da aplicação e, em seguida, faça o commit do resultado aprovado junto com o estado do Lockfile.
Uma execução com escopo limitado não atualiza a base de referência existente das somas de verificação da origem. Um Lockfile inalterado não comprova que todos os idiomas correspondem ao conteúdo de origem atual. Uma execução padrão posterior pode voltar a processar textos de origem alterados; siga as orientações de consolidação da base de referência.
Quando uma chave existente não tem uma soma de verificação anterior, 0.138.10 não a marca como atualizada apenas por essa ausência. Portanto, a falta de um Lockfile não força a retradução de todo o conteúdo nem comprova que as traduções de destino existentes estão atualizadas. Confira os pares que geram dúvidas antes de adotar a nova base de referência como definitiva.
Corrija os problemas conhecidos separadamente #
Se um valor existente estiver incorreto, faça uma correção manual ou solicite uma atualização seletiva:
lingo run --force --target-locale es --key button.cancelForçar a atualização pode sobrescrever o trabalho manual. Use chaves preservadas quando um valor precisar permanecer sob controle humano e inclua nessa responsabilidade a revisão de alterações posteriores no conteúdo de origem.