Podporované formáty

Lingo.dev CLI používá typy bucketů k parsování a překladu různých formátů souborů. Každý typ bucketu je samostatný parser navržený pro konkrétní formát. V souboru i18n.json si nastavte jeden nebo více bucketů a určete, které soubory má CLI překládat.

Typy bucketů#

Výstupní režimy#

Buckety fungují v jednom ze dvou výstupních režimů:

Samostatné soubory pro každý jazyk — CLI vytvoří samostatný soubor pro každý cílový jazyk. Vzory include musí obsahovat zástupný symbol [locale]:

{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"]
    }
  }
}

Tím vzniknou locales/en.json, locales/es.json, locales/fr.json atd.

Upravuje zdrojový soubor — CLI zapíše překlady zpět do stejného souboru, který obsahuje zdrojový obsah. Zástupný symbol [locale] se nepoužívá:

{
  "buckets": {
    "csv": {
      "include": ["translations.csv"]
    }
  }
}

Soubory CSV obvykle ukládají všechny jazyky do sloupců v rámci jednoho souboru. Podobně fungují i katalogy Xcode .xcstrings a YAML s kořenovými klíči.

Příklady konfigurace#

Webová aplikace s JSON#

{
  "buckets": {
    "json": {
      "include": ["src/locales/[locale].json"],
      "lockedKeys": ["brand/name"]
    }
  }
}

Dokumentační web s Markdown#

{
  "buckets": {
    "markdown": {
      "include": ["docs/[locale]/*.md"],
      "exclude": ["docs/[locale]/drafts/*.md"]
    }
  }
}

Mobilní aplikace (iOS + Android)#

{
  "buckets": {
    "xcode-xcstrings": {
      "include": ["ios/Localizable.xcstrings"]
    },
    "android": {
      "include": ["android/app/src/main/res/values-[locale]/strings.xml"]
    }
  }
}

Monorepo s více formáty#

{
  "buckets": {
    "json": {
      "include": ["apps/web/locales/[locale].json"]
    },
    "mdx": {
      "include": ["packages/docs/content/[locale]/*.mdx"]
    },
    "flutter": {
      "include": ["apps/mobile/lib/l10n/app_[locale].arb"]
    }
  }
}

Funkce specifické pro buckety#

Některé buckety podporují i další funkce nad rámec vzorů include/exclude:

Pravidla pro vzory include#

• Vzory jsou relativní k umístění souboru i18n.json
• Použijte [locale] jako zástupný symbol pro kódy jazyků (povinné pro buckety se „samostatnými soubory“)
• Hvězdička (*) odpovídá libovolnému názvu souboru: locales/[locale]/*.json
• Rekurzivní vzory (**) odpovídají souborům v libovolné hloubce: src/**/[locale].json, config/locales/**/[locale].yml. Když vzor používá **, node_modules, .git, dist, build, .next a .turbo jsou ve výchozím nastavení vyloučené — podle potřeby nad ně přidejte vlastní položky exclude (vyžaduje CLI 0.135.0+)
• Přípony souborů nemají na parsování vliv — parser určuje typ bucketu

Další kroky#