Instale a CLI do Lingo.dev, configure o seu projeto e gere as suas primeiras traduções.
Pré-requisitos
É necessário Node.js 18 ou superior. Execute node -v para verificar a sua versão.
Passo 1. Inicializar um projeto#
Navegue até ao seu projeto
cd your-project-directoryExecute o comando init
npx lingo.dev@latest initUtilizadores de Windows: Se npx lingo.dev não funcionar, instale primeiro o pacote com npm install lingo.dev@latest e depois use npx lingo.
Siga as instruções. A CLI cria um ficheiro de configuração i18n.json na raiz do projeto.
Passo 2. Configurar um bucket#
Em i18n.json, configure pelo menos um bucket — um formato de ficheiro combinado com padrões include que indicam à CLI onde está o conteúdo traduzível:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["locales/[locale].json"]
}
}
}O marcador [locale] é resolvido para os códigos de idioma configurados em tempo de execução — locales/en.json para a origem, locales/es.json para espanhol, e assim sucessivamente.
Para consultar a lista completa de formatos de ficheiro suportados e respetivas configurações de bucket, veja Supported Formats.
Passo 3. Ligar um backend de tradução#
A CLI precisa de um backend de tradução para gerar traduções. Há duas opções:
Um motor de localização no Lingo.dev aplica automaticamente a voz da marca, o glossary, as instructions e a configuração do modelo a cada pedido de tradução.
Crie uma conta e gere uma chave de API na página API Keys.
Defina a chave de API como variável de ambiente:
export LINGO_API_KEY="your-api-key"Não é necessária configuração adicional — a CLI usa o motor de localização predefinido da sua organização. Para direcionar para um motor específico, adicione engineId ao seu i18n.json:
{
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Passo 4. Gerar traduções#
npx lingo.dev@latest runA CLI deteta os seus ficheiros de origem, extrai o conteúdo traduzível, envia-o para o backend de tradução configurado e grava os resultados no disco. É criado um ficheiro i18n.lock para acompanhar o que já foi traduzido — faça commit desse ficheiro juntamente com os seus ficheiros de idioma.
