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