Интеграции

Figma (Strings)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Доступно для

  • всех платных планов

Доступно для

  • планов Advanced и Enterprise (устаревшая версия)

Свяжитесь с отделом продаж по вопросам лицензирования.

Рекомендации

Для получения информации об интеграция Figma в Phrase TMS обратитесь к Figma (TMS).

Плагин Figma позволяет интегрировать контент дизайна с проектами Phrase, устраняя разрыв между командами дизайна продукта и локализации. Плагин поддерживает отправку контент, получение переводов и управление ключами между Figma и Phrase Strings.

  • ветвление поддерживается.

  • Требуется получить доступ как минимум к одному проект и одному язык с правами пользователь переводчик. Получить доступ можно, получив invitation, отправленное администратор или менеджер проекта.

  • Плагин будет отправлять скриншоты фреймов с авто-лейаутом, которые не являются дочерний элемент.

  • По умолчанию скрытые текстовые слои не включены в интеграция. Это можно изменить в настройки Setup_gear.png, выбрав Include hidden layers or frames in selection.

  • По умолчанию выбранные теги в плагин очищаются после процесса отправки. Это можно изменить в настройки Setup_gear.png, отключив опцию Clear tags after push.

  • Любые изменения, внесенные в настройки Setup_gear.png по умолчанию для плагин, будут сохранены и останутся постоянными.

Установите и подключите плагин Figma

Чтобы запустить плагин, Выбрать его из браузера плагин в Figma или из Figma Community и нажмите Try it out. Плагин станет доступен в меню Plugins Figma.

Подключение из Figma к Phrase может быть выполнено с помощью учетные данные Phrase, токен или единый вход в систему (SSO).

Чтобы войти с помощью единый вход в систему (SSO):

  1. На экране входа в плагин выберите Sign in with SSO.

  2. Введите Идентификатор организации.

  3. Завершить вход во вкладка браузера, которая откроется.

    Вернитесь в плагин, уже пройдя аутентификацию.

Когда соединение установлено, выбор фрейма загружает предварительный просмотр контент Figma и ключ, которые пользователи могут отправлять в Phrase Strings или получать из них.

Вкладка Подключить ключ позволит подключать слои Figma к ключ, уже существующим в проект Strings проект. Если соглашение об именовании одинаково как для слоев, так и для ключ, их можно сопоставить автоматически.

Плагин доступен через специальные кнопки на боковой панели Figma:

  • Phrase Strings

    Нажмите, чтобы открыть плагин.

  • Просмотреть текст в Strings

    Отображается в файлах Figma, подключенных к проект Strings. Нажмите, чтобы открыть соответствующий проект в редактор переводов.

Отправить контент

Вкладка Отправить контент в Phrase позволяет отправлять фреймы или текстовые слои из Figma в Phrase Strings для локализации. Невозможно отправить контент в защищенную основную ветвь.

Выбрать проект, ветвь (если используется) и язык для отправляемого контент. При необходимости введите Пользовательский тег, чтобы добавить его к загруженным ключ.

Пустой или дублирующиеся имена ключ помечаются красным счетчиком в столбце Контент. Для управления длинными списками имен ключ используйте раскрывающийся список Сортировать по Sort Filter, чтобы отобразить Сначала неполные имена ключ или Сначала дублирующиеся имена ключ.

Примечание

Выбранный параметр сортировки будет запомнен для будущих сеансов.

Кнопка Отправить в Phrase отключена, если поля ввода имен ключ пустой, содержат недопустимые символы или не являются уникальными при выборе защищенной основной ветвь.

Выберите настройку Работа с именами ключ, чтобы Редактировать поля ввода имен ключ и устранить любые конфликты именования. При необходимости Выбрать нужные ключ и нажмите Exclude layers в верхней части таблицы, чтобы удалить эти слои из плагин.

Если есть несвязанные слои с конфликтующими именами ключ, Выбрать один из доступных вариантов разрешения, чтобы продолжить:

  • Create key copies in Phrase Strings

    Создает новые ключ с суффиксом -copy.

  • Connect with existing keys

    Связывает слои с существующими ключ Phrase.

  • Don't push conflicting keys

    Отправляет только неконфликтующие слои.

Когда включена опция Upload Figma preview:

  • Пользователи могут при необходимости Выбрать, какие перевод языки включить в Figma предварительный просмотр. Если языки не выбраны, по умолчанию включаются все языки.

  • Плагин создает одно задание для каждого корневого фрейма (или компонента верхнего уровня), включенного в отправку. Отправка всей страницы Figma со множеством фреймов верхнего уровня приведет к созданию соответствующего большого количества задание. Чтобы количество задание соответствовало фактическому объему работа по перевод, перед отправкой Выбрать только те фреймы, которые содержат новый или обновленный контент.

