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 #

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

json
{
  "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:

json
{
  "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 processamentoCredencial
Lingo.devLINGO_API_KEY
OpenAIOPENAI_API_KEY
AnthropicANTHROPIC_API_KEY
GoogleGOOGLE_API_KEY
MistralMISTRAL_API_KEY
OpenRouterOPENROUTER_API_KEY
Ollama localSem 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.