lingo push traduz apenas o que mudou: ele gera um hash de cada texto-fonte com base no lockfile e ignora tudo o que corresponder. Esse é o padrão ideal, mas às vezes você precisa retraduzir conteúdos cujo texto-fonte continua idêntico — depois de trocar o modelo do engine, atualizar as instruções ou o glossário, ou corrigir um problema de qualidade.
Há duas formas de forçar isso: um push com escopo via --force ou purge seguido de um push normal.
Forçar um push com escopo#
--force retraduz todos os destinos que correspondem ao escopo, ignorando traduções existentes e o cache no servidor. Ele exige um escopo — usar lingo push --force sozinho é rejeitado para evitar que você retraduza o projeto inteiro por acidente.
Um arquivo#
lingo push content/en/landing.mdx --forceUma subárvore#
lingo push 'content/en/**/*.md' --forceTudo#
lingo push --backfill-missing --force --yes--force pede confirmação antes de sobrescrever; use --yes para pular essa etapa (CI). Consulte lingo push para ver a referência completa de flags.
Retraduzir um único idioma#
push não tem uma flag por idioma. Para refazer apenas um idioma, exclua os arquivos dele e faça um backfill:
lingo purge --locale fr
lingo push --backfill-missingpurge remove os destinos de fr; em seguida, --backfill-missing regenera apenas o que estiver faltando — os outros idiomas permanecem intocados. Isso também sai mais barato do que --force, porque tudo, exceto fr, continua sendo um acerto de cache. Consulte Purge.
Estime antes de gastar#
Qualquer push aceita --estimate, que estima o custo da execução e sai sem traduzir:
lingo push 'content/en/**/*.md' --force --estimateAs estimativas são heurísticas, não uma cotação — o custo final pode variar.
Quando retraduzir#
| Situação | O que executar |
|---|---|
| O texto-fonte mudou | Nada — um lingo push normal já resolve |
| Troca no modelo do engine | lingo push <scope> --force |
| Instruções / glossário atualizados | lingo push <scope> --force ou purge por idioma + backfill |
| Qualidade ruim em um idioma | lingo purge --locale <code> e depois lingo push --backfill-missing |
| Recomeçando do zero | lingo push --backfill-missing --force --yes |
