Configuração da CLI v0
Configure grupos legados, caminhos de idiomas e serviços de tradução sem misturar gerações.
A lingo.dev@0.138.10 lê i18n.json no diretório de trabalho. Cada grupo identifica o analisador a utilizar e deteta os ficheiros; as definições de idioma identificam o idioma de origem e os idiomas de destino. Este contrato é distinto do da .lingo/config.json atual.
Declare os idiomas e os grupos #
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
},
"markdown": {
"include": ["docs/[locale]/*.md"],
"exclude": ["docs/[locale]/drafts/*.md"]
}
}
}Os caminhos são relativos à configuração. A chave do grupo seleciona o analisador, não a extensão do ficheiro. Consulte a matriz de formatos e saídas legada quando um formato guardar vários idiomas num único ficheiro.
O campo version regista a geração do esquema. Uma migração do esquema legado pode atualizar esse ficheiro sem migrar para a CLI atual. Guarde a configuração anterior e reveja todas as alterações geradas.
Defina cuidadosamente a correspondência dos caminhos #
[locale] é substituído pelo código do idioma de origem ou de destino. Um delimitador específico de cada caminho permite usar nomes de ficheiros com sublinhados:
{
"include": [
"standard/[locale].json",
{ "path": "legacy/[locale].json", "delimiter": "_" }
]
}Para en-US, o segundo caminho usa legacy/en_US.json. A representação no nome do ficheiro é independente dos valores de idioma normalizados enviados ao serviço de tradução.
A deteção recursiva de ** está disponível a partir de 0.135.0; as versões anteriores exigem caminhos explícitos. Por predefinição, a deteção recursiva exclui node_modules, .git, dist, build, .next e .turbo. Adicione exclusões para outras árvores de diretórios geradas.
Defina o comportamento das chaves #
Os controlos de chaves legados usam percursos separados por barras e correspondência com carateres universais. modules/ai.translation seleciona a chave literal que contém pontos dentro de modules. O bloqueio copia os valores de origem, a opção de ignorar omite-os da saída e a preservação preenche os valores em falta a partir da origem, deixando depois a sua gestão a cargo de pessoas. injectLocale seleciona as chaves de saída para o código do idioma de destino.
Consulte Controlos de chaves para conhecer os efeitos exatos. Uma instrução de tradução não garante proteção estrutural, e um marcador de posição no idioma de origem continua a precisar de tradução humana antes de ser utilizado.
Escolha um motor de localização ou um fornecedor direto #
Com uma credencial da Lingo.dev, engineId seleciona o glossário, as regras, a voz e os modelos de um motor de localização. Prefira uma seleção explícita. Se omitir este campo, aplica-se a política do serviço, em vez de se identificar uma configuração estável; o serviço atual pode exigir um ID ou selecionar o motor de localização ativo mais antigo ao qual a chave tem acesso.
Os fornecedores diretos usam um ID de fornecedor, um modelo e uma instrução para o modelo. Este formato histórico não deve ser interpretado como uma recomendação que pressuponha que o modelo indicado continua disponível:
{
"provider": {
"id": "openai",
"model": "gpt-4o-mini",
"prompt": "Translate the provided text from {source} to {target}."
}
}A instrução para o modelo substitui {source} e {target} por códigos de idioma. Não conte com provider.baseUrl para redirecionar os pedidos run de lingo.dev@0.138.10. A integração com a OpenAI passa baseUrl, mas a dependência do fornecedor, fixada numa versão específica, lê baseURL, pelo que esse valor de configuração é ignorado. Em alternativa, a dependência suporta OPENAI_BASE_URL; verifique o destino pretendido antes de enviar conteúdo ou credenciais. A integração com o Ollama também ignora provider.baseUrl e cria o fornecedor com as predefinições. O respetivo serviço tem de estar acessível a partir do executor; um executor remoto não pode usar o endereço localhost de um portátil.
| Serviço de tradução | Credencial |
|---|---|
| Lingo.dev | LINGO_API_KEY |
| OpenAI | OPENAI_API_KEY |
| Anthropic | ANTHROPIC_API_KEY |
GOOGLE_API_KEY | |
| Mistral | MISTRAL_API_KEY |
| OpenRouter | OPENROUTER_API_KEY |
| Ollama local | Sem chave de API do fornecedor na configuração local. |
LINGO_API_URL altera o destino do serviço Lingo.dev; continua a ser necessário verificar a compatibilidade e a confiança no destino. Mantenha as credenciais fora da configuração e dos registos. Depois de alterar o serviço de tradução ou a deteção de ficheiros, repita uma pequena execução com o primeiro ficheiro. Alterar um modelo ou uma instrução para o modelo não altera as impressões digitais do conteúdo de origem, pelo que o texto existente precisa de uma atualização deliberada quando essa for a intenção.