Struktura projektu

Compiler od Lingo.dev v kořenovém adresáři projektu vytváří a udržuje adresář .lingo/, který ukládá metadata překladů a cache. Když této struktuře porozumíte, snáz budete spravovat překlady ve správě verzí, ladit chybějící překlady a optimalizovat výkon buildů.

Adresář .lingo/#

Compiler tento adresář automaticky vytvoří při prvním buildu. Obsahuje všechna metadata překladů, která využívá build pipeline:

.lingo/
  metadata.json              # Translation cache and content hashes
  locale-resolver.server.ts  # Optional: custom server-side locale resolver
  locale-resolver.client.ts  # Optional: custom client-side locale resolver

metadata.json#

Jde o hlavní soubor v adresáři .lingo/. Ukládá:

• Hashe obsahu – stabilní identifikátory založené na hashi pro každý přeložitelný řetězec
• Překlady v cache – vygenerované překlady pro každou dvojici jazyků
• Snapshoty zdrojového textu – podobu zdrojového textu v okamžiku překladu, používanou k detekci změn

Compiler tento soubor čte na začátku každého buildu. Řetězce se shodným hashem znovu použijí překlady z cache. Řetězce se změněným nebo chybějícím hashem se odešlou nakonfigurovanému poskytovateli překladu.

Na co myslet v .gitignore#

Do .gitignore rozhodně nepřidávejte .lingo/. Tento adresář by měl být sledovaný ve správě verzí. Typický soubor .gitignore pro projekt používající Compiler:

# Do NOT ignore .lingo/ - it contains translation cache
node_modules/
dist/
.env

sourceRoot#

Volba sourceRoot určuje, který adresář bude Compiler procházet při hledání přeložitelných React komponent:

{
  sourceRoot: "./app",  // Next.js App Router
  // or
  sourceRoot: "src",    // Vite + React
}

Compiler rekurzivně prochází všechny soubory .tsx, .ts, .jsx a .js v rámci sourceRoot a hledá v nich přeložitelný JSX obsah. Soubory mimo tento adresář nezpracovává.

Opt-in režim s „use i18n“#

Ve výchozím nastavení Compiler překládá všechen JSX text v sourceRoot. Pokud chcete přepnout do opt-in režimu, nastavte useDirective: true:

{
  useDirective: true,
}

V opt-in režimu se zpracovávají jen soubory, které začínají direktivou 'use i18n':

'use i18n';

export function Welcome() {
  return <h1>Welcome to our app</h1>;
  // This text IS translated
}

Soubory bez této direktivy se přeskočí:

export function InternalAdmin() {
  return <h1>Admin Dashboard</h1>;
  // This text is NOT translated
}

Kdy použít opt-in režim#

lingoDir#

Volba lingoDir mění umístění adresáře s metadaty:

{
  lingoDir: ".lingo",  // Default
  // or
  lingoDir: ".translations",  // Custom location
}

To se hodí, pokud je .lingo/ v konfliktu s existujícím adresářem ve vašem projektu.

Další kroky#