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:
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --versionPara instalar um executável disponível em toda a shell:
npm install --global @lingo.dev/cli
lingo --helpEste 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.