Lokalizace statického obsahu

Lingo.dev CLI překládá statické soubory ve vašem repozitáři – Markdown, MDX, Markdoc, JSON, YAML, titulky a další – přes nakonfigurovaný lokalizační engine. Stačí ho nasměrovat na váš obsah, spustit a přeložené soubory se objeví vedle zdrojových.

Podporované typy obsahu#

Předpoklady#

Každé spuštění CLI odesílá obsah přes lokalizační engine – konfiguraci, která určuje, jaký model LLM, glosář, hlas značky a instrukce se použijí. Vytvořte ho v dashboardu Lingo.dev a vygenerujte API klíč.

Dokumentační weby#

Většina dokumentačních frameworků organizuje přeložený obsah do adresářů podle jazyka. CLI buckety markdown, mdx a markdoc tyto soubory překládají se zachováním frontmatteru, bloků kódu i syntaxe komponent.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "markdown": {
      "include": ["docs/[locale]/getting-started.md"]
    },
    "mdx": {
      "include": ["docs/[locale]/setup.mdx"]
    }
  }
}

Upravte vzor include tak, aby odpovídal konvenci adresářů vašeho frameworku:

Strukturovaná data#

Soubory JSON a YAML se překládají pomocí bucketů json a yaml. Pomocí uzamčených klíčů zabráníte úpravám nepřeložitelných hodnot, jako jsou ID, URL nebo konfigurační příznaky.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "json": {
      "include": ["content/[locale].json"],
      "lockedKeys": ["id", "slug", "url"]
    },
    "yaml": {
      "include": ["data/[locale].yaml"]
    }
  }
}

U YAML souborů, které používají kód jazyka jako kořenový klíč (běžné v Rails a Hugo), použijte místo toho bucket yaml-root-key – čte ze zdrojového klíče jazyka a zapisuje do cílových klíčů jazyka v rámci stejného souboru.

Titulky#

Soubory s titulky ve formátech SRT a VTT se překládají pomocí bucketů srt a vtt. CLI zachovává všechny časové údaje, indexy cue i formátovací tagy – překládá se pouze textový obsah.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "srt": {
      "include": ["subs/[locale]/intro.srt"]
    }
  }
}

Práce s rozsáhlým obsahem#

Repozitáře se statickým obsahem mohou obsahovat tisíce souborů. CLI to zvládá efektivně díky třem mechanismům:

Další kroky#