Configuração da CLI v0
Configure agrupamentos legados, caminhos de idiomas e serviços de tradução sem misturar gerações.
lingo.dev@0.138.10 lê i18n.json do diretório de trabalho. Cada agrupamento define um analisador e localiza arquivos; as configurações de idioma identificam a origem e os destinos. Esse contrato é diferente do usado atualmente por .lingo/config.json.
Declare idiomas e agrupamentos #
{
"$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 resolvidos em relação à configuração. A chave do agrupamento seleciona o analisador, não a extensão do arquivo. Consulte a matriz de formatos e saídas legada quando um formato armazenar vários idiomas em um único arquivo.
O campo version registra a geração do esquema. Uma migração do esquema legado pode atualizar esse arquivo sem migrar para a CLI atual. Preserve a configuração anterior e revise todas as alterações geradas.
Defina a correspondência dos caminhos com cuidado #
[locale] é expandido para o código do idioma de origem ou de destino. Um delimitador específico para cada caminho permite usar nomes de arquivo 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 arquivo é independente dos valores normalizados de idioma enviados ao serviço de processamento.
A descoberta recursiva de ** está disponível a partir de 0.135.0; versões anteriores exigem caminhos explícitos. Por padrão, a descoberta recursiva exclui node_modules, .git, dist, build, .next e .turbo. Adicione exclusões para outras árvores de arquivos gerados.
Defina o comportamento das chaves #
Os controles legados de chaves usam navegação com barras como separadores e correspondência por curingas. 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 os omite da saída; e a preservação preenche os valores ausentes com os da origem e, a partir daí, os deixa sob controle humano. injectLocale seleciona as chaves de saída para o código do idioma de destino.
Consulte Controles de chaves para entender os efeitos exatos. Uma instrução de tradução não oferece proteção estrutural, e um texto provisório no idioma de origem ainda precisa de tradução humana antes do uso.
Escolha um engine de localização ou um provedor direto #
Com uma credencial do Lingo.dev, engineId seleciona o glossário, as regras, a voz e os modelos de um engine de localização. Prefira selecionar explicitamente. Se a seleção for omitida, vale a política do serviço de processamento, em vez de uma configuração estável especificada; o serviço atual pode exigir um ID ou selecionar o engine de localização habilitado mais antigo ao qual a chave tem acesso.
Provedores diretos usam um ID de provedor, um modelo e um prompt. Esse formato histórico não deve ser interpretado como uma recomendação nem como garantia de que o modelo mencionado continua disponível:
{
"provider": {
"id": "openai",
"model": "gpt-4o-mini",
"prompt": "Translate the provided text from {source} to {target}."
}
}O prompt substitui {source} e {target} por códigos de idioma. Não dependa de provider.baseUrl para redirecionar as solicitações de run feitas por lingo.dev@0.138.10. O fluxo da OpenAI passa baseUrl, enquanto a dependência do provedor com versão fixada lê baseURL; por isso, esse valor de configuração é ignorado. A dependência aceita OPENAI_BASE_URL em vez disso; verifique o destino pretendido antes de enviar conteúdo ou credenciais. O fluxo do Ollama também ignora provider.baseUrl e cria o provedor com as configurações padrão. O serviço precisa estar acessível a partir do executor; um executor remoto não pode usar o endereço localhost de um notebook.
| Serviço de processamento | 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 provedor na configuração local. |
LINGO_API_URL altera o destino do serviço Lingo.dev; ainda é necessário verificar a compatibilidade e a confiabilidade. Mantenha as credenciais fora da configuração e dos registros. Depois de alterar o serviço de processamento ou a descoberta de arquivos, reproduza uma pequena execução com o primeiro arquivo. Alterar um modelo ou prompt não modifica as assinaturas do conteúdo de origem, portanto o texto existente precisa de uma atualização deliberada quando essa for a intenção.