Retradução

A CLI do Lingo.dev oferece opções manuais de retradução para atualizar traduções quando o texto-fonte não mudou — depois de trocar de modelo de IA, atualizar prompts de tradução ou aprimorar a configuração do engine de localização.

Para retradução automática acionada por mudanças no texto-fonte, consulte Retradução automática.

Retradução completa#

Ignore o lockfile e retraduza todo o conteúdo:

npx lingo.dev@latest run --force

Isso retraduz cada chave em cada idioma de destino e recria o arquivo i18n.lock.

Retradução direcionada#

Por idioma#

npx lingo.dev@latest run --force --target-locale es

Retraduz apenas o espanhol, preservando todos os demais idiomas.

Por tipo de bucket#

npx lingo.dev@latest run --force --bucket json

Retraduz apenas arquivos JSON, mantendo Markdown e outros formatos inalterados.

Por chave#

npx lingo.dev@latest run --force --key welcome.title

Retraduz uma única chave em todos os idiomas de destino. Compatível com padrões glob.

Por arquivo#

npx lingo.dev@latest run --force --file blog.[locale].json

Retraduz arquivos específicos. É possível combinar várias flags --file.

Combinado#

npx lingo.dev@latest run --force --bucket json --target-locale es

As opções podem ser combinadas para um controle preciso — isso retraduz todo o conteúdo JSON apenas em espanhol.

Retradução eficiente com purge#

Para obter o melhor desempenho, use purge antes de run, em vez de --force. Isso aproveita o mecanismo de cache integrado da CLI:

# Remove existing translations for a specific key
npx lingo.dev@latest purge --key welcome.title

# Then regenerate (without --force)
npx lingo.dev@latest run

Quando retraduzir#

Próximos passos#