Traduza um arquivo com a CLI v0
Reproduza a execução de um pequeno catálogo legado com uma versão fixa do pacote e confira a saída e o Lockfile.
Use este procedimento em um projeto i18n.json já instalado ou em um ambiente de teste legado e isolado. Ele é voltado para o lingo.dev@0.138.10, cujo manifesto exige Node.js 18 ou superior. Antes de tudo, verifique o node --version e o lingo --version instalado. Para projetos novos, use o guia de início rápido atual.
Use o pacote registrado #
Em um projeto existente, mantenha a versão fixa da dependência. Para um ambiente de teste separado, escolha o gerenciador de pacotes que você usa:
npm install --save-dev lingo.dev@0.138.10
pnpm add --save-dev lingo.dev@0.138.10
yarn add --dev lingo.dev@0.138.10
bun add --dev lingo.dev@0.138.10Execute apenas um comando de instalação. Chame o binário local via npm exec -- lingo, pnpm exec lingo, yarn lingo ou bun run lingo. Nos exemplos abaixo, isso aparece abreviado como lingo. No Windows, usar uma instalação local com versão fixa e chamar o binário do gerenciador de pacotes também evita depender da resolução de comandos pelo nome do pacote.
Crie o catálogo e a configuração #
Execute lingo init no diretório que vai abrigar o projeto. O comando cria i18n.json; se o arquivo já existir, preserve-o em vez de reinicializá-lo. Crie locales/en.json:
{
"welcome": "Welcome back",
"button.save": "Save changes"
}Use o agrupamento JSON correspondente:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es"] },
"buckets": {
"json": { "include": ["locales/[locale].json"] }
}
}version é a versão do esquema de configuração, e não a versão do pacote. Com esse padrão, o conteúdo em inglês é lido de locales/en.json e o conteúdo em espanhol é gravado em locales/es.json.
Configure o backend de tradução #
No Lingo.dev, forneça LINGO_API_KEY pelo mecanismo de segredos do seu shell. Adicione o engineId desejado à configuração e confirme que a chave tem permissão para traduzir por meio dessa engine de localização. Se ele for omitido, vale a seleção implícita do backend; a política atual do serviço pode exigir um ID explícito.
A configuração v0 com provedor direto é uma alternativa à parte, que usa credenciais específicas do provedor ou um serviço Ollama acessível. A referência de configuração correspondente explica os campos. Eles não fazem parte da configuração JSON da CLI atual.
Execute e confira #
lingo runConfira em locales/es.json tanto as chaves quanto os valores efetivamente traduzidos. Verifique se a mensagem de salvamento ainda indica a ação pretendida. Ao integrar com uma aplicação, carregue o destino pelo carregador de catálogos real dela. Faça o commit da saída aprovada, da configuração e de i18n.lock juntos.
Uma execução comum, sem alterações na origem, deve manter os valores de destino já existentes. Alterações na origem ou uma execução forçada podem substituí-los. Execuções restritas a um idioma de destino ou a determinadas chaves não atualizam uma linha de base de origem existente, e o modo congelado pode inicializar um Lockfile ausente. Leia sobre a consolidação da linha de base antes de considerar uma saída de escopo restrito como sinal de que o projeto está totalmente atualizado.
Durante o desenvolvimento, lingo run --watch acompanha as alterações na origem até ser interrompido com Ctrl+C. Antes de ampliar o ambiente de teste, consulte a adoção de traduções existentes e o controle manual do conteúdo de destino.