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 #

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 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:

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 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:

json
{
  "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çãoCredencial
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 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.