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:

sh
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.10

Execute 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:

json
{
  "welcome": "Welcome back",
  "button.save": "Save changes"
}

Use o agrupamento JSON correspondente:

json
{
  "$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 #

sh
lingo run

Confira 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.