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:
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --versionPara disponibilizar o executável em todo o shell:
npm install --global @lingo.dev/cli
lingo --helpEste 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.