CLI

Traduza arquivos do projeto, obtenha os resultados e mantenha os catálogos de origem usados por aplicações React.

A CLI do Lingo.dev conecta os arquivos do seu projeto a um engine de localização. Você configura os caminhos de origem e os idiomas de destino, envia o conteúdo selecionado e obtém os arquivos traduzidos. As execuções seguintes usam a versão de referência registrada do conteúdo de origem para processar as alterações.

@lingo.dev/cli instala o executável lingo. Comece por seu primeiro arquivo para conferir o passo a passo completo, da configuração à obtenção dos arquivos.

Instale a versão atual de @lingo.dev/cli e use lingo --version para registrar a versão usada pelo seu projeto. Para lingo.dev@0.138.10 e seus projetos i18n.json, consulte a Referência da CLI v0.

Instale do seu jeito #

Para instalar como dependência do projeto registrada no controle de versão:

sh
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --version

Para disponibilizar o executável em todo o shell:

sh
npm install --global @lingo.dev/cli
lingo --help

Este manual usa lingo diretamente. Se a instalação for local, execute pelo seu gerenciador de pacotes. npx @lingo.dev/cli@latest e pnpm dlx @lingo.dev/cli@latest executam a versão mais recente sem uma instalação persistente. Fixe uma versão quando o comportamento local e o da CI precisarem ser iguais; os exemplos de CI usam Node.js 22.

lingo update usa o método de instalação detectado. Use o gerenciador de pacotes para escolher uma versão específica ou quando a instalação não for reconhecida ou for temporária.

Traduza arquivos ou extraia mensagens #

Para recursos existentes, configure os arquivos, autentique-se e vincule um engine de localização. A tradução é executada no servidor. push --wait aguarda a conclusão e baixa os arquivos; push e pull, executados separadamente, permitem obter os arquivos depois.

Para chamadas no código-fonte React, extrair cria JSONC e declarações TypeScript localmente. Não faz traduções nem instala um ambiente de execução. Adicione o catálogo extraído à configuração de arquivos para tradução e depois carregue-o pelo workflow de catálogos do React.

Preserve o estado necessário para as atualizações #

O primeiro envio simples armazena os bytes do conteúdo de origem. O preenchimento retroativo cria os arquivos de destino ausentes; os envios simples seguintes traduzem as alterações no conteúdo de origem. Mantenha .lingo/config.json, .lingo/lock.json e as traduções aceitas juntos no controle de versão. As credenciais e o ponteiro para a execução mais recente permanecem no seu diretório pessoal.

Enviar, Baixar e Lockfile e cache explicam as opções de modo e recuperação. Comandos lista os comandos de configuração, tradução e manutenção de catálogos.