Retradução

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

Descontinuado

Esta documentação abrange a CLI antiga (v0). A versão atual da CLI é a v1. Ver a documentação atual da CLI

A CLI do Lingo.dev oferece opções manuais de retradução para atualizar traduções quando o texto de origem não mudou — por exemplo, após trocar de modelos de IA, atualizar prompts de tradução ou melhorar a configuração do motor de localização.

Para retradução automática acionada por alterações no texto de origem, consulte Retradução Automática.

Retradução completa#

Ignore o ficheiro de bloqueio e retraduza todo o conteúdo:

bash
npx lingo.dev@latest run --force

Isto retraduz todas as chaves em todos os idiomas de destino e recria o ficheiro i18n.lock.

Retradução direcionada#

Por idioma#

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

Retraduz apenas o espanhol, preservando todos os restantes idiomas.

Por tipo de bucket#

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

Retraduz apenas ficheiros JSON, deixando Markdown e os restantes formatos inalterados.

Por chave#

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

Retraduz uma única chave em todos os idiomas de destino. Suporta padrões glob.

Por ficheiro#

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

Retraduz ficheiros específicos. Pode combinar várias flags --file.

Combinado#

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

As opções podem ser combinadas para um controlo mais preciso — neste caso, retraduz todo o conteúdo JSON apenas para espanhol.

Retradução eficiente com purge#

Para obter o melhor desempenho, use purge antes de run, em vez de --force. Assim, tira partido do mecanismo de cache integrado da CLI:

bash
# 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#

CenárioAbordagem recomendada
O texto de origem mudouAutomática — não é necessária qualquer ação
Mudou de modelos de IArun --force ou retradução direcionada
Atualizou os prompts de traduçãorun --force ou retradução direcionada
Melhorou a configuração do motorRetradução direcionada para os idiomas afetados
Qualidade fraca num idioma específicorun --force --target-locale <locale>

Próximos passos#