ヒント
Phrase TMSにおけるFigma統合機能の詳細については、Figma (TMS)を参照してください。
Figmaプラグインを使用すると、デザインコンテンツをPhraseプロジェクトと統合でき、製品デザインチームとローカリゼーションチームの間のギャップを埋めることができます。このプラグインは、コンテンツのプッシュ、翻訳のプル、およびFigmaとPhrase Strings間でのキー管理をサポートしています。
-
ブランチ機能がサポートされています。
-
翻訳者ユーザー権限を持つ少なくとも1つのプロジェクトおよび1つの言語へのアクセスが必要です。アクセス権は、管理者またはプロジェクトマネージャから送信された 招待 を受けることで付与されます。
-
プラグインは、子要素ではないオートレイアウトフレームのスクリーンショットを送信します。
-
デフォルトでは、非表示のテキストレイヤーは統合機能に含まれません。これは、設定
で を選択することで変更できます。
-
デフォルトでは、プラグインで選択されたタグはプッシュ処理後にクリアされます。これは、設定
-
プラグインのデフォルト設定
プラグインを実行するには、Figmaのプラグインブラウザ内または Figma Community からプラグインを選択し、Try it out をクリックします。プラグインはFigmaの メニューから利用できるようになります。
FigmaからPhraseへの接続は、Phraseの認証情報、アクセス トークン、またはシングルサインオン (SSO) を使用して行うことができます。
SSOでサインインするには：
接続が確立されると、フレームを選択することでFigmaコンテンツとキーのプレビューが読み込まれ、ユーザーはそれをPhrase Stringsにプッシュしたり、Phrase Stringsからプルしたりできます。
タブでは、FigmaレイヤーをStrings プロジェクトに既に存在するキーに接続できます。レイヤーとキーの命名規則が同じであれば、自動的に一致させることができます。
プラグインには、Figmaサイドバーの専用ボタンからアクセスできます：
-
Phrase Strings
クリックしてプラグインを開きます。
-
Stringsでテキストを表示
Stringsプロジェクトに接続されたFigmaファイルに表示されます。クリックして、翻訳エディタで関連するプロジェクトを開きます。
タブでは、FigmaからPhrase Stringsへローカライズ用にフレームやテキストレイヤーを送信できます。保護されたメインブランチにコンテンツをプッシュすることはできません。
プッシュするコンテンツのプロジェクト、ブランチ（使用している場合）、および言語を選択します。オプションで、アップロードされたキーに追加するカスタムタグを入力します。
空欄または重複したキー名は、列の赤いカウンターで示されます。長いキー名のリストを管理するには、 ドロップダウンを使用して、または表示します。
備考
選択した並べ替えオプションは、今後のセッションでも記憶されます。
キー名の入力が空欄である、無効な文字が含まれている、または保護されたメインブランチが選択されている場合にキー名が一意でないと、Phraseにプッシュボタンは無効になります。
設定を選択して、キー名の入力を編集し、名前の競合を解決します。必要に応じて、目的のキーを選択し、テーブル上部のレイヤーを除外をクリックして、それらのレイヤーをプラグインから削除します。
競合するキー名を持つ切断されたレイヤーがある場合は、利用可能な解決オプションから1つを選択して続行してください：
-
-copyサフィックスが付いた新しいキーを作成します。 -
レイヤーを既存のPhraseキーにリンクします。
-
競合しないレイヤーのみをプッシュします。
Upload Figma previewオプションが有効な場合：
-
ユーザーは、Figmaプレビューに含める訳文を任意で選択できます。言語が選択されていない場合、デフォルトですべての言語が含まれます。
-
プラグインは、プッシュに含まれるルートフレーム（またはトップレベルコンポーネント）ごとに1つのジョブを作成します。多くのトップレベルフレームを持つFigmaページ全体をプッシュすると、それに応じて多数のジョブが生成されます。ジョブ数を実際の翻訳の仕事の範囲に比例させるには、プッシュする前に、新しいコンテンツや更新されたコンテンツを含む特定のフレームのみを選択してください。
レイヤーがStringsに正常にプッシュされると、ウィンドウが表示され、概要と以下のオプションが表示されます：
-
作成 ジョブ<2
クリックすると、プッシュされたキーが事前に選択された状態でページが開きます。
注意
Upload Figma previewオプションが有効になっている場合、Stringsでジョブが自動的に作成されます。一度有効にすると、無効にすることはできません。
-
Open in 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バンドルをエクスポートします。
このオプションは、Stringsからjobs syncedを扱う際に、TMS CAT Editorでin-context previewを生成するために必要です。
ユーザーは、コンテンツをプッシュする際に、Figmaプレビューに含める訳文言語を任意で選択できます。言語が選択されていない場合、デフォルトですべての言語が含まれます。
プレビューが正常に生成されると、Stringsでジョブが自動的に作成されます。Stringsプロジェクトでjob automationがアクティブな場合、ジョブの複製を避けるためにスキップされます。
プレビューが10 MBの制限を超えた場合、キーはStringsにプッシュされますが、プレビュー付きのジョブは作成されません。
備考
Strings EditorでFigmaプレビューを扱うには、contextual sidebarで Add Figma preview アクションを使用します。
-
Preserve content formatting & styling を有効にすると、FigmaからPhraseへコンテンツをプッシュし、訳文をプルする際に、リッチテキストの書式設定（リスト、改行、太字/斜体、リンクなど）が保持されます。
有効にすると、HTML書式設定タグが自動的に追加され、インラインスタイルが保持されます。また、Stringsから同期されたジョブを扱う際、TMSのインコンテキストプレビューでサポートされます。HTML書式設定タグは、Strings Editor内およびFigmaにプルバックされたエクスポート済みの翻訳内に表示されます。
手動調整を避けるためにリッチフォーマットが不要な場合は、このオプションを無効にします。
この設定はファイルレベルで適用され、ファイル内で作業するすべての共同作業者に影響します。このオプションは、新しいファイルに対して記憶されます。
connected layersについては、関連する省略記号メニューで次のアクションを利用できます。
-
View key detailsを選択して、Phrase Strings内のキーの説明を表示/編集するか、キーの文字制限を設定します。ウィンドウで保存された変更は、エディタページを更新した後、Strings Editor sidebarに表示されます。
ヒント
タブで複数のキーを選択し、バッチアクションSet character limitを使用して、選択したすべてのキーの文字制限を一度に設定します。
-
Open key in editorを選択して、Strings Editor内の関連するキーに移動します。
-
Disconnect content from Phrase Stringsを選択して、レイヤーと既存のキーの接続を解除します。
重複したコンテンツを管理する
コンテンツをプッシュする際、重複したコンテンツを持つレイヤーは、Strings内で完全に同じテキストを含む複数のキーを生成します。ユーザーは、ウィンドウでこの重複したコンテンツをどのように管理するかを決定できます。
-
重複したコンテンツを持つ複数のキーを作成することが意図的な場合は、Proceed without mergingを選択します。
-
重複したコンテンツの一部を単一のキーに結合するには、以下の手順に従います。
-
一部またはすべての重複したコンテンツを一覧の最初のキーに結合するには、次の手順に従います：
-
一覧から複数またはすべてのキーを選択し、
Merge all duplicates into first keyをクリックします。
-
Proceedをクリックし、ポップアップでMerge and Pushを選択して確定します。
重複したコンテンツは単一のキーに結合され、関連するすべてのレイヤーがそのキーに接続されます。
このオプションは、重複が多い大きなファイルで役立ちます。各項目を個別に処理する代わりに、見つかったすべての重複を最初のキーに一度の操作で結合できます。
-
Auto-exclude layers設定は、名前のプレフィックスに基づいてタブからテキストレイヤーを除外します。有効にすると、_または.で始まるレイヤーは自動的に除外されます。
この設定はデフォルトでオフになっており、ファイルごとに適用されます。オフにするまで、そのファイル内のすべての名前付きレイヤーに対して有効になります。
除外は選択範囲全体で保持されます。コンポーネントの場合、コンポーネントのレイヤーにプレフィックスが付いており、Auto-exclude layersが有効になっていると、そのコンポーネントを使用する下流のデザインにも除外が継承されます。
からレイヤーを自動的に除外するには：
プラグイン設定のセクションでは、接続されたキーの命名規則を設定できます。
Figmaでキー名をカスタマイズするには、次の手順に従います：
-
設定からEnable smart key namingをクリックします。
-
を選択します。
備考
が有効な場合、キー名はテキストレイヤー名に基づいて自動的に生成されます。
-
フィールドに、カスタムキー名の命名規則を定義するテキストを入力します。
-
必要に応じて、利用可能なマクロをクリックし、サポートされているマクロのいずれかを選択して、キー名を自動的に生成します。
複数のマクロを選択して、キー名を構成できます。
-
フィールドでは、自由テキストとマクロを組み合わせることが可能です。
例をクリックして、定義済みの例を表示し、選択します。
-
-
必要に応じて、ドロップダウンからフォーマットオプションを選択し、テキストを適宜変更してスペースを削除します。
コンテンツをプッシュして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を選択して、タブ内のすべての未リンクのキーを一括接続します。個々のキーを接続または接続解除するには、対応するエントリーの右側にある関連アイコンをクリックします。
備考
個々のキーを接続解除するオプションは、タブでも利用できます。
新しいビューでは、現在の選択範囲のテキストレイヤーとその接続ステータスが1つの表に一覧表示され、以前のキーベースの一覧に代わるものです。
備考
ベータ版を有効にする前にプラグインを再起動して、最新バージョンが読み込まれていることを確認してください。
を有効にするには：
以前の接続ビューは引き続き使用できます。プラグイン設定でを無効にして元に戻します。
単一のレイヤーを接続するには、それを選択して2つのタブがあるウィンドウを開きます:
-
提案: 正確な名前が一致するキーと、一致する翻訳コンテンツを持つキーを表示します。
-
検索: すべてのキーを名前またはコンテンツで検索します。
複数のレイヤーに対して操作を行うには、それらを選択してバッチアクションのトレイを表示します:
-
キー名で接続: レイヤーを正確な名前が一致するキーに接続します。
-
コンテンツで接続: レイヤーを一致する翻訳コンテンツを持つキーに接続します
-
レイヤーの接続を解除: 選択したレイヤーから接続を削除します。
複数のキーと一致するレイヤーをスキップ
複数のキーと一致するレイヤーをスキップトグルは、がテキストが複数のキーと一致するレイヤーをどのように処理するかを制御します。
トグルを有効にするには:
-
プラグインを開き、タブに移動します。
-
ナビゲーションの
をクリックして、表示オプションを開きます。
-
を有効にします。
有効にすると、複数のキーと一致するレイヤーは
アクション後の概要
コンテンツで接続またはキー名で接続のバッチ実行のたびに、結果ウィンドウに結果が表示されます:
-
接続済みカウント
-
スキップ済み—一致が見つかりません
-
スキップ済み—複数の候補が見つかりました（「複数のキーが一致するレイヤーをスキップ」がオンの場合に表示されます）
未接続のレイヤーを表示 をクリックしてテーブルをフィルタし、まだ対応が必要なレイヤーを表示するか、完了 をクリックして結果ウィンドウを閉じます。
翻訳が完了したら、翻訳をプルする Figma レイヤーまたはフレームを選択し、 タブをクリックします。
ユーザーは、プロジェクト、ブランチ（使用されている場合）、およびプルするコンテンツの言語を選択できます。タグを Figma にプルバックすることはできません。
長いキー名のリストを管理するには、 ドロップダウンを使用して し、潜在的な問題に対処します。必要に応じて、特定のキーを選択し、テーブル上部の レイヤーを除外 をクリックして、それらのレイヤーをプラグインから削除します。
備考
選択した並べ替えオプションは、今後のセッションでも記憶されます。
メニューをクリックして、Figma でプルしたコンテンツの表示方法を選択します。
-
デフォルトで選択されています。複数の言語でプルする場合、選択した各言語に対して個別の Figma ページが作成され、そのページ内のすべてのレイヤーが含まれます。
-
単一の新しいページを作成し、選択した翻訳済みコンテンツを言語別の列に並べて配置します。このオプションは、Figma ページ全体を複製するのではなく、アクティブな選択範囲のみに焦点を当てます。
プルパフォーマンスを向上させ、不要なファイルサイズを削減するために、大きなファイルに推奨されます。
-
選択したテキストレイヤーは翻訳で上書きされ、ビューポート内で更新されます。
複数の言語をプルする場合、このオプションは自動的に無効になります。
-
デフォルトでは無効になっています。有効にした場合：
-
翻訳されたコンテンツの代わりにキー名がプルされ、表示されます。
-
プルされたコンテンツの言語を選択することはできなくなります。
-
-
この設定は、今後のセッションのために記憶されます。
-
無効にすると、列には選択したレイヤーのコンテンツが直接表示されます。
-
有効にすると、列には、接続されたレイヤーについて、選択した言語でのコンテンツのプレビューが表示されます。
-
接続されていないレイヤーについては、オプションを有効にして、選択した言語でのプレビューを表示してください。プルされたデータ内に同じ名前のキーが存在する場合、そのキーのコンテンツがプレビューとして使用されます。
-
複数の言語をプルする場合、このオプションは自動的に無効になります。
-
-
Figmaでデータをプルする際に、接続されていないレイヤーをどのように処理するかを制御します。この設定は、今後のセッションのために記憶されます。
-
有効にすると、システムはプルされたデータ内に同じ名前のキーが存在するかどうかを確認します。
一致するものが見つかった場合：
-
接続されていないレイヤーは、一致するキーに接続されます。
-
レイヤーのコンテンツは、既存のキーからプルされたコンテンツで更新されます。
-
-
無効にすると、プルされたデータ内に一致するキーが存在する場合でも、接続されていないレイヤーは更新されません。
-
コンテンツが正常にFigmaにプルされると、ウィンドウが表示され、更新されたレイヤーの概要が示されます。
複数言語を取得する場合、ボタンを押すと、プロジェクトのデフォルト言語を原文言語としてキーが開かれます。
Figma Buzzは、ブランドデザイナーやマーケティングチームが、Figmaエコシステム内で直接、ブランドに沿ったビジュアルアセットを大規模に作成できるツールです。これには、テンプレートシステム、簡略化されたデザインエディタ、アセットの一括作成、AIを活用した編集機能が含まれています。
Buzz用Phrase Stringsプラグインを使用すると、Figmaデザイン統合機能と同じ機能を提供することで、Buzz内で直接テキストコンテンツをローカライズできます。
-
Push source textをBuzzデザインからStringsへ
-
Pull translationsをBuzzへ戻す
-
Manage keysを行い、アセット全体でテキストの一貫性を維持する
備考
ライブプレビューはサポートされていません。
このプラグインは、Buzzのメニューから利用できます。一度有効にすると、将来の使用のために保存でき、Figma Buzzのサイドバーからモーダルで開くことで、選択したデザインに対して実行できます。テキストレイヤーは自動的に検出され、プラグインに表示されます。
その後、デザインのコンテンツを接続されたStringsプロジェクトにプッシュして翻訳できます。翻訳後、ユーザーはローカライズされたコンテンツをBuzzにプルバックでき、翻訳されたバージョンのデザインを含む新しい行が作成されます。
の切り替えと、キーをプッシュする前の訳文言語の選択は、Buzzでは利用できません。Buzzからキーをプッシュする場合、Stringsプロジェクトで設定されたすべての訳文言語が自動的に使用されます。