|
Documentação
Agende uma demoPlataforma
PlataformaMCPCLI
APIWorkflows
GuiasChangelog

Visão geral

  • @lingo.dev/cli

Primeiros passos

  • Início rápido
  • Configuração

Referência

  • lingo push
  • lingo pull
  • Outros comandos
  • lingo purge

Configuração

  • Controles de chave
  • Formatos
  • Idiomas

Guias

  • Adicionando um idioma
  • Traduções existentes
  • Retradução
  • Notas do tradutor
  • Execuções, estado e recuperação
  • CI/CD
  • Monorepos
  • Projetos grandes

Está procurando a versão anterior do CLI (v0)? Veja a documentação do CLI legado

Retradução

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#

bash
lingo push content/en/landing.mdx --force

Uma subárvore#

bash
lingo push 'content/en/**/*.md' --force

Tudo#

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

bash
lingo purge --locale fr
lingo push --backfill-missing

purge 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:

bash
lingo push 'content/en/**/*.md' --force --estimate

As estimativas são heurísticas, não uma cotação — o custo final pode variar.

Quando retraduzir#

SituaçãoO que executar
O texto-fonte mudouNada — um lingo push normal já resolve
Troca no modelo do enginelingo push <scope> --force
Instruções / glossário atualizadoslingo push <scope> --force ou purge por idioma + backfill
Qualidade ruim em um idiomalingo purge --locale <code> e depois lingo push --backfill-missing
Recomeçando do zerolingo push --backfill-missing --force --yes

Esta página foi útil?

Max PrilutskiyMax Prilutskiy·Atualizado há 4 dias·2 min de leitura