EmailifyでLocize APIを使う
Locizeをお使いの場合、Emailifyでメールデザインの原文をLocizeのネームスペースにアップロードし、翻訳されたバリエーションをFigmaにインポートできます。
始める前に
次のものが必要です。
- 参照言語と、1つ以上の翻訳先の言語が設定されたLocizeプロジェクト
- メールの翻訳用の既存のバージョンとネームスペース
- プロジェクト単位のLocizeのAPIキー
ステップ1：Locizeプロジェクトを接続する
- EmailifyのLocalizeボタンをクリックします。
- ローカライズのオプションからLocize APIを選択します。
- Project IDとAPI Keyを入力します。
- 使用するLocizeのVersion（
latestやproductionなど）を入力します。 - メールの翻訳が含まれるNamespace（
emailsなど）を入力します。 - Locizeプロジェクトに合わせて、Standard CDNまたはPro CDNを選択します。
- String Key Sourceで、EmailifyがLocizeの文字列キーを作成する方法を選びます。
Emailifyが接続されると、Locizeプロジェクトで設定されている参照言語と翻訳先の言語が表示されます。
CDNの種類がLocizeプロジェクトと一致していることを確認してください。Standard CDNは公開型で、キャッシュ時間は1時間で固定されています。一方、Pro CDNは非公開での公開とキャッシュの設定に対応しています。詳しくはLocizeのCDNの比較をご覧ください。
Locizeの文字列キーの作成方法を選ぶ
Figma Node ID (Default) は、これまでのEmailifyの動作を維持し、生成されたFigmaのノードIDをLocizeのキーに使用します。既存のLocizeのワークフローは、設定を変更しない限りこのオプションを使い続けます。
Figmaのテキストレイヤー名が、Locizeのネームスペース内の文字列キーとすでに一致している場合は、Figma Text Layer Nameを選択します。Emailifyはドットを含むレイヤー名をそのまま保持するため、templates.assistant_invited.h01という名前のレイヤーには、そのままのLocizeキーが使われます。
対象となるテキストレイヤーにはすべて名前が必要で、選択したメール全体で一意でなければなりません。重複するキーがある場合、Emailifyは原文の文字列をLocizeに送信する前にアップロードやインポートを停止し、重複しているキーを示します。リンクと画像の代替テキストのキーには、テキストレイヤーまたは画像レイヤーの名前に、Emailifyの_LINKまたは_ALT_TEXTサフィックスを付けたものが使われます。件名とプリヘッダーの行は、Figmaのテキストレイヤーではなくメールのメタデータであるため、引き続きEmailifyが生成するキーを使用します。
ステップ2：メールと翻訳先のロケールを選択する
ローカライズしたいEmailifyのフレームを選び、あとでインポートするLocizeの翻訳先の言語を選択します。
メールの文章に、翻訳の往復で保持したい太字、斜体、リンク付きテキスト、改行が含まれている場合は、Import Markdown Formattingを有効のままにしておきます。
ステップ3：参照用の原文をLocizeにアップロードする
Uploadをクリックすると、選択したEmailifyのテキストが、Locizeで設定されている参照言語としてネームスペースに送信されます。あとでFigmaの原文を更新した場合は、もう一度アップロードして、対応するLocizeのキーを更新してください。
ステップ4：Locizeで翻訳する
Locizeプロジェクトを開き、アップロードされたキーを翻訳先の言語ごとに翻訳またはレビューします。
ステップ5：翻訳されたメールをFigmaにインポートする
Emailifyに戻り、必要な翻訳先のロケールを選択してImport Translationsをクリックします。Emailifyは翻訳されたLocizeのキーを選択した原文のメールに対応付け、インポートしたロケールごとにメールフレームの複製を作成します。
EmailifyはLocizeのAPIキーを、共有のFigmaファイルではなく、現在のユーザーのFigmaのローカルクライアントストレージに保存します。より広い権限を持つ個人用アクセストークンではなく、プロジェクト単位のAPIキーを使用してください。