Форматы CLI v0

Подберите структуру локалей для установленного парсера прежней версии и проверьте восстановленный файл в нативном формате.

Выбирайте группу файлов с учётом того, какие данные хотите извлечь и какие файлы ожидаете получить. В v0 парсер выбирается по типу группы. Расширение файла не меняет этот выбор. Поэтому для каталога JSON и каталога Xcode с несколькими локалями нужны разные настройки, даже если оба содержат сообщения.

Сначала выберите модель вывода #

Большинство групп записывают каждую локаль в отдельный файл с [locale] в пути. CSV, каталоги строк Xcode, словари JSON и блоки Vue i18n могут хранить несколько локалей в одном файле. Если результат записывается в общий файл, после перевода проверьте разделы целевой и исходной локалей.

Группа файловСодержимоеМодель вывода по документации
json, json5, jsoncВарианты структурированного JSONОтдельные файлы локалей
json-dictionaryЗначения JSON с объектами, где ключи — локалиОбщий файл
yamlКаталог YAMLОтдельные файлы локалей
yaml-root-keyYAML, вложенный в корневой ключ целевой локалиОтдельные файлы локалей
markdown, mdx, markdocДокументы семейства MarkdownОтдельные файлы локалей
html, mjmlРазметка HTML и писемОтдельные файлы локалей
androidXML-ресурсы AndroidОтдельные файлы локалей
xcode-strings, xcode-stringsdictСтроковые ресурсы Apple и ресурсы форм множественного числаОтдельные файлы локалей
xcode-xcstringsКаталог строк XcodeОбщий файл
flutterКаталог ARBОтдельные файлы локалей
poGettext POОтдельные файлы локалей
propertiesФайлы свойств JavaОтдельные файлы локалей
csvCSV с несколькими локалямиОбщий файл
csv-per-localeОтдельный CSV для каждой локалиОтдельные файлы локалей
xml, xliffXML и XLIFFОтдельные файлы локалей
srt, vttСубтитрыОтдельные файлы локалей
phpМассивы локализации PHPОтдельные файлы локалей
typescriptДанные локализации в TypeScriptОтдельные файлы локалей
vue-jsonJSON-блоки Vue i18n с локалями в качестве ключейОбщий файл
txtОбычный текстОтдельные файлы локалей

Здесь перечислены группы файлов прежней версии, а не форматы, совместимые с другими инструментами. В ранних выпусках v0 отдельные форматы могут отсутствовать. Парсеры TypeScript, PHP и Vue обрабатывают только поддерживаемые структуры локализации. Их наличие не означает, что можно произвольно переписывать исполняемый исходный код.

Диспетчер 0.138.10 также содержит ail, ejs, twig, dato и xcode-xcstrings-v2. Не меняйте парсер, который уже используется в установленном проекте, пока не проверите его входные и выходные данные. Одного значения в перечислении схемы недостаточно: в схеме прежней версии также указан compiler, но в этой ветке диспетчеризации для него нет загрузчика.

yaml-root-key восстанавливает только корневой раздел выбранной локали. Не указывайте один и тот же общий YAML-файл для источника и результата: при записи остальные корневые разделы могут быть перезаписаны. Используйте путь для конкретной локали, например locales/[locale].yml. В отличие от этого, словарь JSON или блок Vue явно объединяет новую локаль с исходной структурой.

Настройте типовой файл #

Для JSON один и тот же шаблон задаёт исходный файл и отдельные целевые файлы:

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

Для общего каталога Xcode и ресурсов Android с отдельными файлами для каждой локали:

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

Адаптируйте обозначения локалей Android и каталоги ресурсов под приложение. После первого запуска проверьте оба нативных формата с помощью соответствующих инструментов сборки и убедитесь, что приложение загружает выбранную целевую локаль. Если конфигурация принята, это ещё не значит, что путь работает.

Настройте поиск файлов без сгенерированных результатов #

Пути отсчитываются от i18n.json. Шаблон * ищет совпадения в пределах одного уровня. Рекурсивный шаблон ** появился в 0.135.0. По умолчанию он исключает node_modules, .git, dist, build, .next и .turbo. Явно исключите и остальные сгенерированные данные:

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

Для нескольких пакетов выберите общую конфигурацию или отдельную для каждого пакета с учётом языков и того, кому принадлежит движок локализации. Задавайте пути точнее, чтобы сгенерированные результаты случайно не попали в исходные данные.

Проверьте защитные механизмы формата #

Для каталогов с парами «ключ — значение» применяйте настройки ключей с учётом того, кто отвечает за каждое значение. Комментарии в JSONC и каталогах Xcode могут содержать примечания для переводчиков. В документах произвольной структуры и субтитрах эти возможности могут использоваться иначе.

Проверьте, что восстановил парсер: ключи и значения каталога, разметку и ссылки документа, временные метки субтитров или идентификаторы нативных ресурсов. Принимайте результат только после того, как убедитесь, что парсер или система сборки, для которых он предназначен, могут его обработать. При миграции сверяйтесь с актуальным руководством по форматам и списком форматов, поддерживаемых вызывающим инструментом. Не считайте, что эта таблица для прежней версии применима и к новой.