JSONC

Переводите каталоги с комментариями, используйте подсказки о контексте и узнайте, какие комментарии сохранятся в переводе.

JSONC позволяет хранить сообщение вместе с пояснением. Обработчик файлов jsonc читает комментарий перед строкой как подсказку для перевода и переводит вложенные строковые значения по тем же путям, что и JSON.

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

Размещайте контекст рядом с нужным значением #

В этом каталоге поясняется, что слово «Назад» предлагает сделать читателю:

jsonc
{
  /* @context Button that returns to the previous checkout step */
  "back": "Back",
  "product": "Acme",
}

Комментарий относится к следующему строковому значению, а не ко всем вложенным значениям объекта. Если между комментарием и строкой стоит число, логическое значение или null, подсказка сбрасывается. Размещайте комментарий прямо перед строкой, которую он описывает. Чтобы защитить фиксированные идентификаторы, используйте настройки выбранного интерфейса.

Если в комментарии есть @context, подсказкой становится оставшаяся часть этой строки. Если нет — весь комментарий. Поэтому любой непустой комментарий перед строкой попадёт к переводчику. Если перед строкой несколько комментариев, используется последняя непустая подсказка, даже если в одном из предыдущих комментариев есть @context. Отметка @orphan обозначает метаданные каталога, но строку всё равно можно выбрать при переводе файла.

Перевод файлов и каталоги React #

При извлечении сообщений React создаются плоские каталоги JSONC с метаданными у записей. Средство чтения каталогов распознаёт @context, @src и @orphan. При извлечении эти поля помогают поддерживать актуальные сведения о расположении сообщений в исходном коде и отмечать сообщения, которые больше не встречаются. Это рабочий процесс управления каталогом, отдельный от перевода произвольного документа JSONC.

При работе с извлечёнными сообщениями обращайтесь к разделу Каталоги и типы React. Не удаляйте метаданные из исходного каталога в расчёте на то, что обычный перевод файла создаст их заново.

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

CLI определяет jsonc по .jsonc, а GitHub App использует тип файла, указанный в конфигурации. Укажите исходные и целевые пути в разделе Конфигурация CLI или Конфигурация GitHub.

Сохраняйте нужные значения #

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

Проверьте ключи и защищённые значения в собранном файле, затем загрузите целевой файл через средство чтения каталогов приложения. В каталогах React сохраняйте исходные метаданные доступными для извлечения: переведённый целевой файл сохраняет @orphan, но не @context и @src.

Рабочий процесс перевода проверяет поддерживаемые структуры заполнителей и ICU, в том числе изменённые или отсутствующие аргументы. Изучите предупреждения и ошибки, затем отобразите прошедший проверку шаблон со значениями, которые передаёт приложение. Наряду со структурой проверяйте смысл и полноту перевода.