Configurazione

File di configurazione

Crea tyndale.config.json nella radice del tuo progetto, oppure esegui npx tyndale init per generarne uno.

{
  "defaultLocale": "en",
  "locales": ["es", "fr", "ja"],
  "source": ["src", "app"],
  "extensions": [".ts", ".tsx", ".js", ".jsx"],
  "output": "public/_tyndale",
  "translate": {
    "tokenBudget": 50000,
    "concurrency": 8
  },
  "localeAliases": { "pt-BR": "pt" },
  "dictionaries": {
    "include": ["src/dictionaries/*.json"],
    "format": "key-value"
  },
  "pi": {
    "model": "claude-sonnet-4-20250514",
    "thinkingLevel": "low"
  },
  "docs": {
    "framework": "starlight",
    "contentDir": "src/content/docs"
  }
}

Campi

Campo	Tipo	Predefinito	Descrizione
defaultLocale	string	"en"	Codice lingua sorgente
locales	string[]	[]	Codici locale di destinazione
source	string[]	["src"]	Directory da analizzare per i contenuti traducibili
extensions	string[]	[".ts", ".tsx", ".js", ".jsx"]	Estensioni di file da includere
output	string	"public/_tyndale"	Directory di output per i file di locale generati
translate.tokenBudget	number	50000	Budget di token per ogni batch di traduzione AI
translate.concurrency	number	auto	Numero massimo di sessioni di traduzione parallele
localeAliases	object	{}	Mappa i codici locale variante a quelli canonici
dictionaries.include	string[]	[]	Pattern glob per i file di dizionario
dictionaries.format	string	"key-value"	Formato del file di dizionario
pi.model	string	"claude-sonnet-4-20250514"	Modello AI da usare
pi.thinkingLevel	string	"low"	Livello di ragionamento AI
docs.framework	string	—	Framework di documentazione: starlight, docusaurus, vitepress, mkdocs, o nextra
docs.contentDir	string	auto	Directory dei contenuti (relativa alla radice del progetto)
docs.extensions	string[]	auto	Sovrascrive le estensioni dei file per la traduzione della documentazione