Если слои успешно отправлены в Strings, отображается окно Push completed со сводкой и следующими параметрами:

  • Create job

    Нажмите, чтобы открыть страницу Create a job с предварительно выбранными отправленными ключ.

    Важно

    Если включена опция Upload Figma preview, задание автоматически создается в Strings. После включения эту функцию нельзя отключить.

  • Open in Strings

    Нажмите, чтобы просмотреть отправленные ключи в Strings Editor.

Желтый значок предупреждение Warning появляется След. ключей, имена которых были изменены в Strings после отправки контент. Чтобы обновить имена ключ в Figma плагин, Выбрать Sync key name из меню многоточия More Menu След. несоответствующего имени ключ.

Параметры отправки и действия

Нажмите меню View options More Menu, чтобы при необходимости включить или выключить следующие параметры отправки:

  • Upload screenshots включено по умолчанию. Это позволяет прикрепить скриншот выбранных слоев внутри фрейма:

    • Если настройка Include hidden layers or frames in selection включена, скрытые текстовые слои, импортированные с помощью Figma плагин, будут иметь маркер, размещенный в верхнем левом углу скриншота.

    • Когда настройка Exclude sections from screenshots включена, скриншоты Figma разделов не будут создаваться.

      Рекомендуется оставить эту опцию включенной в случае возникновения проблем с производительностью плагина при работа внутри разделов.

    • Включить Capture only the closest screenshot, чтобы ограничить каждый скриншот ближайшим содержащим фреймом, компонентом, экземпляром или разделом вокруг текстового слоя, вместо самого внешнего родительского элемента верхнего уровня. Все текстовые слои внутри этого контейнера получают маркеры, включая слои вне текущего Выбрать.

      Эта опция выключена по умолчанию. Используйте ее, когда Exclude sections from screenshots недостаточно ограничивает захват конкретным вложенным фреймом, что приводит к созданию слишком больших скриншотов с низким контекстом.

  • Update content in Phrase Strings включено по умолчанию.

  • Update key names in Phrase Strings включено по умолчанию, если настройка Work with key names in Figma не выключена.

    Выключение этой опции сбрасывает все введенные значения ключ.

  • Включить 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 при работе с заданиями, синхронизированными из Strings. Теги форматирования HTML отображаются в Strings Editor и в экспортированных переводах, полученных обратно в Figma.

    Отключите эту опцию, если форматированный текст не нужен, чтобы избежать ручных корректировок.

    Настройка применяется на уровне файла и затрагивает всех соавторов, работающих с файлом. Эта опция запоминается для новых файлов.

Для связанных слоев в соответствующем меню с многоточием More Menu доступны следующие действия:

  • Выберите Просмотреть сведения о ключе, чтобы просмотреть/Редактировать описание ключа в Phrase Strings или установить ограничение на количество символов для ключа. Любые изменения, сохраненные в окне Сведения о ключе, появятся на боковой панели Strings Editor после обновления страницы редактора.

    Рекомендации

    Выберите несколько ключей на вкладке Отправить контент в Phrase и используйте пакетное действие Установить ограничение символов, чтобы установить ограничение на количество символов для всех выбранных ключей одновременно.

  • Выберите Открыть ключ в редакторе, чтобы перейти к соответствующему ключу в Strings Editor.

  • Выберите Отключить контент от Phrase Strings, чтобы отключить слой от существующего ключа.

Управление дублированным контентом

При отправке контента слои с дублированным контентом создадут в Strings несколько ключей, содержащих абсолютно одинаковый текст. Пользователи могут решить, как управлять этим дублированным контентом в окне Отправить контент в Phrase:

  • Выберите Продолжить без объединения, если создание нескольких ключей с дублированным контентом является намеренным.

  • Чтобы объединить некоторый дублированный контент в один ключ, выполните следующие действия:

    1. Выбрать два или более ключа из список и нажмите Merge объединить в ключ...

      Отображается выпадающий список с доступными ключами для объединения.

    2. Выбрать ключ, в который нужно объединить дублированный контент.

      Выбранный ключ отмечен синим значком объединить Merge to a Key в окне Push content to Phrase.

    3. Нажмите Proceed, затем подтвердить, выбрав Merge and Push во всплывающем окне Merge duplicated content.

      Дублированный контент объединить в один ключ, и все связанные слои подключаются к этому ключу.

  • Чтобы объединить некоторый или весь дублированный контент в первый ключ из список, выполните следующие действия:

    1. Выбрать несколько или все ключи из список и нажмите Merge объединить все дубликаты в первый ключ.

    2. Нажмите Proceed, затем подтвердить, выбрав Merge and Push во всплывающем окне Merge duplicated content.

      Дублированный контент объединить в один ключ, и все связанные слои подключаются к этому ключу.

    Эта опция полезна для больших файлов с множеством дубликатов, позволяя пользователям объединить все дубликаты в первый найденный ключ за одно действие, вместо того чтобы обрабатывать каждый из них по отдельности.

