Traduzir um ficheiro com a CLI v0
Reproduza uma execução de um pequeno catálogo legado com uma versão fixa do pacote e examine o resultado e o Lockfile.
Siga este procedimento num projeto com i18n.json instalado ou num cenário de teste legado isolado. Destina-se a lingo.dev@0.138.10, cujo manifesto exige o Node.js 18 ou posterior. Verifique primeiro node --version e a versão instalada de lingo --version. Para novos projetos, siga o guia de início rápido atual.
Use o pacote registado #
Num projeto existente, mantenha a versão fixa da dependência. Para um cenário de teste separado, escolha o gestor de pacotes que utiliza:
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. Invoque o executável local através de npm exec -- lingo, pnpm exec lingo, yarn lingo ou bun run lingo. Nos exemplos abaixo, esta invocação é abreviada como lingo. No Windows, usar uma instalação local com uma versão fixa e invocar o executável do gestor 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 a partir do diretório onde o projeto deve ficar. O comando cria i18n.json; se o ficheiro já existir, mantenha-o em vez de o reinicializar. 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 indica a versão do esquema de configuração, não a versão do pacote. Este padrão lê o conteúdo em inglês de locales/en.json e escreve a tradução em espanhol em locales/es.json.
Configure o serviço de tradução #
Para o Lingo.dev, forneça LINGO_API_KEY através do mecanismo de gestão de segredos do seu interpretador de comandos. Adicione o engineId pretendido à configuração e certifique-se de que a chave permite traduzir através desse motor de localização. Se o ID for omitido, aplica-se a seleção implícita do serviço; a política atual do serviço pode exigir um ID explícito.
A configuração v0 para ligação direta a um fornecedor é uma opção distinta e requer credenciais específicas desse fornecedor ou um serviço Ollama acessível. A respetiva Referência de configuração explica os campos. Estes não devem ser incluídos na configuração JSON da CLI atual.
Execute e verifique #
lingo runExamine locales/es.json para verificar tanto as chaves como os valores efetivamente traduzidos. Confirme que a mensagem para guardar continua a indicar a ação pretendida. Ao integrar com uma aplicação, carregue o catálogo de destino através do carregador de catálogos que a aplicação realmente utiliza. Inclua o resultado aceite, a configuração e i18n.lock no mesmo commit.
Uma execução normal, sem alterações no conteúdo de origem, deve manter os valores de destino existentes. Alterações na origem ou uma execução forçada podem substituí-los. As execuções limitadas a um idioma de destino ou a determinadas chaves não atualizam um estado de referência da origem já existente, e o modo congelado pode inicializar um Lockfile em falta. Leia consolidação do estado de referência antes de considerar que o resultado de uma execução limitada corresponde a um projeto totalmente atualizado.
Durante o desenvolvimento, lingo run --watch monitoriza as alterações na origem até ser interrompido com Ctrl+C. Antes de alargar o cenário de teste, consulte adoção de traduções existentes e controlo manual das traduções de destino.