ヒント
Phrase TMSのFigma統合機能については、Figma(TMS)を参照してください。
Figmaプラグインを使用すると、デザインコンテンツをphraseプロジェクトと統合でき、製品設計チームとローカライゼーションチームの橋渡しができます。プラグインは、Figma と Phrase Strings 間のコンテンツのプッシュ、翻訳のプル、およびキーの管理をサポートします。
プラグインを実行するには、Figma のプラグイン ブラウザ内または Figma コミュニティから選択し、［Try it out］ をクリックします。プラグインが Figma メニューで使用できるようになります。
FigmaからPhraseへの接続は、Phrase認証情報またはアクセストークンのいずれかを使用して実行できます。
接続が確立されると、フレームを選択すると、Figmaコンテンツとキーのプレビューが読み込まれ、ユーザーがPhrase Stringsからpush toまたはpullできます。
「」タブでは、Strings プロジェクトにすでに存在するキーに Figma レイヤーを接続できます。レイヤーとキーの命名規則が同じ場合は、自動的に一致させることができます。
プラグインには、Figmaサイドバーの専用ボタンからアクセスできます。
-
Phrase Strings
クリックしてプラグインを開きます。
-
Strings のテキストを表示
Strings プロジェクトに接続されている Figma ファイルに表示されます。クリックして翻訳エディタで関連プロジェクトを開きます。
タブでは、フレームまたはテキスト レイヤーをFigmaからPhrase Stringsに送信してローカライズできます。保護されたメイン ブランチにコンテンツを push することはできません。
プロジェクト、ブランチ (使用中の場合)、およびプッシュされるコンテンツの言語の選択。オプションで、アップロードされたキーに追加するカスタムタグを入力します。
必要に応じて、 メニューをクリックして、次のpushオプションのオンとオフを切り替えます。
-
スクリーンショットアップロードはデフォルトで有効になっています。枠内に選択したレイヤーのスクリーンショットを添付することができます。
-
設定が有効になっている場合、Figmaプラグインでインポートされた非表示テキスト レイヤーは、スクリーンショットの左上隅にマーカーが表示されます。
-
[を除外] 設定が有効になっている場合、Figmaセクションのスクリーンショットは作成されません。
セクション内で作業中にプラグインにパフォーマンス上の問題が発生した場合に備えて、このオプションを有効にしておくことをお勧めします。
-
-
Phrase Strings の更新コンテンツはデフォルトで有効になっています。
-
Phrase Stringsのキー名更新は、 名の仕事 設定が無効でない限り、デフォルトで有効になっています。
このオプションをオフに切り替えると、すべてのキー名の入力がリセットされます。
キー名が empty または duplicate の場合、列に赤いカウンタが表示されます。キー名の長いリストを管理するには、 ドロップダウンを使用して、またはを最初に表示します。
備考
選択した並べ替えオプションは、以降のセッションで記憶されます。
保護されたメインブランチが選択されている場合、キー名の入力が empty で、無効な文字が含まれており、一意でない場合、push to phrase ボタンは無効になります。
キー名の入力を編集し、名前の競合を解決する 設定を選択。必要に応じて、必要なキーを選択し、表の上部にある「レイヤー除外」をクリックして、プラグインからレイヤーを削除します。
キー名が矛盾する切断済レイヤーがある場合、利用可能な解決オプションのいずれかを選択して続行します。
-
接尾辞
が-copyの新しいキーを作成します。 -
レイヤーを既存のphraseにリンクします。
-
矛盾のないレイヤーのみをプッシュします。
レイヤが Strings に正常にプッシュされると、概要と次のオプションが示された ウィンドウが表示されます。
-
ジョブ作成
クリックして、押したキーが事前に選択された ページを開きます。
-
Stringsで開く
Strings エディタでプッシュされたキーを表示するにはクリックします。
プラグイン設定 のセクションでは、接続されたキーの命名規則を設定できます。
Figma のキー名をカスタマイズする手順は、次のとおりです。
-
の設定からスマート キー命名の有効化をクリックします。
-
名付き仕事を選択。
備考
「を同期」が有効になっている場合、キー名はテキストレイヤー名に基づいて自動的に生成されます。
-
［］ フィールドに、カスタム キー命名を定義するテキストを入力します。
-
必要に応じて、［ ドロップダウンからフォーマット オプションを選択して、それに応じてテキストを変更し、スペースを削除します。
Phrase Strings にコンテンツをプッシュする場合、以前に接続したキーに新しく作成された命名規則を次のいずれかで適用します。
-
テーブル下部にある「refresh
」アイコンをクリックします。
-
特定のキーを選択し、テーブル上部にある ［Regenerate key names］ をクリックします。
使用可能なマクロ
|
マクロ |
概要 |
|---|---|
|
{file_name} |
Figmaファイルの名前 |
|
{page} |
キーが識別されるFigmaページ |
|
{parent_section} |
ページツリーの最上位セクション |
|
{nearest_section} |
ページツリーのテキストレイヤーに最も近いセクション |
|
{frame} |
キーが識別されるフレーム |
|
{parent_group} |
ページツリーの最上位グループ |
|
{nearest_group} |
ページツリーのテキストレイヤーに最も近いグループ |
|
{component} |
キーのある Figma コンポーネントの名前。原文コンポーネントのみが考慮されます。 |
|
{element_name} |
テキストレイヤーの名前 |
|
{element_content} |
テキストレイヤーのコンテンツ |
|
{random} |
ランダムに生成された一意の短いハッシュ |
コンテンツをプッシュする際、ユーザーはPhrase Stringsの既存のキーにレイヤーを接続するか、新しいキーを生成できます。
タブを選択すると、接続キーと切断キーの概要が表示されます。
すでに接続されているキーは、「」列にリンク アイコンで識別されます。必要に応じて、プロジェクト、ブランチ (使用中の場合)、および言語を選択するか、検索アイコンをクリックして目的のコンテンツを見つけます。
キーの接続を選択すると、タブ内のすべてのリンクされていないキーが一括接続されます。個々のキーを接続または切断するには、対応するエントリーの右側にある関連アイコンをクリックします。
備考
個々のキーの接続を切断するオプションは、 タブにもあります。
翻訳が完了したら、pull translationsの対象となるFigmaレイヤーまたはフレームを選択し、 タブをクリックします。
ユーザーは、プルするコンテンツのプロジェクト、ブランチ（使用中の場合）、および言語を選択できます。tags cannot be pull back to Figma.（タグをFigmaに戻すことはできません。）
キー名の長いリストを管理するには、 を使用して、を最初に表示し、潜在的な問題に対処します。必要に応じて、特定のキーを選択し、表の上部にある「レイヤー除外」をクリックして、プラグインからレイヤーを削除します。
備考
選択した並べ替えオプションは、以降のセッションで記憶されます。
のメニューをクリックして、Figmaでプルされたコンテンツの表示方法を選択します。
-
デフォルトで選択されています。
-
選択したテキストレイヤーは翻訳で上書きされ、ビューポートで更新されます。
-
デフォルトでは無効。有効時：
-
キー名が翻訳コンテンツの代わりに表示されます。
-
プルされたコンテンツの言語を選択できなくなりました。
-
-
この設定は、以降のセッションで記憶されます。
-
無効にした場合、列には選択したレイヤーのコンテンツが直接表示されます。
-
有効にすると、列に、選択した言語で接続されたレイヤーのコンテンツのプレビューが表示されます。
-
未接続のレイヤーについては、 と接続 オプションを有効にすると、 選択した言語でプレビューを表示できます 。抽出されたデータに同名のキーが存在する場合は、そのキーのコンテンツがプレビューとして使用されます。
-
-
-
Figmaでデータを抽出する際に、切断されたレイヤーを処理する方法を制御します。この設定は、以降のセッションで記憶されます。
-
有効にすると、システムは抽出されたデータに同名のキーが存在するかどうかを確認します。
一致が見つかった場合：
-
未接続のレイヤーは一致するキーに紐づけされます。
-
レイヤーのコンテンツは既存のキーから抽出されたコンテンツで更新されます。
-
-
無効にした場合、プルされたデータに一致するキーがあっても、切断されたレイヤーは更新されません。
-
コンテンツがFigmaに正常にプルされると、ウィンドウに更新されたレイヤーの概要が表示されます。