Автоматически Исключить слои

Настройка Автоматически Исключить слои удаляет текстовые слои из вкладка Push content to Phrase на основе их префикса имени. При включении любой слой с префиксом _ или . будет Исключить автоматически.

Настройка по умолчанию выключена и применяется для каждого файла. Она включена для всех именованных слоев в этом файле, пока не будет выключена.

Исключения сохраняются при выборе. Для компонентов, если слои компонента имеют префикс и включена настройка Автоматически Исключить слои, последующие дизайны, использующие этот компонент, наследуют это исключение.

Чтобы автоматически Исключить слои с префиксами из Push:

  1. В Figma добавьте префикс _ или . к текстовым слоям, которые нужно Исключить. Это также можно сделать в пакет.

  2. Откройте настройки плагина и Включить Auto-exclude layers.

Настройка именования ключ

Раздел Key naming в настройки плагина Setup_gear.png позволяет настроить соглашение об именовании для подключенных ключ.

Чтобы настроить имена ключ в Figma, выполните следующие действия:

  1. Нажмите Enable smart key naming в настройки Key naming.

  2. Выбрать Work with key names in Figma.

    Примечание

    Если Synchronize text layer names with keys включить, имена ключ автоматически генерируются на основе имен текстовых слоев.

  3. В поле Key name generation введите текст, чтобы определить Пользовательский именование ключ:

    • При желании нажмите Available macros, чтобы Выбрать один из supported macros для автоматической генерации имен ключ.

      Можно выбрать несколько макросов для составления имени ключ.

    • В поле Key name generation можно комбинировать произвольный текст и макросы.

      Нажмите Examples, чтобы отобразить и выбрать один из предопределенных примеров.

  4. При необходимости Выбрать вариант форматирования из выпадающего списка Formatting convention, чтобы соответствующим образом изменить текст и удалить пробелы.

При pushing content в Phrase Strings примените созданное соглашение об именовании к ранее подключенным ключ одним из следующих способов:

  • Нажав значок обновления Refresh List в нижней части таблицы.

  • Выбрать определенные ключ и нажав Regenerate key names в верхней части таблицы.

Доступные макросы

Макросы

Описание

