Примечания для переводчиков в CLI v0
Добавляйте контекст рядом с конкретным сообщением в устаревших файлах JSONC или каталогах Xcode и отдельно запускайте обновление нужного перевода.
В короткой подписи часто не хватает информации, нужной для перевода. Примечание помогает уточнить, о чём идёт речь, какое действие имеется в виду или какой тон нужен, не добавляя слов в интерфейс. В устаревшем рабочем процессе используйте комментарии JSONC или встроенные поля комментариев в каталогах Xcode, если они поддерживаются.
Добавьте недостающий контекст #
{
// 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:
{
"buckets": {
"jsonc": { "include": ["locales/[locale].jsonc"] }
}
}«Коллекция сохранённых медицинских записей» уточняет, о чём идёт речь, а «Текст, который видит пользователь» — нет. Примечание о расположении текста и тоне может объяснить, почему официальное уведомление отличается от подписи к действию. Если точное значение должно остаться неизменным, используйте настройку ключа, а не полагайтесь на примечание для переводчика.
Проверьте нужный перевод #
Если изменить только примечание, контрольная сумма исходного значения может остаться прежней. Запросите выборочный повторный перевод, если иначе установленная версия пропустит неизменённый текст. Прочитайте переведённую подпись в интерфейсе, где она используется, вместе с окружающим текстом.
Для XCStrings используйте встроенное поле комментария и сохраняйте структуру локалей общего каталога. Прежде чем рассчитывать, что другой набор файлов обрабатывает примечания так же, загляните в раздел устаревшие форматы. На эти устаревшие комментарии не распространяются правила работы с хешем и контекстом текущего каталога React.
Храните примечания для конкретного использования сообщения отдельно от глоссария, правил и стиля общения, общих для всего движка локализации. И примечания, и общие настройки могут отправляться на сервер, поэтому не включайте в них секреты или данные, которые вы не вправе раскрывать.