ヒント
FigmaのPhrase TMS統合に関する情報は、Figma (TMS)を参照してください。
Figmaプラグインは、デザインコンテンツをPhraseプロジェクトに統合し、製品デザインとローカリゼーションチームのギャップを埋めます。プラグインは、コンテンツのプッシュ、翻訳のプル、およびFigmaとPhrase Strings間のキー管理をサポートします。
-
ブランチ機能がサポートされています。
-
翻訳者ユーザー権限を持つ少なくとも1つのプロジェクトと1つの言語へのアクセスが必要です。アクセスは、招待状が管理者またはプロジェクトマネージャによって送信されることで付与されます。
-
プラグインは、子要素でない自動レイアウトフレームのスクリーンショットを送信します。
-
デフォルトでは、隠れたテキストレイヤーは統合に含まれません。これは、設定
でを選択することで変更できます。
-
デフォルトでは、プラグイン内の選択されたタグはプッシュプロセス後にクリアされます。これは、設定
-
プラグインのデフォルト設定
プラグインを実行するには、Figmaのプラグインブラウザ内またはFigmaコミュニティから選択し、試してみるをクリックします。プラグインはFigmaのメニューで利用可能になります。
FigmaからPhraseへの接続は、Phraseの認証情報またはアクセス トークンを提供することで行えます。
接続が確立されると、フレームを選択することでFigmaのコンテンツと、ユーザーがPhrase Stringsにプッシュまたはプルできるキーのプレビューが読み込まれます。
タブでは、Strings プロジェクトに既に存在するキーにFigmaのレイヤーを接続できます。レイヤーとキーの命名規則が同じであれば、自動的に一致させることができます。
プラグインはFigmaのサイドバーにある専用ボタンを通じてアクセスできます：
-
Phrase Strings
プラグインを開くにはクリックしてください。
-
Strings内のテキストを表示
Stringsプロジェクトに接続されたFigmaファイルに表示されます。翻訳エディタで関連するプロジェクトを開くにはクリックしてください。
タブでは、FigmaからPhrase Stringsにフレームやテキストレイヤーをローカライズのために送信できます。保護されたメインブランチにコンテンツをプッシュすることはできません。
プロジェクト、ブランチ（使用している場合）、およびプッシュされるコンテンツの言語を選択してください。オプションで、アップロードされたキーに追加するカスタムタグを入力してください。
空または重複したキー名は、列に赤いカウンターで表示されます。長いキー名のリストを管理するには、 ドロップダウンを使用して、またはします。
備考
選択した並べ替えオプションは、今後のセッションで記憶されます。
フレーズにプッシュするボタンは、キー名入力が空であるか、無効な文字を含むか、保護されたメインブランチが選択されている場合は一意でない場合に無効になります。
設定を選択して、キー名入力を編集し、名前の競合を解決します。必要に応じて、希望するキーを選択し、テーブルの上部にあるレイヤーを除外をクリックして、それらのレイヤーをプラグインから削除します。
競合するキー名を持つ切断されたレイヤーがある場合は、進むために利用可能な解決オプションの1つを選択します：
-
-コピーサフィックスを持つ新しいキーを作成します。 -
レイヤーを既存のフレーズキーにリンクします。
-
競合しないレイヤーのみをプッシュします。
Figmaプレビューをアップロードオプションが有効になっている場合、ユーザーはFigmaプレビューに含めるターゲット言語を選択できます。言語が選択されていない場合、すべての言語がデフォルトで含まれます。
レイヤーがStringsに正常にプッシュされた場合、ウィンドウが表示され、要約と次のオプションが表示されます：
-
作成 ジョブ
プッシュされたキーが事前に選択された状態で、ページを開くにはクリックします。
重要
Figmaプレビューをアップロードオプションが有効になっている場合、Stringsに自動的にジョブが作成されます。一度有効にすると、無効にすることはできません。
-
Stringsで開く
プッシュされたキーをStrings Editorで表示するにはクリックします。
黄色の警告アイコン は、コンテンツをプッシュした後に Strings で名前が変更されたキーの横に表示されます。Figma プラグインでキー名を更新するには、ミスマッチしたキー名の横にある省略記号
メニューから キー名を同期 を選択します。
プッシュオプションとアクション
必要に応じて、以下のプッシュオプションをオンまたはオフに切り替えるには、 メニューをクリックします。
-
スクリーンショットをアップロード はデフォルトで有効になっています。フレーム内の選択したレイヤーのスクリーンショットを添付することができます：
-
設定が有効になっている場合、Figma プラグインでインポートされた隠れたテキストレイヤーには、スクリーンショットの左上隅にマーカーが配置されます。
-
設定が有効になっている場合、Figma セクションのスクリーンショットは作成されません。
プラグインを使用してセクション内で作業する際にパフォーマンスの問題が発生した場合に備えて、このオプションを有効にしておくことをお勧めします。
-
-
Phrase Strings のコンテンツを更新 はデフォルトで有効になっています。
-
Phrase Strings のキー名を更新 はデフォルトで有効になっていますが、 設定が無効になっている場合は除きます。
このオプションをオフにすると、すべてのキー名入力がリセットされます。
-
Figma プレビューをアップロード を有効にして、選択したキーから HTML バンドルをエクスポートします。
このオプションは、Strings から同期された ジョブ で作業する際に、TMS CAT エディタで コンテキストプレビュー を生成するために必要です。
ユーザーは、コンテンツをプッシュする際に Figma プレビューに含めるターゲット言語を選択できます。言語が選択されていない場合、すべての言語がデフォルトで含まれます。
プレビューが正常に生成されると、Strings に自動的にジョブが作成されます。Strings プロジェクト内のアクティブな ジョブ自動化 は、重複したジョブを避けるためにスキップされます。
プレビューが 10 MB の制限を超えると、キーは Strings にプッシュされますが、プレビュー付きのジョブは作成されません。
備考
Strings エディタで Figma プレビューを扱うには、Figma プレビューを追加 アクションを コンテキストサイドバー で使用します。
-
コンテンツのフォーマットとスタイルを保持 を有効にして、Figma から Phrase にコンテンツをプッシュし、翻訳を引き戻す際にリッチテキストフォーマット（リスト、改行、太字/斜体、リンクなど）を保持します。
有効にすると、HTMLフォーマットタグが自動的に追加され、インラインスタイリングが保持され、Stringsから同期されたジョブを使用して作業する際にTMSのコンテキストプレビューでサポートされます。HTMLフォーマットタグは、StringsエディタとFigmaに戻されたエクスポートされた翻訳に表示されます。
リッチフォーマットが不要な場合は、このオプションを無効にして手動調整を避けてください。
この設定はファイルレベルで適用され、ファイル内で作業しているすべてのコラボレーターに影響します。このオプションは新しいファイルに記憶されます。
接続されたレイヤーについては、関連する省略記号メニューで次のアクションが利用可能です：
-
キーの詳細を表示を選択して、Phrase Stringsでキーの説明を表示/編集するか、キーの文字数制限を設定します。ウィンドウで保存された変更は、エディタページを更新した後、Stringsエディタサイドバーに表示されます。
ヒント
タブで複数のキーを選択し、バッチアクション文字数制限を設定を使用して、選択したすべてのキーに一度に文字数制限を設定します。
-
エディタでキーを開くを選択して、Stringsエディタ内の関連するキーに移動します。
-
Phrase Stringsからコンテンツを切断を選択して、レイヤーを既存のキーから切断します。
重複したコンテンツを管理する
コンテンツをプッシュすると、重複したコンテンツを持つレイヤーは、Strings内に全く同じテキストを含む複数のキーを生成します。ユーザーは、ウィンドウでこの重複したコンテンツをどのように管理するかを決定できます：
-
重複したコンテンツを持つ複数のキーを作成することが意図的な場合は、マージせずに進むを選択します。
-
重複したコンテンツの一部を単一のキーにマージするには、次の手順に従います：
-
リストの最初のキーに重複したコンテンツの一部またはすべてを結合するには、次の手順に従います：
-
リストから複数またはすべてのキーを選択し、
重複をすべて最初のキーに結合をクリックします。
-
進むをクリックし、結合してプッシュを選択して確認します。のポップアップで。
重複したコンテンツは単一のキーに結合され、すべての関連レイヤーはそのキーに接続されます。
このオプションは、多くの重複を含む大きなファイルに便利で、ユーザーがすべての重複を最初に見つかったキーに一度の操作で結合できるようにします。
-
プラグイン設定のセクションでは、接続されたキーの命名規則を設定できます。
Figmaでキー名をカスタマイズするには、次の手順に従います：
-
スマートキー名の有効化を設定からクリックします。
-
を選択します。
備考
が有効になっている場合、キー名はテキストレイヤー名に基づいて自動的に生成されます。
-
フィールドに、カスタムキー名を定義するためのテキストを入力します：
-
オプションで、利用可能なマクロをクリックして、キー名を自動生成するためのサポートされているマクロの1つを選択します。
複数のマクロを選択してキー名を構成することができます。
-
フィールドで自由なテキストとマクロを組み合わせることが可能です。
例をクリックして、事前定義された例の1つを表示して選択します。
-
-
必要に応じて、のドロップダウンから書式設定オプションを選択して、テキストを適切に修正し、スペースを削除します。
コンテンツをプッシュするとき、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の既存のキーにレイヤーを接続するか、新しいキーを生成できます。
タブを選択して、接続されたキーと切断されたキーの概要を表示します。
すでに接続されているキーは、アイコンで列に表示されます。必要に応じて、プロジェクト、ブランチ（使用している場合）、言語を選択するか、検索アイコンをクリックして目的のコンテンツを見つけます。
接続キーを選択して、タブ内のすべての未リンクキーを一括接続します。個別のキーを接続または切断するには、対応するエントリーの右側にある関連アイコンをクリックします。
備考
個別のキーを切断するオプションは、タブにもあります。
翻訳が完了したら、Figmaのレイヤーまたはフレームを選択して、翻訳を取得するためにタブをクリックします。
ユーザーは、プロジェクト、ブランチ（使用している場合）、および取得するコンテンツの言語を選択できます。タグはFigmaに戻すことはできません。
キー名の長いリストを管理するには、ドロップダウンを使用して、し、潜在的な問題に対処します。必要に応じて、特定のキーを選択し、テーブルの上部にあるレイヤーを除外をクリックして、それらのレイヤーをプラグインから削除します。
備考
選択した並べ替えオプションは、今後のセッションで記憶されます。
メニューをクリックして、Figmaで取得したコンテンツの表示方法を選択します：
-
デフォルトで選択されています。複数の言語のためにプルする際には、選択した各言語のために別々のFigmaページが作成され、ページのすべてのレイヤーが含まれます。
備考
Figma Buzzでは、オプションが表示されます。
-
1つの新しいページを作成し、選択した翻訳されたコンテンツを言語ごとの列に並べて配置します。このオプションは、Figmaページ全体を複製するのではなく、アクティブな選択にのみ焦点を当てます。
大きなファイルのプルパフォーマンスを向上させ、不必要なファイルサイズを削減するために推奨されます。
-
選択したテキストレイヤーは翻訳で上書きされ、ビューポートに更新されます。
このオプションは、複数の言語のプル時に自動的に無効になります。
-
デフォルトで無効です。有効にすると：
-
キー名がプルされ、翻訳されたコンテンツの代わりに表示されます。
-
プルされたコンテンツの言語を選択することはもはやできません。
-
-
設定は今後のセッションのために記憶されます。
-
無効にすると、列は選択したレイヤーのコンテンツを直接表示します。
-
有効にすると、列は接続されたレイヤーの選択した言語でのコンテンツのプレビューを表示します。
-
切断されたレイヤーの場合、選択した言語でのプレビューを表示するには、オプションを有効にします。プルされたデータに同じ名前のキーが存在する場合、そのキーのコンテンツがプレビューとして使用されます。
-
このオプションは、複数の言語のプル時に自動的に無効になります。
-
-
Figmaでデータをプルする際に、切断されたレイヤーがどのように処理されるかを制御します。設定は今後のセッションのために記憶されます。
-
有効にすると、システムはプルされたデータに同じ名前のキーが存在するかどうかを確認します。
一致が見つかった場合：
-
切断されたレイヤーは一致するキーに接続されます。
-
レイヤーのコンテンツは、既存のキーからプルされたコンテンツで更新されます。
-
-
無効にすると、切断されたレイヤーは更新されず、プルされたデータに一致するキーが存在しても更新されません。
-
コンテンツがFigmaに正常にプルされると、ウィンドウが表示され、更新されたレイヤーの概要が表示されます。
複数の言語をプルする際、ボタンは、プロジェクトのデフォルト言語をソース言語としてキーを開きます。
Figma Buzzは、ブランドデザイナーとマーケティングチームがFigmaエコシステム内でスケールに合わせてブランドに沿ったビジュアル資産を作成できるツールです。テンプレートのシステム、簡略化されたデザインエディタ、資産の一括作成、AIによる編集が含まれています。
Buzz用のPhrase Stringsプラグインは、Figmaデザイン統合と同じ機能を提供することで、Buzz内でテキストコンテンツを直接ローカライズすることを可能にします：
-
ソーステキストをプッシュ BuzzデザインからStringsへ
-
翻訳をプル Buzzに戻す
-
キーを管理し、資産全体でテキストの一貫性を維持します。
備考
ライブプレビューはサポートされていません。
プラグインはBuzzのメニューから利用可能です。一度アクティブ化されると、将来の使用のために保存でき、Figma Buzzサイドバーからモーダルを開いて選択したデザインで実行できます。テキストレイヤーは自動的に検出され、プラグインに表示されます。
デザインコンテンツは、翻訳のために接続されたStringsプロジェクトにプッシュできます。翻訳後、ユーザーはローカライズされたコンテンツをBuzzに戻すことができ、これによりデザインの翻訳版を含む新しい行が作成されます。