Ключи используются для идентификации переводимых текстовых Strings внутри программного кода. Это позволяет использовать ключ (в качестве кодового имени переводимой строки), на который Phrase может ссылаться только один раз вместо каждого необходимого перевода строки.
Ключ может иметь несколько связанных с ним переводов, каждый из которых соответствует разному языковому стандарту проекта. Функция аналогична функции основного ключа в реляционных базах данных, при этом переводы являются атрибутом ключа. Ключи хранятся в файлах оригинала и используются для идентификации языков исходника и перевода.
Использованные ключей позволяют платформам управления локализацией представлять переводимый текст переводчикам без необходимости предъявления кода.
Ключи обычно не нужно добавлять в проект, так как в идеале они создаются при загрузке файла ресурсов через вкладку « на странице проекта.
Чтобы предотвратить загрузку или создание ключей, используйте функцию блокирующих ключей. Если заблокированный ключ уже существует, его нельзя перевести в редакторе.
Чтобы исключить экспортируемых ключей, используйте функцию исключить ключей. Исключенные ключи также нельзя перевести в редакторе.
Ключи в проекте можно дублировать, выбрав «Еще/ Дублировать ключи» в разделе «» страницы проекта или в верхней части панели редактора Strings.
Для автоматизированного обновления контента можно связать разные ключи перевода с одинаковыми значениями в одном или нескольких проектах. Связанные ключи используются для обеспечения согласованности в различных проектах и исключения повторяющейся работы над одинаковым контентом.
Изменения в ключах можно отменить из окна активности на боковой панели в редакторе Strings.
Примечание
При работе с репозиториями (GitHub, GitLab и т. д.) и удалении ключей ключи необходимо удалять как из phrase, так и из хранилища, которое необходимо навсегда удалить. Это сделано для предотвращения случайного удаления ключей из-за ошибок или случайностей в phrase или хранилище.
В Strings ключи могут быть разных типов в зависимости от формата загруженного файла:
-
Строка (по умолчанию)
Примечание
Переводчики могут редактировать только ключи строк, если в дополнительных настройках проекта не включен параметр .
-
Множество
-
Булевский тип данных
-
Markdown
-
Число
Тип ключа отображается в разделе на боковой панели редактора.
Имена ключей должны быть уникальными в рамках одного проекта.
Существует несколько стратегий именования ключей:
-
Описательный
Исходный текст идентифицируется по функции. Это может затруднить идентификацию текста при чтении кода, но останется постоянной величиной.
Пример:
-
Strings оригинала (не рекомендуется)
Сам исходный текст используется в качестве ключа, упрощающего идентификацию используемого текста. Это проблематично, так как при изменении исходного текста это нарушает связь с переводами.
Пример:
Если ключи не загружены, их можно создать вручную.
Чтобы создать ключ, выполните следующие действия:
-
Во вкладке нажмите Добавить ключ.
Открывается окно Добавить ключ.
-
Во вкладке укажите , , любые доступные и .
-
При необходимости включите формы множественного числа на вкладке .
-
При необходимости выберите исключенные языки на вкладке .
-
При необходимости предоставьте технические сведения на вкладке .
Например, в окне «. Если этот параметр установлен, ограничение количества символов отображается индикатором в редакторе Strings при редактировании переводов соответствующего ключа.
-
Нажмите «Сохранить».
Ключ добавлен в проект и может быть просмотрен на вкладке .
Удаление ключа из редактора или вкладки приведет к удалению всех связанных переводов этого ключа и не может быть отменено.
В проектах с количеством ключей более 10 000 неупомянутые ключи не будут рассчитываться при дальнейших загрузках. Неупомянутые ключи — это ключи, которые не включены в текущую загрузить, но все еще существуют в проект
Блокировка предотвращает добавление целых ключей в проект. Если название заблокированного ключа отображается в загруженном файле, этот ключ пропускается и не добавляется в проект.
Блокировка используется, чтобы пропустить ключи в проекте, поэтому они вообще не управляются.
Типично заблокированные ключи:
-
Strings дат и формата времени.
-
Ключи, включая конфигурации.
-
Ключи, вызывающие проблемы при управлении с драгоценным камнем Phrase.
Управление заблокированными ключами в отдельном файле языка, который не обрабатывается и не поддерживается.
Эти ключи могут вызвать проблемы и в случае использования должны быть заблокированы при создании проекта.
-
activemodel.errors* -
number.format* -
number.curency* -
number.percentage* -
datetime.prompts*
Чтобы заблокировать ключ, выполните следующие действия:
-
На странице проекта выберите вкладку «».
-
Нажмите Добавить ключ в список заблокированных ключей.
Откроется окно заблокированных ключей.
-
Укажите имя ключа или регулярное выражение (regexp) и нажмите Сохранить.
Ключ добавлен в список.
Рекомендация
Чат-боты искусственного интеллекта (ИИ) могут быть очень эффективными в генерации и подтверждении регулярных выражений (regexp).
Используйте Инструменты типа Regex101 для проверки регулярных выражений с разными исходными данными.
Позже ключи можно изменить, нажав или удалив
.
Некоторые ключи могут потребовать исключения из определенных языков и могут быть помечены как исключенные. Эти ключи загружаются и существуют в проекте, но игнорируются.
Исключенные переводы:
-
Исключено экспортировать соответствующий язык.
-
Исключено из отчетов по смежным языкам.
Если контент empty, он не учитывается как не переведенный.
-
Видимый, но не поддающийся редактированию в редакторе переводов.
Параметры исключения:
-
Исключите один перевод на язык в редакторе переводов.
-
Исключите несколько переводов на язык в редакторе переводов.
-
Исключите несколько переводов, выбрав языки при создании или редактировании ключа.
Чтобы исключить ключ, выполните следующие действия:
-
На странице ключа нажмите «
» для ключа, требующего исключения.
Откроется окно «».
-
Выберите вкладку «.
-
Выберите языки для исключения.
-
Нажмите «Сохранить».
В указанном ключе выбор исключается.
Ключи также можно исключить индивидуально или в комплекте из списка ключей редактора, выбрав ключ(и) и используя меню «».