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