CLI

Traduza ficheiros do projeto, obtenha os resultados e mantenha os catálogos de origem utilizados pelas aplicações React.

A CLI do Lingo.dev liga os ficheiros do seu projeto a um motor de localização. Configure os caminhos de origem e os idiomas de destino, envie o conteúdo selecionado e obtenha os ficheiros traduzidos. Nas execuções seguintes, as alterações são processadas com base no estado de referência da origem previamente registado.

@lingo.dev/cli instala o executável lingo. Comece pelo guia o seu primeiro ficheiro para seguir todos os passos, desde a configuração até à obtenção dos resultados.

Instale a versão atual de @lingo.dev/cli e utilize lingo --version para registar a versão utilizada pelo seu projeto. Para lingo.dev@0.138.10 e os respetivos projetos i18n.json, consulte a referência da CLI v0.

Instale à sua maneira #

Para instalar como dependência do projeto registada no controlo de versões:

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

Para instalar um executável disponível em toda a shell:

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

Este manual utiliza lingo diretamente. Se optar por uma instalação local, execute-o através do seu gestor 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 precisar de garantir o mesmo comportamento localmente e em CI; os exemplos de CI utilizam o Node.js 22.

lingo update utiliza o método de instalação detetado. Recorra ao gestor de pacotes para escolher uma versão específica ou gerir uma instalação não reconhecida ou temporária.

Traduza ficheiros ou extraia mensagens #

Para recursos existentes, configure os ficheiros, autentique-se e associe um motor de localização. A tradução é executada no servidor. push --wait aguarda e descarrega os resultados; push e pull, em separado, permitem obtê-los mais tarde.

Para chamadas no código-fonte React, a extração cria localmente ficheiros JSONC e declarações TypeScript. Não traduz nem instala um ambiente de execução. Adicione o catálogo extraído à configuração de ficheiros para tradução e, em seguida, carregue-o através do workflow de catálogos do React.

Preserve o estado necessário às atualizações #

O primeiro envio simples guarda os bytes de origem. O preenchimento retroativo cria os ficheiros de destino em falta; os envios simples seguintes traduzem as alterações na origem. Mantenha .lingo/config.json, .lingo/lock.json e as traduções aceites juntos no controlo de versões. As credenciais e o apontador para a execução mais recente permanecem no seu diretório pessoal.

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