ヒント
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内に生成します。ユーザーは、ウィンドウで、この複製されたコンテンツをどのように管理するかを決定できます：
-
複製されたコンテンツで複数のキーを作成することが意図的な場合は、結合せずに続行を選択します。
-
一部の複製されたコンテンツを単一のキーに結合するには、以下の手順に従ってください：
-
一部またはすべての重複コンテンツを一覧の最初のキーに結合するには、以下の手順に従います。
-
一覧から複数のキーまたはすべてのキーを選択し、
すべての重複を最初のキーに結合をクリックします。
-
Proceedをクリックし、ポップアップでMerge and Pushを選択して確定します。
重複したコンテンツは単一のキーに結合され、関連するすべてのレイヤーがそのキーに接続されます。
このオプションは、重複が多い大きなファイルで役立ちます。各キーを個別に処理する代わりに、見つかったすべての重複を最初のキーに一度のアクションで結合できます。
-
Figmaでフレームやテキストレイヤーを複製すると、Phrase Stringsキーへの既存の接続も複製されます。複製されたレイヤーが新しい無関係なコピーとして再利用され、先に接続を解除せずにプッシュされた場合、そのプッシュは新しいキーを作成する代わりに既存のキーの原文を更新します。キーの原文を更新しても、そのキーに保存されている訳文はクリアまたは更新されないため、その後レイヤーをプルしても、新しくプッシュされたコピーではなく、以前のコンテンツに関連付けられた訳文が返されます。
複製または再利用されたフレームやテキストレイヤーからコンテンツをプッシュする前に、タブを確認し、レイヤーがすでにキーに接続されているかどうかを確認してください。接続されており、新しいコピーが以前のコンテンツと無関係である場合は、プラグインが既存のキーを上書きするのではなく新しいキーを作成するように、まずレイヤーの接続を解除してください。
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：選択したレイヤーから接続を解除します。
複数のキーが一致するレイヤーをスキップ
複数のキーが一致するレイヤーをスキップトグルは、が複数のキーと一致するテキストを持つレイヤーをどのように処理するかを制御します。
トグルを有効にするには：
-
プラグインを開き、タブに移動します。
-
ナビゲーションの
をクリックして、表示オプションを開きます。
-
を有効にします。
有効にすると、複数のキーと一致するレイヤーは中にスキップされ、手動確認のために未接続のままになります。
実行後の概要
「コンテンツで接続」または「キー名で接続」のバッチ実行後、結果ウィンドウに結果が表示されます：
-
接続済み数
-
スキップ—一致するキーが見つかりません
-
スキップ—複数のキーが一致（「複数のキーが一致するレイヤーをスキップ」が有効な場合に表示）
未接続のレイヤーを表示をクリックしてテーブルをフィルタリングし、対応が必要なレイヤーを表示するか、完了をクリックして結果ウィンドウを閉じます。
テキストレイヤーを複数形キーとしてマークすると、Phrase Strings内のそのキーの複数形に接続されます。複数形キーの場合、列にはキーのコンテンツの代わりにフォーム選択ドロップダウンが表示され、選択した言語で使用可能なフォーム（例：oneやother）が一覧表示されます。ポーランド語のように複雑な複数形ルールを持つ言語では、最大5つのフォームが表示されます。
このドロップダウンは、タブとタブの両方に表示されます。
キャンバス上で複数形をプレビューするには：
-
コンテンツテーブルで、複数形キーを見つけます。
-
列のフォームセレクターのドロップダウンをクリックし、プレビューする複数形を選択します。
-
Phrase Stringsは、一致する翻訳をレイヤーにプルしてキャンバス上でプレビューします
複数形のキーをPhrase Stringsにプッシュする場合、他のキーと同じプッシュワークフローに従い、選択したフォームの翻訳のみが更新されます。
選択された複数形は、レイヤーごと、プロジェクトごと、およびブランチごとに記憶されます。選択内容はセッション間でも保持されます。
翻訳が完了したら、翻訳をプルするFigmaレイヤーまたはフレームを選択し、タブをクリックします。
ユーザーは、プロジェクト、ブランチ（使用されている場合）、およびプルするコンテンツの言語を選択できます。タグをFigmaにプルバックすることはできません。
キー名の長いリストを管理するには、 ドロップダウンを使用してし、潜在的な問題に対処します。必要に応じて、特定のキーを選択し、テーブル上部のレイヤーを除外をクリックして、それらのレイヤーをプラグインから削除します。
備考
選択した並べ替えオプションは、次回のセッションでも保持されます。
メニューをクリックして、Figmaでコンテンツをどのように表示するかを選択します：
-
デフォルトで選択されています。複数の言語でプルする場合、選択した各言語に対して個別のFigmaページが作成され、そのページ内のすべてのレイヤーが含まれます。
備考
Figma Buzzでは、オプションが表示されます。
-
単一の新しいページを作成し、選択した翻訳済みコンテンツを言語別の列に並べて配置します。このオプションは、Figmaページ全体を複製するのではなく、アクティブな選択範囲のみに焦点を当てます。
大きなファイルの場合、プルパフォーマンスを向上させ、不要なファイルサイズを削減するために推奨されます。
-
選択したテキストレイヤーは翻訳で上書きされ、ビューポート内で更新されます。
このオプションは、複数の言語をプルする際には自動的に無効になります。
-
デフォルトでは無効になっています。有効にした場合：
-
翻訳されたコンテンツの代わりにキー名がプルされ、表示されます。
-
プルされたコンテンツの言語を選択することはできなくなります。
-
-
この設定は今後のセッションでも記憶されます。
-
無効にすると、列には選択したレイヤーのコンテンツが直接表示されます。
-
有効にすると、列には、接続されたレイヤーについて選択した言語でのコンテンツのプレビューが表示されます。
-
接続されていないレイヤーの場合は、オプションを有効にすると、選択した言語でのプレビューが表示されます。プルされたデータ内に同じ名前のキーが存在する場合、そのキーのコンテンツがプレビューとして使用されます。
-
このオプションは、複数の言語をプルする際には自動的に無効になります。
-
-
Figmaでデータをプルする際に、接続されていないレイヤーをどのように処理するかを制御します。この設定は今後のセッションでも記憶されます。
-
有効にすると、システムはプルされたデータ内に同じ名前のキーが存在するかどうかを確認します。
一致が見つかった場合：
-
接続されていないレイヤーが一致するキーに接続されます。
-
レイヤーのコンテンツは、既存のキーからプルされたコンテンツで更新されます。
-
-
無効にすると、プルされたデータ内に一致するキーが存在する場合でも、接続されていないレイヤーは更新されません。
-
翻訳ステータスを確認する
「翻訳ステータスを確認する」機能は、コンテンツをFigmaにプルする前に、現在の選択範囲内のテキストレイヤーに、選択した訳文言語の訳文がすでに存在するかどうかを検証します。このチェックは、選択範囲内のすべての接続済みキーに対して実行されます。
翻訳ステータスを確認するには
-
タブで、確認する訳文言語を選択します。
-
翻訳ステータスを確認をクリックします。
ページには、現在の選択範囲について、各言語の訳文済み、一部訳文済み、未訳文のキーの数が表示されます。
言語の横にある詳細を表示をクリックすると、その言語の接続済みキーの内訳が開きます。、、のフィルタを使用して一覧を絞り込みます。
コンテンツがFigmaに正常にプルされると、ウィンドウが表示され、更新されたレイヤーの概要が示されます。
複数の言語に対してプルを行う場合、ボタンをクリックすると、プロジェクトのデフォルト言語を原文言語としてキーが開かれます。
備考
デザインで使用されているフォントがローカルにインストールされていない場合、プラグインは影響を受けるテキストレイヤーをプルされた訳文で更新できません。この場合、「フォント [X] を読み込めませんでした」というエラーが表示されます。[X] は不足しているフォントの名前です。このエラーメッセージでフラグが立てられたすべてのフォントをローカルにインストールしてから、コンテンツを再度プルしてください。
Figma Buzzは、ブランドデザイナーやマーケティングチームが、Figmaエコシステム内で直接、ブランドに沿ったビジュアルアセットを大規模に作成できるツールです。これには、テンプレートシステム、簡略化されたデザインエディタ、アセットの一括作成、AIを活用した編集機能が含まれています。
Buzz用Phrase Stringsプラグインを使用すると、Figmaデザイン統合と同じ機能を提供することで、Buzz内で直接テキストコンテンツをローカル化できます。
-
原文テキストをプッシュ（BuzzデザインからStringsへ）
-
訳文をプル（Buzzへ戻す）
-
キーを管理し、アセット全体でテキストの一貫性を維持します。
備考
ライブプレビューはサポートされていません。
このプラグインは、Buzzのメニューから利用できます。一度有効にすると、将来の使用のために保存でき、Figma Buzzサイドバーからモーダルで開くことで、選択したデザイン上で実行できます。テキストレイヤーは自動的に検出され、プラグインに表示されます。
その後、デザインコンテンツを接続されたStringsプロジェクトにプッシュして翻訳できます。翻訳後、ユーザーはローカライズされたコンテンツをBuzzにプルバックでき、それによって翻訳されたバージョンのデザインを含む新しい行が作成されます。
の切り替えと、キーをプッシュする前の訳文言語の選択は、Buzzでは利用できません。Buzzからキーをプッシュする場合、Stringsプロジェクトで構成されたすべての訳文言語が自動的に使用されます。