|
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

Projetos grandes

As traduções rodam no servidor, então escalar é, em grande parte, problema do engine — não seu. lingo push envia o trabalho e o engine cuida do processamento; você não precisa configurar pools de workers nem concorrência. O que fica no seu controle é quanto enviar de uma vez e como recuperar uma execução.

Envie só o que mudou#

Por padrão, lingo push gera um hash de cada fonte em relação ao lockfile e envia apenas o que mudou. Em um repositório grande, esse é o caminho mais econômico — se o corpus não mudou, nada acontece, sem round-trip com o servidor. Deixe o delta fazer o trabalho e evite --force em massa.

Defina o escopo de mudanças grandes#

Quando você realmente precisar retraduzir, limite o escopo a uma subárvore em vez de incluir o projeto inteiro:

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

Assim, uma execução grande continua controlada e previsível. Veja Retradução.

Estime antes de execuções grandes#

Calcule o custo de uma execução grande antes de seguir em frente:

bash
lingo push --backfill-missing --estimate

Mostra o custo estimado e encerra. Útil antes da primeira tradução completa ou de trocar de modelo em vários idiomas.

Não pare por causa da execução#

Em execuções grandes, você não precisa ficar preso ao comando. push registra a execução em run state, então você pode buscar os resultados depois ou a partir do CI:

bash
# kick it off
lingo push --backfill-missing

# later, or in CI
lingo pull

Recupere em vez de recomeçar#

Se uma execução grande falhar no meio do caminho, não reenfileire tudo de novo — lingo resume reemite resultados em cache sem gerar novo custo, e depois --backfill-missing preenche o que ficou faltando.

Automatize#

Para manter um projeto grande sempre atualizado, deixe o CI traduzir a cada merge e abrir um PR com os resultados. Veja CI/CD.

Vindo do CLI legado?

O CLI legado expunha controles de concorrência no lado do cliente (pools de workers, flags de paralelismo) porque a tradução acontecia na sua máquina. O CLI atual traduz no servidor, então esses controles desapareceram — a escala já é gerenciada para você. Escopo, backfill e retomada são as alavancas agora.

Esta página foi útil?

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