Поддерживаемые форматы

CLI Lingo.dev использует типы bucket для разбора и перевода файлов разных форматов. Каждый тип bucket — это отдельный парсер, созданный под конкретный формат. Настройте один или несколько bucket в i18n.json, чтобы указать, какие файлы должен переводить CLI.

Типы bucket#

Режимы вывода#

Bucket работают в одном из двух режимов вывода:

Отдельные файлы для каждой локали — CLI создаёт отдельный файл для каждого целевого языка. В шаблонах include должен быть плейсхолдер [locale]:

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

В результате появятся locales/en.json, locales/es.json, locales/fr.json и т. д.

Изменяет исходный файл — CLI записывает переводы в тот же файл, где находится исходный контент. Плейсхолдер [locale] в этом случае не используется:

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

В CSV-файлах все локали обычно хранятся в столбцах одного файла. Каталоги Xcode .xcstrings и YAML с корневыми ключами работают по тому же принципу.

Примеры конфигурации#

Веб-приложение с JSON#

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

Документационный сайт на Markdown#

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

Мобильное приложение (iOS + Android)#

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

Монорепозиторий с несколькими форматами#

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

Возможности отдельных bucket#

Некоторые bucket поддерживают дополнительные возможности помимо шаблонов include/exclude:

Правила шаблонов include#

• Шаблоны задаются относительно расположения файла i18n.json
• Используйте [locale] как плейсхолдер для кодов локалей (обязательно для bucket с режимом «отдельные файлы для каждой локали»)
• Звёздочка (*) соответствует любому имени файла: locales/[locale]/*.json
• Рекурсивные шаблоны (**) соответствуют файлам на любой глубине: src/**/[locale].json, config/locales/**/[locale].yml. Если шаблон использует **, то node_modules, .git, dist, build, .next и .turbo исключаются по умолчанию — при необходимости добавьте свои записи exclude (требуется CLI 0.135.0+)
• Расширения файлов не влияют на разбор — парсер определяется типом bucket

Что дальше#