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