ヒント
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レイヤーをPhrase Stringsのプロジェクトに既に存在するキーに接続できます。レイヤーとキーの命名規則が同じであれば、自動的に一致させることができます。
プラグインには、Figmaサイドバーの専用ボタンからアクセスできます：
-
Phrase Strings
クリックしてプラグインを開きます。
-
Stringsでテキストを表示
Stringsプロジェクトに接続されたFigmaファイルに表示されます。クリックして、関連するプロジェクトを翻訳エディタで開きます。
タブでは、FigmaのフレームやテキストレイヤーをローカライズのためにPhrase Stringsへ送信できます。保護されたメインブランチにコンテンツをプッシュすることはできません。
プッシュするコンテンツのプロジェクト、ブランチ（使用している場合）、および言語を選択します。必要に応じて、アップロードするキーに追加するカスタムタグを入力します。
空欄または重複したキー名は、列の赤いカウンターで示されます。長いキー名のリストを管理するには、 ドロップダウンを使用して、または表示します。
備考
選択した並べ替えオプションは、次回のセッションでも保持されます。
キー名の入力が空欄、無効な文字を含む、または保護されたメインブランチが選択されていてキー名が一意でない場合、Push to Phraseボタンは無効になります。
設定を選択して、キー名の入力を編集し、名前の競合を解決します。必要に応じて、目的のキーを選択し、テーブル上部のレイヤーを除外をクリックして、それらのレイヤーをプラグインから削除します。
競合するキー名を持つ切断されたレイヤーがある場合は、利用可能な解決オプションのいずれかを選択して続行してください：
-
-copyサフィックスが付いた新しいキーを作成します。 -
レイヤーを既存のPhraseキーにリンクします。
-
競合しないレイヤーのみをプッシュします。
Upload Figma previewオプションが有効な場合：
-
ユーザーは、Figmaプレビューに含める対象言語を任意で選択できます。言語が選択されていない場合は、デフォルトですべての言語が含まれます。
-
このプラグインは、プッシュに含まれるルートフレーム（またはトップレベルコンポーネント）ごとに1つのジョブを作成します。多数のトップレベルフレームを持つFigmaページ全体をプッシュすると、それに応じて大量のジョブが生成されます。ジョブ数を実際の翻訳の仕事の範囲に比例させるには、プッシュする前に、新規または更新されたコンテンツを含む特定のフレームのみを選択してください。
レイヤーがStringsに正常にプッシュされると、ウィンドウが表示され、概要と以下のオプションが表示されます：
-
作成 ジョブ
クリックすると、プッシュされたキーが事前に選択された状態でページが開きます。
注意
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プロジェクト内のアクティブなジョブ自動化は、ジョブの複製を避けるためにスキップされます。
プレビューが10 MBの制限を超える場合、キーは引き続きStringsにプッシュされますが、プレビュー付きのジョブは作成されません。
備考
Strings EditorでFigmaプレビューを使用するには、コンテキストサイドバーでFigmaプレビューを追加アクションを使用します。
-
コンテンツのフォーマットとスタイルを保持を有効にすると、FigmaからPhraseにコンテンツをプッシュし、翻訳をプルバックする際に、リッチテキストフォーマット（リスト、改行、太字/斜体、リンクなど）が保持されます。
有効にすると、HTMLフォーマットタグが自動的に追加されてインラインスタイルが保持され、Stringsからjobs syncedを扱う際に、TMSのインコンテキストプレビューでサポートされます。HTMLフォーマットタグは、Strings EditorおよびFigmaにプルバックされたエクスポート済みの翻訳内に表示されます。
手動調整を避けるためにリッチフォーマットが不要な場合は、このオプションを無効にします。
この設定はファイルレベルで適用され、そのファイルで作業するすべての共同作業者に影響します。このオプションは、新しいファイルに対して記憶されます。
接続されたレイヤーについては、関連する省略記号メニューで以下の操作が可能です：
-
キーの詳細を表示を選択して、Phrase Stringsでキーの説明を表示/編集するか、キーの文字制限を設定します。ウィンドウで保存された変更は、エディターのページを更新した後、Stringsエディターサイドバーに表示されます。
ヒント
タブで複数のキーを選択し、バッチアクション文字制限を設定を使用して、選択したすべてのキーに一度に文字制限を設定します。
-
エディタでキーを開くを選択して、Strings Editor内の関連するキーに移動します。
-
コンテンツをPhrase Stringsから切断を選択して、レイヤーを既存のキーから切断します。
複製されたコンテンツを管理する
コンテンツをプッシュする際、複製されたコンテンツを持つレイヤーは、まったく同じテキストを含む複数のキーをStrings内に生成します。ユーザーは、ウィンドウで、この複製されたコンテンツをどのように管理するかを決定できます：
-
複製されたコンテンツを持つ複数のキーを作成することが意図的な場合は、結合せずに続行を選択します。
-
一部の複製されたコンテンツを単一のキーに結合するには、以下の手順に従ってください：
-
重複したコンテンツの一部またはすべてを一覧の最初のキーに結合するには、以下の手順に従います。
-
一覧から複数のキーまたはすべてのキーを選択し、
すべての重複を最初のキーに結合をクリックします。
-
Proceedをクリックし、ポップアップでMerge and Pushを選択して確定します。
重複したコンテンツは単一のキーに結合され、関連するすべてのレイヤーがそのキーに接続されます。
このオプションは、重複が多い大きなファイルで役立ちます。各キーを個別に処理する代わりに、見つかったすべての重複を最初のキーに一度の操作で結合できます。
-
Figmaでフレームやテキストレイヤーを複製すると、Phrase Stringsキーへの既存の接続も複製されます。複製されたレイヤーが新しい無関係なコピーに再利用され、先に接続を解除せずにプッシュされた場合、そのプッシュは新しいキーを作成する代わりに既存のキーの原文を更新します。キーの原文を更新しても、そのキーに既に保存されている訳文はクリアまたは更新されないため、その後レイヤーをプルしても、新しくプッシュされたコピーではなく、以前のコンテンツに関連付けられた訳文が返されます。
複製または再利用されたフレームやテキストレイヤーからコンテンツをプッシュする前に、タブを確認し、レイヤーが既にキーに接続されているかどうかを確定してください。接続されており、新しいコピーが以前のコンテンツと無関係である場合は、プラグインが既存のキーを上書きする代わりに新しいキーを作成するように、まずレイヤーの接続を解除してください。
Auto-exclude layers設定は、名前のプレフィックスに基づいてタブからテキストレイヤーを削除します。有効にすると、_または.で始まるレイヤーは自動的に除外されます。
この設定はデフォルトでオフになっており、ファイルごとに適用されます。オフにするまで、そのファイル内の名前付きレイヤーすべてに対して有効になります。
除外設定は選択範囲全体で保持されます。コンポーネントの場合、コンポーネントのレイヤーにプレフィックスが付いており、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を選択して、タブ内のリンクされていないすべてのキーを一括接続します。個々のキーを接続または接続解除するには、対応するエントリーの右側にある関連アイコンをクリックします。
備考
個々のキーを接続解除するオプションは、タブでも利用できます。
新しいビューでは、現在の選択範囲のテキストレイヤーとその接続ステータスが1つの表に一覧表示され、以前のキーベースの一覧に代わるものです。
備考
最新バージョンが読み込まれるように、ベータ版を有効にする前にプラグインを再起動してください。
を有効にするには:
以前の接続ビューも引き続き利用可能です。プラグイン設定で を無効にすると元に戻ります。
単一のレイヤーを接続するには、それを選択して2つのタブがあるウィンドウを開きます：
-
Suggestions: 正確な名前が一致するキーと、翻訳コンテンツが一致するキーを表示します。
-
Search: 名前またはコンテンツですべてのキーを検索します。
複数のレイヤーに対して操作を行うには、それらを選択してバッチアクションのトレイを表示します：
-
Connect by key name: レイヤーを正確な名前が一致するキーに接続します。
-
Connect by content: レイヤーを翻訳コンテンツが一致するキーに接続します。
-
Disconnect layers: 選択したレイヤーから接続を削除します。
複数のキーと一致するレイヤーをスキップ
複数のキーと一致するレイヤーをスキップトグルは、がテキストが複数のキーと一致するレイヤーをどのように処理するかを制御します。
トグルを有効にするには：
-
プラグインを開き、 タブに移動します。
-
ナビゲーションの
をクリックして、表示オプションを開きます。
-
を有効にします。
有効にすると、複数のキーと一致するレイヤーは 中にスキップされ、手動確認のために接続されないままになります。
操作後の概要
Connect by content または Connect by key name の各バッチ実行後、結果ウィンドウに結果が表示されます：
-
接続数
-
スキップ―一致が見つかりません
-
スキップ―複数の一致（「複数のキーと一致するレイヤーをスキップ」がオンの場合に表示）
Show unconnected layersをクリックして、対応が必要なレイヤーのみが表示されるようにテーブルをフィルタするか、またはDoneをクリックして結果ウィンドウを閉じます。
テキストレイヤーを複数形キーとしてマークすると、Phrase Strings内のそのキーの複数形と接続されます。複数形キーの場合、列にはキーの内容の代わりにフォーム選択用のドロップダウンが表示され、選択した言語で利用可能なフォーム（例：oneおよびother）が一覧表示されます。ポーランド語のように複雑な複数形ルールを持つ言語では、最大5つのフォームが表示されます。
ドロップダウンは、タブとタブの両方に表示されます。
キャンバス上で複数形フォームをプレビューするには：
-
コンテンツテーブルで、複数形キーを見つけます。
-
列のフォーム選択ドロップダウンをクリックし、プレビューする複数形フォームを選択します。
-
Phrase Stringsは、一致する翻訳をレイヤーに取り込み、キャンバス上でプレビューします。
複数形キーをPhrase Stringsにプッシュするワークフローは、他のキーと同じで、選択したフォームの翻訳のみが更新されます。
選択された複数形フォームは、レイヤーごと、プロジェクトごと、およびブランチごとに記憶されます。選択内容はセッションをまたいで保持されます。
翻訳が完了したら、翻訳をプルするFigmaレイヤーまたはフレームを選択し、タブをクリックします。
ユーザーは、プルするコンテンツのプロジェクト、branch（使用されている場合）、および言語を選択できます。タグをFigmaにプルバックすることはできません。
長いキー名のリストを管理するには、 ドロップダウンを使用してを表示し、潜在的な問題に対処します。必要に応じて、特定のキーを選択し、テーブル上部のExclude layersをクリックして、それらのレイヤーをプラグインから削除します。
備考
選択した並べ替えオプションは、次回のセッションでも保持されます。
メニューをクリックして、プルされたコンテンツをFigmaでどのように表示するかを選択します：
-
デフォルトで選択されています。複数の言語でプルする場合、選択した各言語に対して個別のFigmaページが作成され、ページ内のすべてのレイヤーが含まれます。
備考
Figma Buzzでは、オプションが表示されます。
-
単一の新しいページを作成し、選択した翻訳済みコンテンツを言語別の列に並べて配置します。このオプションは、Figmaページ全体を複製するのではなく、アクティブな選択範囲のみに焦点を当てます。
プルパフォーマンスを向上させ、不要なファイルサイズを削減するために、大きなファイルに対して推奨されます。
-
選択したテキストレイヤーは翻訳で上書きされ、ビューポートで更新されます。
このオプションは、複数の言語でプルする際には自動的に無効になります。
-
デフォルトでは無効になっています。有効にした場合：
-
翻訳されたコンテンツの代わりにキー名がプルされ、表示されます。
-
プルするコンテンツの言語を選択することはできなくなります。
-
-
この設定は今後のセッションでも記憶されます。
-
無効にすると、列には選択したレイヤーのコンテンツが直接表示されます。
-
有効にすると、列には、接続されたレイヤーについて選択した言語でのコンテンツのプレビューが表示されます。
-
接続されていないレイヤーについては、オプションを有効にして、選択した言語でプレビューを表示します。プルされたデータ内に同じ名前のキーが存在する場合、そのキーのコンテンツがプレビューとして使用されます。
-
このオプションは、複数の言語でプルする際には自動的に無効になります。
-
-
Figmaでデータを取り込む際に、接続されていないレイヤーをどのように処理するかを制御します。この設定は今後のセッションでも記憶されます。
-
有効にすると、プルされたデータ内に同じ名前のキーが存在するかどうかがシステムによってチェックされます。
一致するものが見つかった場合：
-
接続されていないレイヤーが、一致するキーに接続されます。
-
レイヤーのコンテンツは、既存のキーからプルされたコンテンツで更新されます。
-
-
無効にすると、プルされたデータ内に一致するキーが存在する場合でも、接続されていないレイヤーは更新されません。
-
翻訳ステータスを確認
「翻訳ステータスを確認」機能は、Figmaにコンテンツを取り込む前に、現在の選択範囲内のテキストレイヤーに選択した対象言語の翻訳が既に存在するかどうかを検証します。このチェックは、選択範囲内のすべての接続済みキーに対して実行されます。
翻訳ステータスを確認するには
-
タブで、確認する対象言語を選択します。
-
「翻訳ステータスを確認」をクリックします。
ページには、現在の選択範囲について、各言語の翻訳済み、一部翻訳済み、未翻訳のキーの数が表示されます。
言語の横にある詳細を表示をクリックすると、その言語の接続済みキーの内訳が開きます。、、の各フィルタを使用して、一覧を絞り込みます。
コンテンツがFigmaに正常にプルされると、ウィンドウが表示され、更新されたレイヤーの概要が示されます。
複数の言語をプルする場合、ボタンをクリックすると、プロジェクトのデフォルト言語が原文言語としてキーが開きます。
備考
デザインで使用されているフォントがローカルにインストールされていない場合、プラグインは影響を受けるテキストレイヤーを取り込まれた訳文で更新できません。これが発生すると、「The font [X] could not be loaded」というエラーが表示されます。[X] は不足しているフォントの名前です。このエラーメッセージでフラグが立てられたすべてのフォントをローカルにインストールしてから、コンテンツを再度プルしてください。
Figma Buzz は、ブランドデザイナーやマーケティングチームが、Figma エコシステム内で直接、ブランドに沿ったビジュアルアセットを大規模に作成できるツールです。これには、テンプレートシステム、簡略化されたデザインエディタ、アセットの一括作成、AI を活用した編集機能が含まれています。
Phrase Strings プラグイン for Buzz を使用すると、Figma Design インテグレーションと同じ機能を提供し、Buzz内で直接テキストコンテンツをローカライズできます。
-
Push source text（BuzzデザインからStringsへソーステキストをプッシュ）
-
Pull translations（翻訳をBuzzへプルバック）
-
Manage keys（キーを管理し、アセット間でテキストの一貫性を維持）
備考
ライブプレビューはサポートされていません。
このプラグインは、Buzz の メニューから利用できます。一度有効にすると、将来の使用のために保存でき、Figma Buzzサイドバーのモーダルで開くことで、選択したデザインに対して実行できます。テキストレイヤーは自動的に検出され、プラグインに表示されます。
その後、デザインコンテンツを接続された Strings プロジェクトにプッシュして翻訳できます。翻訳後、ユーザーはローカライズされたコンテンツをBuzzにプルできます。これにより、翻訳されたバージョンのデザインを含む新しい行が作成されます。
の切り替えと、キーをプッシュする前のターゲット言語の選択は、Buzzでは利用できません。Buzzからキーをプッシュする場合、Strings プロジェクトで構成されたすべてのターゲット言語が自動的に使用されます。