Локализация статического контента

Lingo.dev CLI переводит статические файлы в вашем репозитории — Markdown, MDX, Markdoc, JSON, YAML, субтитры и многое другое — через настроенный движок локализации. Просто укажите путь к контенту, запустите команду один раз и получите переведённые файлы рядом с исходниками.

Поддерживаемые типы контента#

Что понадобится#

При каждом запуске CLI контент проходит через движок локализации — конфигурацию, которая определяет, какая модель LLM, глоссарий, тональность бренда и инструкции будут использоваться. Создайте её в панели Lingo.dev и сгенерируйте API-ключ.

Сайты с документацией#

Большинство фреймворков для документации размещают переведённый контент по отдельным каталогам для каждой локали. Бакеты CLI markdown, mdx и markdoc переводят такие файлы, сохраняя frontmatter, блоки кода и синтаксис компонентов.

{
  "$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"]
    }
  }
}

Подстройте шаблон include под принятую в вашем фреймворке структуру каталогов:

Структурированные данные#

Файлы JSON и YAML переводятся через бакеты json и yaml. Используйте заблокированные ключи, чтобы не изменять непереводимые значения, такие как ID, URL и флаги конфигурации.

{
  "$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"]
    }
  }
}

Для YAML-файлов, где код локали используется как корневой ключ, что часто встречается в Rails и Hugo, используйте вместо этого бакет yaml-root-key — он читает данные из ключа исходной локали и записывает их в ключи целевых локалей в том же файле.

Субтитры#

Файлы субтитров SRT и VTT переводятся через бакеты srt и vtt. CLI сохраняет все временные метки, индексы реплик и теги форматирования — переводится только текст.

{
  "$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"]
    }
  }
}

Работа с большим объёмом контента#

Репозитории со статическим контентом могут содержать тысячи файлов. CLI эффективно справляется с этим благодаря трём механизмам:

Что дальше#