Примечания для переводчиков в CLI v0

Добавляйте контекст рядом с конкретным сообщением в устаревших файлах JSONC или каталогах Xcode и отдельно запускайте обновление нужного перевода.

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

Добавьте недостающий контекст #

jsonc
{
  // Patient medical records, not music recordings
  "records": "Records",
  // Button that submits the form; use a short action label
  "submit": "Submit",
  // Visual theme, not weight
  "theme.light": "Light"
}

Выберите парсер с поддержкой комментариев в i18n.json:

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

«Коллекция сохранённых медицинских записей» уточняет, о чём идёт речь, а «Текст, который видит пользователь» — нет. Примечание о расположении текста и тоне может объяснить, почему официальное уведомление отличается от подписи к действию. Если точное значение должно остаться неизменным, используйте настройку ключа, а не полагайтесь на примечание для переводчика.

Проверьте нужный перевод #

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

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

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