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