Retradução automática

Max PrilutskiyCEO e cofundadorAtualizado em: há 3 meses · 1 min de leitura

Obsoleto

Esta documentação cobre o CLI legado (v0). O CLI atual é o v1. Veja a documentação atual da CLI

A CLI do Lingo.dev retraduz automaticamente o conteúdo quando você altera o texto-fonte. O lockfile armazena fingerprints de cada string de origem — quando uma fingerprint muda, a CLI envia o conteúdo atualizado pelo pipeline de tradução e substitui a tradução anterior em todos os arquivos de destino.

Como funciona#

json
// locales/en.json (original)
{ "button.save": "Save changes" }

// locales/es.json (generated)
{ "button.save": "Guardar cambios" }

Depois de editar o texto-fonte:

json
// locales/en.json (updated)
{ "button.save": "Save all changes" }

Ao executar npx lingo.dev@latest run, a CLI detecta a nova fingerprint e retraduz o conteúdo:

json
// locales/es.json (updated automatically)
{ "button.save": "Guardar todos los cambios" }

As chaves que não mudaram são ignoradas por completo — apenas a chave modificada é enviada ao backend de tradução.

O que dispara a retradução#

MudançaRetraduz?
Texto-fonte modificadoSim
Texto-fonte inalteradoNão
Chave renomeada, conteúdo inalteradoNão — a tradução é mantida
Chave removida da fonteTradução removida dos arquivos de destino
Nova chave adicionada à fonteTraduzida como conteúdo novo

Overrides e retradução automática#

Se você substituiu manualmente uma tradução, a retradução automática substitui essa alteração quando a fonte muda. Isso é intencional — uma mudança no texto-fonte sinaliza que o significado mudou e que uma nova tradução é necessária.

Para retraduzir conteúdo por outros motivos (mudança de modelo, atualização de prompt), consulte Retranslation.

Próximos passos#