{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 для отображения обзора подключенных и отключенных ключей.

Ключи, которые уже подключены, отмечены значком ссылки Connected Key в столбце Key name. При необходимости выберите проект, ветвь (если используется) и язык, или нажмите значок поиска, чтобы найти нужный контент.

Выберите Connect keys, чтобы массово подключить все неподключенные ключи на вкладке. Чтобы подключить или отключить отдельные ключи, нажмите соответствующий значок справа от нужной записи.

Примечание

Опция отключения отдельных ключей также доступна на вкладке Push content to Phrase.

Новый вид подключения (бета)

Новый вид отображает список текстовых слоев из текущего выбора с их статус подключения в одной таблице, заменяя предыдущий список на основе ключ.

Примечание

Перезапустите плагин перед тем, как Включить бета-версию, чтобы убедиться, что загружена последняя версия.

Чтобы Включить Новый вид подключения:

  1. Откройте плагин и нажмите на значок настройки.

  2. В разделе настройки плагин Включить использовать новый вид подключения (Бета).

  3. Откройте Подключить ключ, чтобы увидеть список подключенного контент.

Предыдущий вид подключения остается доступным. Отключить использовать новый вид подключения в настройки плагин, чтобы вернуться назад.

Чтобы подключить один слой, выберите его, чтобы открыть окно с двумя вкладками:

  • Предложения: отображает ключи с точным совпадением имен и ключи с совпадающим контент перевода.

  • Поиск: поиск всех ключей по имени или контент.

Чтобы выполнить действие с несколькими слоями, выберите их, чтобы открыть панель пакетных действий:

  • Подключить по имени ключа: подключает слои к ключам с точным совпадением имен.

  • Подключить по контент: подключает слои к ключам с совпадающим контент перевода

  • Отключить слои: удаляет подключения от выбранных слоев.

Пропускать слои с несколькими совпадающими ключами

Переключатель Пропускать слои с несколькими совпадающими ключами управляет тем, как Подключить по контент обрабатывает слои, текст которых совпадает с более чем одним ключом.

Чтобы Включить переключатель:

  1. Откройте плагин и перейдите на вкладка Подключить.

  2. Нажмите More Menu в навигации, чтобы открыть параметры просмотра.

  3. включить Skip layers with multiple matching keys.

Если включено, любой слой, имеющий совпадение с более чем одним ключ, пропускается во время Connect by content и остается неподключенным для ручной проверки.

Сводка после действия

После каждого запуска пакет Connect by content или Connect by key name в окне результатов отображается итог:

  • Количество подключенных

  • Пропущено — совпадение не найдено

  • Пропущено — несколько совпадение (отображается, когда включена опция Skip layers with multiple matching keys)

Нажмите Show unconnected layers, чтобы фильтровать таблицу по слоям, которые все еще требуют внимания, или Done, чтобы закрыть окно результатов.

Получить Переводы

После того как переводы будут Завершить, Выбрать слои или фреймы Figma, для которых нужно получить переводы, и нажмите на вкладку Pull content to Figma.

Пользователи могут Выбрать проект, ветвь (если используется) и языки для контент, который извлекается. Теги нельзя вернуть в Figma.

Чтобы управлять длинными списками имен ключ, используйте выпадающий список Sort by Sort Filter, чтобы сортировать Incomplete key names first и устранить любые потенциальные проблемы. При необходимости Выбрать конкретные ключ и нажмите Exclude layers в верхней части таблицы, чтобы удалить эти слои из плагин.

Примечание

Выбранный параметр сортировки будет запомнен для будущих сеансов.

Нажмите меню View options More Menu, чтобы выбрать способ отображения полученного контент в Figma:

  • Create a new page per language

    Выбрано по умолчанию. При извлечении для нескольких язык создается отдельная страница Figma для каждого выбранного язык, включая все слои со страницы.

    Примечание

    В Figma Buzz отображается опция Create a new row with translated content.

  • Создать одну страницу со всеми языками

    Создает одну новую страницу и размещает выбранный переведенный контент рядом в столбцах, соответствующих языку. Этот параметр фокусируется только на активном выделении, а не на дублировании всей страницы Figma.

    Рекомендуется для больших файлов, чтобы повысить производительность извлечения и уменьшить ненужный размер файла.

  • Заменить текстовые слои переводами

    Выбранные текстовые слои будут заменены переводами и обновлены в окне просмотра.

    Этот параметр автоматически отключается при извлечении для нескольких языков.

  • Отображать имена ключей вместо контента

    Отключено по умолчанию. При включении:

    • Ключи извлекаются и отображаются вместо переведенного контента.

    • Выбор языка для извлеченного контента больше невозможен.

  • Предварительный просмотр контента на выбранном языке

    Этот параметр будет сохранен для будущих сеансов.

    • Если параметр отключен, в столбце Контент отображается контент выбранных слоев напрямую.

    • При включении в столбце Контент отображается предварительный просмотр контента на выбранном языке для подключенных слоев.

      • Для неподключенных слоев включите параметр Connect with existing keys, чтобы отобразить предварительный просмотр на выбранном языке. Если в извлеченных данных существует ключ с таким же именем, контент этого ключа используется в качестве предварительного просмотра.

    Этот параметр автоматически отключается при извлечении для нескольких языков.

  • Connect with existing keys

    Управляйте тем, как обрабатываются неподключенные слои при извлечении данных в Figma. Этот параметр будет сохранен для будущих сеансов.

    • При включении система проверяет, существует ли в извлеченных данных ключ с таким же именем.

      Если найдено совпадение:

      • Отключенные слои подключаются к соответствующим ключам.

      • Контент слоев обновляется с помощью контента, полученного из существующих ключей.

    • Если эта функция отключена, отключенные слои не обновляются, даже если в полученных данных существуют соответствующие ключи.

Если контент успешно получен в Figma, отображается окно Pull completed со сводкой обновленных слоев.

При получении данных для нескольких языков кнопка Open key in Editor открывает ключ, где язык оригинала — это язык проекта по умолчанию.

Figma Buzz

Figma Buzz — это инструмент, с помощью которого бренд-дизайнеры и маркетинговые команды могут создавать визуальные активы в фирменном стиле в больших масштабах непосредственно в Экосистема Figma. Он включает в себя систему шаблонов, упрощенный редактор дизайна, массовое создание активов и редактирование с помощью искусственный интеллект (ИИ).

Плагин Phrase Strings для Buzz позволяет локализовать контент непосредственно в Buzz, предоставляя те же возможности, что и в интеграции с Figma Design:

Примечание

Предварительный просмотр в реальном времени не поддерживается.

Плагин доступен в меню Plugins в Buzz. После активации его можно сохранить для будущего использования и запустить для выбранного дизайна, открыв его в модальном окне на боковой панели Figma Buzz. Текстовые слои автоматически обнаруживаются и отображаются в плагине.

Контент дизайна затем можно отправить в подключенный проект Strings для перевода. После перевода пользователи могут загрузить локализованный контент обратно в Buzz, что создает новую строку, содержащую переведенную версию дизайна.

Переключатель Загрузить предварительный просмотр Figma и выбор языка перевода перед отправкой ключей в Buzz недоступны. При отправке ключей из Buzz автоматически используются все языки перевода, настроенные в проекте Strings.

Была ли эта статья полезной?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.