Интеграции

Figma (Strings)

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

Доступно для

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

Доступно для

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

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

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

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

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

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

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

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

  • По умолчанию скрытые текстовые слои не включаются в интеграцию. Это можно изменить в настройках 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 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. Откройте настройки плагина и включите Автоматически исключать слои.

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

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

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

  1. Нажмите Включить интеллектуальное именование ключей в настройках Именование ключей.

  2. Выберите Работа с именами ключей в Figma.

    Примечание

    Если включена опция Синхронизировать имена текстовых слоев с ключами, имена ключей генерируются автоматически на основе имен текстовых слоев.

  3. В поле Генерация имени ключа введите текст, чтобы определить пользовательское именование ключей:

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

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

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

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

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

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

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

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

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

Макросы

Описание

{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.

Новый вид Connect (бета)

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

Примечание

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

Чтобы Включить Новый вид connect:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Откройте плагин и перейдите на вкладку Connect.

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

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

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

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

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

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

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

  • Пропущено — несколько совпадение (отображается, когда включен параметр Пропускать слои с несколькими совпадение ключами)

Нажмите Показать неподключенные слои, чтобы фильтровать таблицу по слоям, которые все еще требуют внимания, или Завершить, чтобы закрыть окно результатов.

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

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

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

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

Примечание

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

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

  • Создать новую страницу для каждого язык

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

    Примечание

    В Figma Buzz отображается параметр Создать новую строку с переведенным контент.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Connect with existing keys

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

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

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

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

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

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

Проверить статус перевода

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

Чтобы проверить статус перевода

  1. Во вкладка Выгрузить контент в Figma Выбрать языки для проверки.

  2. Нажмите кнопку Статус перевода.

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

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

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

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

Figma Buzz

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

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

Примечание

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

Плагин доступен в меню Плагины в 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.