-
планов Advanced и Enterprise (устаревшая версия)
Свяжитесь с отделом продаж по вопросам лицензирования.
Рекомендации
Информацию об интеграции Figma в Phrase TMS см. в разделе Figma (TMS).
Плагин Figma позволяет интегрировать контент дизайна с проектами Phrase, устраняя разрыв между командами по разработке продукта и локализации. Плагин поддерживает отправку контента, получение переводов и управление ключами между Figma и Phrase Strings.
-
Ветвление поддерживается.
-
Требуется получить доступ как минимум к одному проекту и одному языку с правами пользователя «переводчик». Получить доступ можно, получив приглашение, отправленное администратором или менеджером проекта.
-
Плагин будет отправлять скриншоты фреймов с авто-лейаутом, которые не являются дочерними элементами.
-
По умолчанию скрытые текстовые слои не включаются в интеграцию. Это можно изменить в настройках
, выбрав .
-
По умолчанию выбранные теги в плагине очищаются после процесса отправки. Это можно изменить в настройках
-
Любые изменения, внесенные в настройки
Чтобы запустить плагин, выберите его в браузере плагинов Figma или в Figma Community и нажмите Try it out. Плагин станет доступен в меню Figma.
Подключение Figma к Phrase можно выполнить с помощью учетных данных Phrase, токена или единого входа в систему (SSO).
Чтобы войти с помощью единого входа в систему (SSO):
-
На экране входа в плагин выберите Sign in with SSO.
-
Введите идентификатор организации.
-
Завершите вход во вкладке браузера, которая откроется.
Вернитесь в плагин после аутентификации.
После установки соединения выбор фрейма загружает предварительный просмотр контента Figma и ключей, которые пользователи могут отправлять в Phrase Strings или получать из них.
Вкладка позволит подключить слои Figma к ключам, уже существующим в проект Strings. Если соглашение об именовании одинаково как для слоев, так и для ключей, они могут быть сопоставлены автоматически.
Плагин доступен через специальные кнопки на боковой панели Figma:
-
Phrase Strings
Нажмите, чтобы открыть плагин.
-
Просмотреть текст в Strings
Отображается в файлах Figma, подключенных к проекту Strings. Нажмите, чтобы открыть соответствующий проект в «редакторе переводов».
Вкладка позволяет отправлять фреймы или текстовые слои из Figma в Phrase Strings для локализации. Невозможно отправить контент в защищенную основную ветвь.
Выберите проект, ветвь (если используется) и язык для отправляемого контента. При необходимости введите пользовательский тег, чтобы добавить его к загруженным ключам.
Пустые или дублирующиеся имена ключей помечаются красным счетчиком в столбце . Для управления длинными списками имен ключей используйте раскрывающийся список , чтобы отобразить или .
Примечание
Выбранный параметр сортировки будет сохранен для будущих сеансов.
Кнопка Отправить в Phrase отключается, если поля имен ключей пусты, содержат недопустимые символы или не являются уникальными при выборе защищенной основной ветви.
Выберите настройку , чтобы редактировать поля имен ключей и устранить любые конфликты имен. При необходимости выберите нужные ключи и нажмите Exclude layers в верхней части таблицы, чтобы удалить эти слои из плагина.
Если есть несвязанные слои с конфликтующими именами ключей, выберите один из доступных вариантов разрешения, чтобы продолжить:
-
Создает новые ключи с суффиксом
-copy. -
Связывает слои с существующими ключами Phrase.
-
Отправляет только неконфликтующие слои.
Когда включена опция Upload Figma preview:
-
Пользователи могут при желании выбрать, какие целевые языки включить в предварительный просмотр Figma. Если языки не выбраны, по умолчанию включаются все языки.
-
Плагин создает одно задание для каждого корневого фрейма (или компонента верхнего уровня), включенного в отправку. Отправка всей страницы Figma с множеством фреймов верхнего уровня приведет к созданию соответствующего большого количества заданий. Чтобы количество заданий соответствовало фактическому объему работы по переводу, перед отправкой выбирайте только те фреймы, которые содержат новый или обновленный контент.
Если слои успешно отправлены в Strings, отображается окно со сводкой и следующими параметрами:
-
Создать задание
Нажмите, чтобы открыть страницу с предварительно выбранными отправленными ключами.
Важно
Если включена опция Upload Figma preview, задание в Strings создаётся автоматически. После включения эту функцию нельзя будет отключить.
-
Открыть в Strings
Нажмите, чтобы просмотреть отправленные ключи в Strings Editor.
Желтый значок предупреждения появляется рядом с ключами, имена которых были изменены в Strings после отправки контента. Чтобы обновить имена ключей в плагине Figma, выберите Sync key name в меню с многоточием
рядом с несовпадающим именем ключа.
Параметры и действия отправки
Нажмите меню , чтобы при необходимости включить или выключить следующие параметры отправки:
-
Upload screenshots включено по умолчанию. Это позволяет прикрепить скриншот выбранных слоев внутри фрейма:
-
Если настройка включена, скрытые текстовые слои, импортированные с помощью плагина Figma, будут отмечены маркером в верхнем левом углу скриншота.
-
Когда настройка включена, скриншоты Figma разделов не будут создаваться.
Рекомендуется оставить эту опцию включенной в случае возникновения проблем с производительностью плагина при работе внутри разделов.
-
Включите , чтобы ограничить каждый скриншот ближайшим содержащим фреймом, компонентом, экземпляром или разделом вокруг текстового слоя, вместо самого внешнего родительского элемента верхнего уровня. Все текстовые слои внутри этого контейнера получают маркеры, включая слои вне текущего выбора.
Эта опция по умолчанию выключена. Используйте ее, когда недостаточно ограничивает захват конкретным вложенным фреймом, что приводит к созданию слишком больших скриншотов с низким контекстом.
-
-
Update content in Phrase Strings включено по умолчанию.
-
Update key names in Phrase Strings включено по умолчанию, если настройка не отключена.
Отключение этой опции сбрасывает все введенные имена ключей.
-
Включите Upload Figma preview, чтобы экспортировать HTML-пакет из выбранных ключей.
Эта опция необходима для создания in-context preview в CAT Editor при работе с jobs synced из Strings.
Пользователи могут дополнительно выбрать, какие языки перевода включить в предварительный просмотр Figma при отправке контента. Если языки не выбраны, по умолчанию включаются все языки.
Если предварительный просмотр успешно создан, в Strings автоматически создается задание. Любая активная автоматизация заданий в проекте Strings будет пропущена во избежание создания дубликатов заданий.
Если предварительный просмотр превышает лимит в 10 МБ, ключи все равно отправляются в Strings, но задание с предварительным просмотром не создается.
Примечание
Для работы с предварительным просмотром Figma в «Strings Editor» используйте действие Добавить предварительный просмотр Figma на контекстной боковой панели.
-
Включите Сохранить форматирование и стиль контента, чтобы сохранить форматирование расширенного текста (например, списки, разрывы строк, полужирный/курсив и ссылки) при отправке контента из Figma в Phrase и получении переводов обратно.
Если опция включена, HTML-теги форматирования автоматически добавляются для сохранения встроенного стиля и поддерживаются в контекстном предварительном просмотре TMS при работе с jobs synced из Strings. Теги HTML-форматирования отображаются в «Strings Editor» и в экспортированных переводах, возвращённых в Figma.
Отключите эту опцию, если форматирование не требуется, чтобы избежать ручных корректировок.
Эта настройка применяется на уровне файла и затрагивает всех соавторов, работающих с файлом. Эта опция запоминается для новых файлов.
Для связанных слоев в соответствующем меню с многоточием доступны следующие действия:
-
Выберите Просмотреть детали ключа, чтобы просмотреть/отредактировать описание ключа в Phrase Strings или установить ограничение на количество символов для ключа. Любые изменения, сохраненные в окне , появятся на боковой панели Strings Editor после обновления страницы редактора.
Рекомендации
Выберите несколько ключей на вкладке и используйте пакетное действие Установить ограничение символов, чтобы установить ограничение на количество символов для всех выбранных ключей одновременно.
-
Выберите Открыть ключ в редакторе, чтобы перейти к соответствующему ключу в «Strings Editor».
-
Выберите Отключить контент от Phrase Strings, чтобы отсоединить слой от существующего ключа.
Управление дублированным контентом
При отправке контента слои с дублированным контентом создадут в «Strings» несколько ключей, содержащих одинаковый текст. Пользователи могут решить, как управлять этим дублированным контентом в окне «Отправить контент в Phrase»:
-
Выберите «Продолжить без объединения», если создание нескольких ключей с дублированным контентом является намеренным.
-
Чтобы объединить дублирующийся контент в один ключ, выполните следующие действия:
-
Выберите два или более ключа из списка и нажмите «Объединить в ключ...».
Отобразится выпадающий список с доступными ключами для объединения.
-
Выберите ключ, в который нужно объединить дублирующийся контент.
Выбранный ключ помечается синим значком объединения
в окне «Push content to Phrase».
-
Нажмите «Proceed», затем подтвердите выбор, нажав «Merge and Push» во всплывающем окне «Merge duplicated content».
Дублирующийся контент объединяется в один ключ, и все связанные слои подключаются к этому ключу.
-
-
Чтобы объединить часть или весь дублирующийся контент в первый ключ списка, выполните следующие действия:
-
Выберите несколько или все ключи из списка и нажмите «Объединить все дубликаты в первый ключ».
-
Нажмите «Proceed», затем подтвердите выбор, нажав «Merge and Push» во всплывающем окне «Merge duplicated content».
Дублирующийся контент объединяется в один ключ, и все связанные слои подключаются к этому ключу.
Эта опция полезна для больших файлов с множеством дубликатов, позволяя пользователям объединить все дубликаты в первый найденный ключ за одно действие, вместо того чтобы обрабатывать каждый из них по отдельности.
-
Дублирование фрейма или текстового слоя в Figma также дублирует любое существующее подключение к ключу Phrase Strings. Если дублированный слой используется повторно для нового, не связанного с предыдущим текстом, и отправляется без предварительного отключения, отправка обновляет исходный текст существующего ключа вместо создания нового. Обновление исходного текста ключа не очищает и не обновляет переводы на целевой язык, уже сохранённые для этого ключа, поэтому последующая выгрузка слоя возвращает перевод, связанный с предыдущим контентом, а не с только что отправленным текстом.
Перед отправкой контента из дублированного или повторно используемого фрейма или текстового слоя проверьте вкладку , чтобы подтвердить, подключен ли слой к какому-либо ключу. Если он подключен, а новый текст не связан с предыдущим контентом, сначала отключите слой, чтобы плагин создал новый ключ вместо перезаписи существующего.
Настройка Auto-exclude layers удаляет текстовые слои из вкладки «» на основе их префикса в названии. Если опция включена, любой слой с префиксом _ или . исключается автоматически.
По умолчанию настройка выключена и применяется для каждого файла отдельно. Она включена для всех именованных слоев в этом файле, пока ее не выключат.
Исключения сохраняются при выборе. Для компонентов, если слои компонента имеют префикс и включено Автоматически исключать слои, последующие дизайны, использующие этот компонент, наследуют исключение.
Чтобы автоматически исключить слои с префиксами из :
Раздел в настройках плагина позволяет настроить соглашение об именовании для подключенных ключей.
Чтобы настроить имена ключей в Figma, выполните следующие действия:
-
Нажмите Включить интеллектуальное именование ключей в настройках .
-
Выберите .
Примечание
Если включено, имена ключей генерируются автоматически на основе имен текстовых слоев.
-
В поле введите текст, чтобы задать собственное именование ключей:
-
При необходимости нажмите Доступные макросы, чтобы выбрать один из поддерживаемых макросов для автоматической генерации имен ключей.
Можно выбрать несколько макросов для составления имени ключа.
-
В поле можно комбинировать произвольный текст и макросы.
Нажмите Примеры, чтобы отобразить и выбрать один из предопределенных примеров.
-
-
При необходимости выберите вариант форматирования в раскрывающемся списке , чтобы соответствующим образом изменить текст и удалить пробелы.
При отправке контента в Phrase Strings примените созданное соглашение об именовании к ранее подключенным ключам одним из следующих способов:
-
Нажатие значка обновления
в нижней части таблицы.
-
Выбор конкретных ключей и нажатие Пересоздать имена ключей в верхней части таблицы.
Доступные макросы
|
Макросы |
Описание |
|---|---|
|
{file_name} |
Название файла Figma |
|
{page} |
Страница Figma, на которой идентифицирован ключ |
|
{parent_section} |
Раздел самого высокого уровня в дереве страниц |
|
{nearest_section} |
Раздел, ближайший к текстовому слою в дереве страниц |
|
{frame} |
Фрейм, в котором идентифицирован ключ |
|
{parent_group} |
Группа самого высокого уровня в дереве страниц |
|
{nearest_group} |
Группа, ближайшая к текстовому слою в дереве страниц |
|
{component} |
Имя компонента Figma, в котором расположен ключ. Учитываются только компоненты-оригиналы. |
|
{element_name} |
Имя текстового слоя |
|
{element_content} |
Контент из текстового слоя |
|
{random} |
Случайно сгенерированный уникальный короткий хеш |
При отправке контента пользователи могут связывать слои с существующими ключами в Phrase Strings или создавать новые.
Выберите вкладку для отображения обзора связанных и отвязанных ключей.
Ключи, которые уже связаны, отмечены значком ссылки в столбце . При необходимости выберите проект, ветвь (если используется) и язык или нажмите значок поиска, чтобы найти нужный контент.
Выберите Connect keys, чтобы массово связать все несвязанные ключи на вкладке. Чтобы связать или отвязать отдельные ключи, нажмите соответствующий значок справа от нужной записи.
Примечание
Опция отвязки отдельных ключей также доступна на вкладке .
В новом виде текстовые слои из текущего выбора перечислены со статусом их связи в одной таблице, заменяя предыдущий список на основе ключей.
Примечание
Перезапустите плагин перед включением бета-версии, чтобы убедиться, что загружена последняя версия.
Чтобы включить «New connect view»:
-
Откройте плагин и нажмите значок «Settings».
-
В разделе «Plugin settings» включите «Use new connect view (Beta)».
-
Откройте «Connect keys», чтобы увидеть список связанного контента.
Предыдущий вид «Connect» остается доступным. Отключите «Use new connect view» в настройках плагина, чтобы вернуться к предыдущему.
Чтобы подключить один слой, выберите его, чтобы открыть окно с двумя вкладками:
-
Предложения: отображает ключи с точным совпадением имен и ключи с совпадающим контентом перевода.
-
Поиск: поиск всех ключей по имени или контенту.
Чтобы выполнить действие с несколькими слоями, выберите их, чтобы отобразить панель пакетных действий:
-
Подключить по имени ключа: подключает слои к ключам с точным совпадением имен.
-
Подключить по контенту: подключает слои к ключам с совпадающим контентом перевода
-
Отключить слои: удаляет подключения от выбранных слоев.
Пропускать слои с несколькими совпадающими ключами
Переключатель Пропускать слои с несколькими совпадающими ключами управляет тем, как обрабатывает слои, текст которых совпадает с более чем одним ключом.
Чтобы включить переключатель:
-
Откройте плагин и перейдите на вкладку .
-
Нажмите
в навигации, чтобы открыть параметры вида.
-
Включить .
Если этот параметр включен, любой слой, соответствующий более чем одному ключу, пропускается во время и остается неподключенным для ручной проверки.
Сводка после действия
После каждого пакетного запуска «Подключить по контенту» или «Подключить по имени ключа» в окне результатов отображается итог:
-
Количество подключенных
-
Пропущено — совпадений не найдено
-
Пропущено — несколько совпадений (отображается, когда включена настройка «Пропускать слои с несколькими совпадающими ключами»)
Нажмите Показать неподключенные слои, чтобы отфильтровать таблицу и оставить слои, которые все еще требуют внимания, или Завершить, чтобы закрыть окно результатов.
Пометка текстового слоя как ключа множественного числа связывает его с формами множественного числа этого ключа в Phrase Strings. Для ключа множественного числа в столбце вместо контента ключа отображается раскрывающийся список выбора формы, в котором перечислены формы, доступные для выбранного языка, например one и other. Языки с более сложными правилами множественного числа, такие как польский, имеют до пяти форм.
Раскрывающийся список появляется как на вкладке , так и на вкладке .
Для предварительного просмотра формы множественного числа на холсте:
-
В таблице контента найдите ключ множественного числа.
-
Нажмите на раскрывающийся список выбора формы в столбце и выберите форму множественного числа для предварительного просмотра.
-
Phrase Strings извлекает соответствующий перевод в слой для предварительного просмотра на холсте.
Отправка ключа множественного числа в Phrase Strings выполняется по тому же рабочему процессу, что и для любого другого ключа, и обновляет только перевод для выбранной формы.
Выбранная форма множественного числа запоминается для каждого слоя, проекта и ветви. Выбор сохраняется между сеансами.
После того как переводы будут завершены, выберите слои или фреймы Figma, для которых нужно получить переводы, и перейдите на вкладку .
Пользователи могут выбрать проект, ветвь (если она используется), и языки для извлекаемого контента. Теги нельзя вернуть в Figma.
Чтобы управлять длинными списками имен ключей, используйте раскрывающийся список , чтобы отобразить и устранить любые потенциальные проблемы. При необходимости выберите определенные ключи и нажмите Исключить слои в верхней части таблицы, чтобы удалить эти слои из плагина.
Примечание
Выбранный параметр сортировки будет сохранен для будущих сеансов.
Нажмите меню , чтобы выбрать способ отображения извлеченного контента в Figma:
-
Выбрано по умолчанию. При извлечении для нескольких языков для каждого выбранного языка создается отдельная страница Figma, включающая все слои со страницы.
Примечание
В Figma Buzz отображается опция .
-
Создает одну новую страницу и размещает выбранный переведенный контент рядом в столбцах для каждого языка. Эта опция фокусируется только на активном выделении, а не дублирует всю страницу Figma.
Рекомендуется для больших файлов, чтобы повысить производительность извлечения и уменьшить ненужный размер файла.
-
Выбранные текстовые слои будут заменены переводами и обновлены в окне просмотра.
Эта опция автоматически отключается при извлечении для нескольких языков.
-
Отключено по умолчанию. Если включено:
-
Названия ключей получаются и отображаются вместо переведенного контента.
-
Выбор языка для извлеченного контента больше невозможен.
-
-
Этот параметр будет сохранен для будущих сеансов.
-
Если отключено, в столбце отображается контент выбранных слоев напрямую.
-
Если эта функция включена, в столбце отображается предварительный просмотр контента на выбранном языке для подключенных слоев.
-
Для отключенных слоев включите параметр , чтобы отобразить предварительный просмотр на выбранном языке. Если в полученных данных есть ключ с таким же именем, контент этого ключа используется в качестве предварительного просмотра.
-
Эта опция автоматически отключается при извлечении для нескольких языков.
-
-
Управляйте тем, как обрабатываются отключенные слои при получении данных в Figma. Этот параметр будет сохранен для будущих сеансов.
-
Если эта функция включена, система проверяет, существует ли в полученных данных ключ с таким же именем.
Если найдено совпадение:
-
Отключенные слои подключаются к соответствующим ключам.
-
Содержимое слоев обновляется содержимым, полученным из существующих ключей.
-
-
Если эта функция отключена, отключенные слои не обновляются, даже если в полученных данных есть совпадающие ключи.
-
Проверить статус перевода
Функция «Проверить статус перевода» позволяет определить, есть ли у текстовых слоев в текущем выделении переводы для выбранных языков перевода, перед тем как загружать контент в Figma. Проверка выполняется для всех связанных ключей в выделении.
Чтобы проверить статус перевода
-
На вкладке выберите языки перевода для проверки.
-
Нажмите кнопку Проверить статус перевода.
На странице отображается количество переведенных, частично переведенных и непереведенных ключей на каждом языке для текущего выделения.
Нажмите Просмотреть детали рядом с языком, чтобы открыть список связанных ключей для этого языка. Используйте фильтры , и , чтобы сузить список.
Если контент успешно получен в Figma, отображается окно со сводкой обновленных слоев.
При получении для нескольких языков кнопка открывает ключ, где в качестве оригинала используется язык проекта по умолчанию.
Примечание
Если шрифт, используемый в дизайне, не установлен локально, плагин не может обновить затронутые текстовые слои полученными переводами. Когда это происходит, отображается ошибка «Шрифт [X] не удалось загрузить», где [X] — это название отсутствующего шрифта. Установите локально все шрифты, указанные в этом сообщении об ошибке, а затем снова получите контент.
Figma Buzz — это инструмент, с помощью которого бренд-дизайнеры и маркетинговые команды могут создавать брендовые визуальные активы в масштабе, непосредственно в экосистеме Figma. Он включает в себя систему шаблонов, упрощенный редактор дизайна, массовое создание активов и редактирование с помощью искусственного интеллекта (ИИ).
Плагин Phrase Strings для Buzz позволяет локализовать текстовый контент непосредственно в Buzz, предоставляя те же возможности, что и в интеграции Figma Design:
-
Отправить оригинал текста из дизайнов Buzz в Strings
-
Получить перевод обратно в Buzz
-
Управление ключами и поддержание согласованности текста в разных активах
Примечание
Предварительный просмотр в реальном времени не поддерживается.
Плагин доступен в меню в Buzz. После активации его можно сохранить для будущего использования и запустить для выбранного дизайна, открыв его в модальном окне на боковой панели Figma Buzz. Текстовые слои автоматически обнаруживаются и отображаются в плагине.
Контент дизайна затем можно отправить в подключенный проект Strings для перевода. После перевода пользователи могут получить локализованный контент обратно в Buzz, что создаёт новую строку, содержащую переведенную версию дизайна.
Переключатель и выбор языка перевода перед отправкой ключей в Buzz недоступны. При отправке ключей из Buzz все языки перевода, настроенные в проекте Strings, используются автоматически.