Форматы CLI v0
Подберите структуру локалей для установленного парсера прежней версии и проверьте восстановленный файл в нативном формате.
Выбирайте группу файлов с учётом того, какие данные хотите извлечь и какие файлы ожидаете получить. В v0 парсер выбирается по типу группы. Расширение файла не меняет этот выбор. Поэтому для каталога JSON и каталога Xcode с несколькими локалями нужны разные настройки, даже если оба содержат сообщения.
Сначала выберите модель вывода #
Большинство групп записывают каждую локаль в отдельный файл с [locale] в пути. CSV, каталоги строк Xcode, словари JSON и блоки Vue i18n могут хранить несколько локалей в одном файле. Если результат записывается в общий файл, после перевода проверьте разделы целевой и исходной локалей.
| Группа файлов | Содержимое | Модель вывода по документации |
|---|---|---|
json, json5, jsonc | Варианты структурированного JSON | Отдельные файлы локалей |
json-dictionary | Значения JSON с объектами, где ключи — локали | Общий файл |
yaml | Каталог YAML | Отдельные файлы локалей |
yaml-root-key | YAML, вложенный в корневой ключ целевой локали | Отдельные файлы локалей |
markdown, mdx, markdoc | Документы семейства Markdown | Отдельные файлы локалей |
html, mjml | Разметка HTML и писем | Отдельные файлы локалей |
android | XML-ресурсы Android | Отдельные файлы локалей |
xcode-strings, xcode-stringsdict | Строковые ресурсы Apple и ресурсы форм множественного числа | Отдельные файлы локалей |
xcode-xcstrings | Каталог строк Xcode | Общий файл |
flutter | Каталог ARB | Отдельные файлы локалей |
po | Gettext PO | Отдельные файлы локалей |
properties | Файлы свойств Java | Отдельные файлы локалей |
csv | CSV с несколькими локалями | Общий файл |
csv-per-locale | Отдельный CSV для каждой локали | Отдельные файлы локалей |
xml, xliff | XML и XLIFF | Отдельные файлы локалей |
srt, vtt | Субтитры | Отдельные файлы локалей |
php | Массивы локализации PHP | Отдельные файлы локалей |
typescript | Данные локализации в TypeScript | Отдельные файлы локалей |
vue-json | JSON-блоки 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 один и тот же шаблон задаёт исходный файл и отдельные целевые файлы:
{
"buckets": {
"json": { "include": ["src/locales/[locale].json"] }
}
}Для общего каталога Xcode и ресурсов Android с отдельными файлами для каждой локали:
{
"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. Явно исключите и остальные сгенерированные данные:
{
"buckets": {
"markdown": {
"include": ["docs/[locale]/*.md"],
"exclude": ["docs/[locale]/drafts/*.md"]
}
}
}Для нескольких пакетов выберите общую конфигурацию или отдельную для каждого пакета с учётом языков и того, кому принадлежит движок локализации. Задавайте пути точнее, чтобы сгенерированные результаты случайно не попали в исходные данные.
Проверьте защитные механизмы формата #
Для каталогов с парами «ключ — значение» применяйте настройки ключей с учётом того, кто отвечает за каждое значение. Комментарии в JSONC и каталогах Xcode могут содержать примечания для переводчиков. В документах произвольной структуры и субтитрах эти возможности могут использоваться иначе.
Проверьте, что восстановил парсер: ключи и значения каталога, разметку и ссылки документа, временные метки субтитров или идентификаторы нативных ресурсов. Принимайте результат только после того, как убедитесь, что парсер или система сборки, для которых он предназначен, могут его обработать. При миграции сверяйтесь с актуальным руководством по форматам и списком форматов, поддерживаемых вызывающим инструментом. Не считайте, что эта таблица для прежней версии применима и к новой.