ヒント
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
クリックしてプラグインを開きます。
-
View text in Strings
Stringsプロジェクトに接続されたFigmaファイルに表示されます。クリックして、翻訳エディタ で関連するプロジェクトを開きます。
タブでは、FigmaのフレームやテキストレイヤーをローカライズのためにPhrase Stringsへ送信できます。保護されたメインブランチにコンテンツをプッシュすることはできません。
プッシュするコンテンツのプロジェクト、ブランチ（使用している場合）、および言語を選択します。必要に応じて、アップロードされたキーに追加するカスタム タグ を入力します。
空欄または重複したキー名は、 列の赤いカウンターで示されます。長いキー名のリストを管理するには、 ドロップダウンを使用して、表示するか、表示します。
備考
選択した並べ替えオプションは、次回のセッションでも保持されます。
キー名の入力が空欄である、無効な文字が含まれている、または保護されたメインブランチが選択されている場合にキー名が一意でない場合、Push to Phrase ボタンは無効になります。
設定を選択してキー名の入力を編集し、名前の競合を解決します。必要に応じて、目的のキーを選択し、テーブル上部の Exclude layers をクリックして、それらのレイヤーをプラグインから削除します。
競合するキー名を持つ切断されたレイヤーがある場合は、利用可能な解決オプションのいずれかを選択して続行してください：
-
-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から同期されたジョブを扱う際に、TMSのインコンテキストプレビューでサポートされます。HTML書式設定タグは、Strings Editor内およびFigmaにプルバックされたエクスポート済みの翻訳内に表示されます。
手動調整を避けるためにリッチ書式設定が不要な場合は、このオプションを無効にします。
この設定はファイルレベルで適用され、そのファイルで作業するすべての共同作業者に影響します。このオプションは、新しいファイルに対して記憶されます。
接続されたレイヤーについては、関連する省略記号メニューで以下の操作が可能です：
-
キーの詳細を表示を選択して、Phrase Stringsでキーの説明を表示/編集するか、キーの文字制限を設定します。ウィンドウで保存された変更は、エディタページを更新した後、Strings Editorサイドバーに表示されます。
ヒント
タブで複数のキーを選択し、バッチアクション文字制限を設定を使用して、選択したすべてのキーに一度に文字制限を設定します。
-
エディタでキーを開くを選択して、Strings Editor内の関連するキーに移動します。
-
コンテンツをPhrase Stringsから切断を選択して、レイヤーを既存のキーから切断します。
複製されたコンテンツを管理する
コンテンツをプッシュする際、複製されたコンテンツを持つレイヤーは、まったく同じテキストを含む複数のキーをStrings内に生成します。ユーザーは、ウィンドウで、この複製されたコンテンツをどのように管理するかを決定できます：
-
複製されたコンテンツで複数のキーを作成することが意図的な場合は、結合せずに続行を選択します。
-
一部の複製されたコンテンツを単一のキーに結合するには、以下の手順に従ってください：
-
重複したコンテンツの一部またはすべてを一覧の最初のキーに結合するには、次の手順に従います。
-
一覧から複数またはすべてのキーを選択し、
すべての重複を最初のキーに結合をクリックします。
-
続行をクリックし、ポップアップで結合してプッシュを選択して確定します。
重複したコンテンツは1つのキーに結合され、関連するすべてのレイヤーがそのキーに接続されます。
このオプションは、重複が多い大きなファイルで役立ちます。各キーを個別に処理する代わりに、見つかったすべての重複を最初のキーに一度の操作で結合できます。
-
レイヤーを自動除外設定は、名前のプレフィックスに基づいてタブからテキストレイヤーを削除します。有効にすると、_または.で始まるレイヤーは自動的に除外されます。
この設定はデフォルトでオフになっており、ファイルごとに適用されます。オフにするまで、そのファイル内のすべての名前付きレイヤーに対して有効になります。
除外設定は選択範囲全体で保持されます。コンポーネントの場合、コンポーネントのレイヤーにプレフィックスが付いており、レイヤーを自動除外が有効になっていると、そのコンポーネントを使用する下流のデザインにも除外設定が継承されます。
からプレフィックス付きレイヤーを自動除外するには：
プラグイン設定のセクションでは、接続されたキーの命名規則を設定できます。
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つのタブがあるウィンドウを開きます：
-
提案: 正確な名前が一致するキーと、翻訳コンテンツが一致するキーを表示します。
-
検索: すべてのキーを名前またはコンテンツで検索します。
複数のレイヤーに対して操作を行うには、それらを選択してバッチアクションのトレイを表示します。
-
キー名で接続: レイヤーを正確な名前が一致するキーに接続します。
-
コンテンツで接続: レイヤーを翻訳コンテンツが一致するキーに接続します。
-
レイヤーの接続を解除: 選択したレイヤーから接続を削除します。
一致するキーが複数あるレイヤーをスキップする
一致するキーが複数あるレイヤーをスキップするトグルは、がテキストが複数のキーと一致するレイヤーをどのように処理するかを制御します。
トグルを有効にするには：
-
プラグインを開き、タブに移動します。
-
ナビゲーションの
をクリックして、ビューオプションを開きます。
-
を有効にします。
有効にすると、複数のキーと一致するレイヤーは中にスキップされ、手動確認のために接続されないままになります。
実行後の概要
「コンテンツで接続」または「キー名で接続」のバッチ実行ごとに、結果ウィンドウに結果が表示されます。
-
接続数
-
スキップ—一致が見つかりませんでした
-
スキップ—複数の一致（「複数のキーが一致するレイヤーをスキップ」がオンの場合に表示）
接続されていないレイヤーを表示をクリックしてテーブルをフィルタリングし、まだ対応が必要なレイヤーを表示するか、完了をクリックして結果ウィンドウを閉じます。
翻訳が完了したら、翻訳を取得するFigmaレイヤーまたはフレームを選択し、タブをクリックします。
ユーザーは、プロジェクト、ブランチ（使用されている場合）、および取得するコンテンツの言語を選択できます。タグをFigmaに取得することはできません。
キー名の長いリストを管理するには、 ドロップダウンを使用してし、潜在的な問題に対処します。必要に応じて、特定のキーを選択し、テーブル上部のレイヤーを除外をクリックして、プラグインからそれらのレイヤーを削除します。
備考
選択した並べ替えオプションは、次回のセッションでも保持されます。
メニューをクリックして、取得したコンテンツをFigmaで表示する方法を選択します。
-
デフォルトで選択されています。複数の言語を取得する場合、選択した各言語に対して個別のFigmaページが作成され、そのページ内のすべてのレイヤーが含まれます。
備考
Figma Buzzでは、オプションが表示されます。
-
新しいページを1つ作成し、選択した翻訳済みコンテンツを言語別の列に並べて配置します。このオプションは、Figmaページ全体を複製するのではなく、アクティブな選択範囲のみに焦点を当てます。
プルパフォーマンスを向上させ、不要なファイルサイズを削減するために、大きなファイルに推奨されます。
-
選択したテキストレイヤーは翻訳で上書きされ、ビューポートで更新されます。
このオプションは、複数の言語でプルする際には自動的に無効になります。
-
デフォルトでは無効になっています。有効にした場合:
-
翻訳済みコンテンツの代わりにキー名がプルされ、表示されます。
-
プルするコンテンツの言語を選択することはできなくなります。
-
-
この設定は、今後のセッションでも記憶されます。
-
無効にすると、列には選択したレイヤーのコンテンツが直接表示されます。
-
有効にすると、列には、接続されたレイヤーについて選択した言語でのコンテンツのプレビューが表示されます。
-
接続されていないレイヤーについては、オプションを有効にすると、選択した言語でのプレビューが表示されます。プルされたデータ内に同じ名前のキーが存在する場合、そのキーのコンテンツがプレビューとして使用されます。
-
このオプションは、複数の言語でプルする際には自動的に無効になります。
-
-
Figmaでデータをプルする際に、接続されていないレイヤーをどのように処理するかを制御します。この設定は、今後のセッションでも記憶されます。
-
有効にすると、システムはプルされたデータ内に同じ名前のキーが存在するかどうかを確認します。
一致が見つかった場合:
-
切断されたレイヤーは、一致するキーに接続されます。
-
レイヤーのコンテンツは、既存のキーからプルされたコンテンツで更新されます。
-
-
無効にした場合、プルされたデータに一致するキーが存在していても、切断されたレイヤーは更新されません。
-
翻訳ステータスを確認
「翻訳ステータスを確認」機能は、コンテンツをFigmaにプルする前に、現在の選択範囲内のテキストレイヤーに、選択した訳文の言語の翻訳が既に存在するかどうかを検証します。このチェックは、選択範囲内のすべての接続済みキーに対して実行されます。
翻訳ステータスを確認するには
-
タブで、確認する訳文の言語を選択します。
-
翻訳ステータスを確認をクリックします。
ページには、現在の選択範囲について、各言語の翻訳済み、一部翻訳済み、未翻訳のキーの数が表示されます。
言語の横にある詳細を表示をクリックすると、その言語の接続済みキーの内訳が開きます。、、のフィルタを使用して、一覧を絞り込みます。
コンテンツがFigmaに正常にプルされると、ウィンドウが表示され、更新されたレイヤーの概要が示されます。
複数の言語でプルする場合、ボタンをクリックすると、プロジェクトのデフォルト言語を原文としてキーが開きます。
Figma Buzzは、ブランドデザイナーやマーケティングチームが、Figmaエコシステム内で直接、ブランドに沿ったビジュアルアセットを大規模に作成できるツールです。これには、テンプレートシステム、簡略化されたデザインエディタ、アセットの一括作成、AIを活用した編集機能が含まれています。
Buzz用Phrase Stringsプラグインを使用すると、Figmaデザイン統合と同じ機能を提供することで、Buzz内で直接テキストコンテンツをローカライズできます。
-
原文テキストをプッシュしてBuzzからStringsへ
-
訳文をプルしてBuzzに戻す
-
キーを管理し、アセット全体でテキストの一貫性を維持します。
備考
ライブプレビューはサポートされていません。
このプラグインは、Buzzのメニューから利用できます。一度有効にすると、将来の使用のために保存でき、Figma Buzzサイドバーからモーダルで開くことで、選択したデザイン上で実行できます。テキストレイヤーは自動的に検出され、プラグインに表示されます。
その後、デザインコンテンツを接続されたStringsプロジェクトにプッシュして翻訳できます。翻訳後、ユーザーはローカライズされたコンテンツをBuzzにプルバックでき、それによって翻訳されたバージョンのデザインを含む新しい行が作成されます。
の切り替えと、キーをプッシュする前の訳文言語の選択は、Buzzでは利用できません。Buzzからキーをプッシュする場合、Stringsプロジェクトで構成されたすべての訳文言語が自動的に使用されます。