ヒント
Phrase Strings の Contentful 統合機能については、Contentful (Strings) を参照してください。
Contentfulは、あらゆるプラットフォームやデバイスにコンテンツを作成、管理、配信するためのコンテンツ管理インフラストラクチャを提供します。phraseは、コネクターベースの統合機能とContentful Marketplaceのプラグインの両方を提供し、よりカスタマイズされたユーザーエクスペリエンスを実現します。
備考
コネクターは JSON オブジェクトの翻訳をサポートしていません。
サポートされているローカライゼーション方法
Contentful は複数のローカライゼーション方法をサポートしています。詳細については、Contentful のドキュメントを参照してください。
エントリーレベルのローカライゼーション(従来)
Contentful (エントリーレベル) コネクターを使用。
エントリーレベルのコネクターは、ローカライズされた参考資料フィールドを持つコンテンツタイプ (たとえば、ローカライズが有効になっている「ローカライズ済」という参考資料フィールド) にのみ対応します。
フィールドレベルのローカライゼーション (従来)
Contentful (Field-Level) コネクターを使用。
フィールド レベルのコネクターは、翻訳可能なフィールド (たとえば、ローカリゼーションが有効になっているテキストまたはリッチ テキスト フィールド) とメディア アセットを持つコンテンツ タイプに対してのみ機能します。コネクターが参照エントリをインポートするよう設定されている場合、ネストされたコンテンツの階層全体を検索し、翻訳可能なフィールドをすべてインポートします。参考資料フィールドがローカライゼーションに対応している場合、プロジェクトの原文言語に一致する参考資料がインポートされます。
コネクターにはいくつかの使用例があります。
-
プロジェクトマネージャは、ファイルをオンラインリポジトリからプロジェクトに直接追加できます。コンテンツはエントリーIDで検索可能です。
-
提出者がオンライン リポジトリから直接ファイルをリクエストに追加できるように Submitter Portal を設定コンテンツはエントリーIDで検索可能です。
-
プロジェクト自動作成(APC)を使用して、監視対象のドキュメントまたはフォルダのコンテンツ サイズの変更が検出されると、新しいプロジェクトが自動的に作成されます。
-
選択したファイルはAPCの初回実行時にインポートされます。
-
アプリケーションの使用例:
-
コンテンツ編集者は、ローカライゼーションのエントリーをContentful内から直接送信できます。コンテンツ編集者やマネージャは、ローカライゼーションフローを完全にコントロールでき、エントリーを表示したときにステータスをその場で更新できます。
エントリーが完了したら、次の手順を実行します。
-
ローカライゼーションの訳文言語を選択します。
-
選択した言語のエントリーのみをPhrase TMSに送信するか、フィールド選択タブを使用してフィールドを選択します。
-
フィールドが選択されていない場合、Localizable フィールドはすべて翻訳対象として送信されます。
-
Localizableなフィールドが選択されても、そのフィールドは翻訳対象として送信されません。Localizable フィールドのみが送信されます。
-
Localizable フィールドの一部のみを選択した場合、それらのフィールドのみが翻訳対象として送信されます。
-
-
APC設定に基づき、ジョブは提出されたコンテンツから自動的に作成されます。APC実行中、ジョブ作成は送信ステータスのエントリのみが取得されます。
-
提出されたエントリーのジョブが作成されると、ステータスは進捗中に変わります。翻訳が Contentful にプッシュバックされると、ステータスは完了済に変わります。
-
過去に翻訳した内容は、原稿の変更後に再度提出することができます。
-
-
コンテンツエディタでは、Phrase TMSホーム画面を使用して次のことが可能です。
-
エントリを一括送信。
-
一括送信時に個々の訳文言語を指定します。
-
アクティブな翻訳ジョブの概要を把握している。
-
Contentful 設定
Phrase TMSアプリケーションを使用する場合:
-
MarketplaceからPhrase TMSアプリケーションをダウンロードします。
-
現在のアクティブなスペースにアプリケーションをインストールし、アプリケーションのインストールが必要なコンテンツモデルを選択します。
-
Phrase TMS 内でのコネクター作成時に取得した Phrase TMS 認証トークンを入力します。
-
「インストール」をクリックします。
オプション - アプリの起動
Contentful によるアプリ起動経由でワークフロー サポートを使用する場合は、次の手順に従います。
-
Contentful の Launch アプリケーションを 1 つまたは複数のスペースにインストールします。
備考
スペースごとに作成できるワークフローは 1 つだけです。1つのContentfulスペース内でコンテンツの種類ごとに異なるアプローチが必要な場合は、専任のお客様サクセスマネージャーにお問い合わせください。
-
必要なローカライゼーションワークフロー設定。
-
コンテンツ タイプまたは説明のワークフローに従うタイプを選択。
コネクターにワークフローが設定されている場合、監視対象記事またはコンテンツ タイプのワークフロー ステップ の変更が検出されると、プロジェクト自動作成 (APC) が自動的に新しいプロジェクトを作成します。
送信済ジョブをキャンセルして、変更後のコンテンツ再送信を許可できます。これらのジョブは今後もphraseに存在し続けるため、プロジェクトマネージャが削除する必要があります。
注意
カスタムドメイン (mydomain.phrase.jp
など) からアクセスする場合は、incognito ブラウザウィンドウを開き、cloud.memsource.com
または us.cloud.memsource.com
経由でログインして、コネクターの作成または保存に必要な認証を適用します。保存後、コネクターにカスタムドメイン経由でアクセスできます。
-
設定
ページから、 セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
新規コネクターをクリックします。
ページが開きます。
-
接続の名前を入力し、 タイプ を Contentful (エントリレベル) または Contentful (フィールドレベル) に変更します。
-
アプリでコネクターを使用する場合は、「Phrase Contentful App」チェックボックスを選択。
-
Contentful Appトークン
Phrase TMS Contentful アプリケーションに入力するアプリケーション トークンを生成します。トークンを生成して Contentful App にコピーしたら、コネクターを保存します。
備考
Contentful でアプリケーション設定に追加されたトークンは、Contentful 内から変更できません。トークンを変更するには、コネクター設定で取り消し、新しいトークンを生成して Phrase TMS への新しいコネクターを作成します。
-
-
言語に依存しない設定を行います。
-
スペースを選択
Contentful スペースのデフォルト言語を上書きする原文言語を設定するには、スペースを選択します。
-
環境を選択
設定されたスペースの環境を選択
-
原文言語
原文言語を選択して Contentful のデフォルト言語を上書きします。コネクターはその後、コネクター設定で設定した言語からコンテンツを pull in します。
例:
備考
アプリケーションを使用する場合、適用されません。
-
-
エントリー インポート モードでネストされたコンテンツの処理方法を選択。コンテンツは参考資料フィールドを使用して他のコンテンツを参考資料し、エンティティの階層を作成できます。
-
Contentful (エントリーレベル)
エントリーレベルのコネクターは、ネストされたコンテンツの階層全体を自動的に走査します。
-
Contentful(フィールドレベル)
フィールドレベルのコネクターがネストされたコンテンツをインポートする方法を選択。
-
-
リポジトリからの追加時に明示的に選択されたコンテンツがインポートされます。
-
APCで検出された変更は翻訳用にインポートされます。
-
-
参照エントリのインポート
-
コネクターは、ネストされたコンテンツの階層全体を検索し、翻訳可能なフィールドをすべてインポートします。
-
-
-
-
「翻訳可能フィールドを省略」にコンマ区切りの一覧を作成して、Phrase TMS へのインポートから のローカライゼーションを有効にするにチェックがオンになっているフィールドを省略します。
contentTypeID:fieldID
構造を使用します。-
リストされているフィールドを空のままにする場合は、[Leave omitted fields empty] を選択します。この設定はリストされているすべてのエントリに適用されます。
-
リストされているフィールドに原文の値を含める必要がある場合は、原文を訳文にコピーを選択。この設定はリストされているすべてのエントリに適用されます。
-
-
原文言語の特定のフィールドでデータが失われている場合は、予備
を選択。必要に応じて、ドロップダウンリストから
を選択します。この言語ロケールは、欠落データがある場合に適用されます。備考
Contentful フォールバック言語とこの設定には関係ありません。
-
必要に応じて、
(ベータ) を入力します。これは Contentful のレンダリング コンテンツに導く URL テンプレートです。以下のプレースホルダーが利用できます:
-
{env_id}
:環境ID -
{entry.sys.id}
:エントリーID -
{space_id}
:スペースID
URL テンプレートは次のようになります。
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
備考
この URL は、Contentful コンテンツをレンダリングする 配備されたアプリケーションに繋がる必要があります。ライブプレビューを使用するには、URL テンプレートの
contentfulapp.tld
をアプリケーションの実際のドメインに置換します。コンテンツ プレビューの設定の詳細については、Contentful のマニュアルを参照してください。
ロケールは現在プレースホルダーとして使用できません。URL でロケールを使用するには、固定値を指定し、複数のコネクターインスタンスを作成してください。
-
-
テクニカルサポートチームから Debug 情報のロギングを依頼された場合は、
を選択。 -
Contentful に接続をクリックします。
接続が成功すると、コネクターのセットアップにチェックマークが表示されます。そうでない場合、赤い感嘆符が表示されます。アイコンにカーソルを合わせると、詳細が表示されます。
-
Contentful (エントリーレベル) のみ:
原文言語を設定する
備考
この言語は、Contentful のロケール設定で設定された Contentful スペースのデフォルト ロケールと一致する必要があります。
-
保存をクリックします。
コネクターが
ページの一覧に追加されます。 -
オプションで、コネクターを編集して
を選択。-
:
コネクターは、選択したステージ(例: 要翻訳)の記事を監視します。翻訳の準備ができたら、作成者は、このラベルを記事に適用できます。
Contentful からのインポート時:
-
原文記事がダウンロードされると、コネクターはワークフローをあらかじめ選択したステージ(たとえば「翻訳進捗中」)に進めます。
Contentful へのエクスポート時:
-
翻訳がエクスポートされると、コネクターは原文記事のワークフローを選択済のステージ(例:翻訳完了)に設定します。
備考
ワークフローサポートはContentfulによって2023年6月1日に終了されました。継続使用はサポートされていません。
-
備考
Contentful 起動アプリとライブプレビューは 2.0 コネクターではサポートされていません。
-
設定
ページから、 セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
新規コネクターをクリックします。
ページが開きます。
-
「型」を Contentful 2.0 に変更。
-
コネクターの名前を入力します。
-
Contentful 2.0 に接続をクリックします。
Contentful ログイン ウィンドウが開きます。
-
ログイン情報を入力し、[ログイン]をクリックします(または、別のログイン方法を使用)。ログイン ウィンドウが閉じて、 ] と表示されます。
-
アプリでコネクターを使用する場合は、「Phrase Contentful App」チェックボックスを選択。
-
トークン生成をクリックします。
ウィンドウが開きます。
-
トークン生成をクリックします。
クリップボードまたはテキスト ファイルにコピーする必要のあるトークンが生成されます。トークンは再度表示されないため、ウィンドウを閉じる前にコピーしてください。このトークンはアプリに接続するときに使用されます。
-
ウィンドウを閉じると、
が表示されます。
-
-
Contentful tags を使用してコンテンツを識別している場合は、タグ ID を入力して Enter キーを押します。
ID は提示され、さらに追加できます。
-
必要に応じて、
(ネストされたコンテンツ)] を選択します。ネストされたすべてのコンテンツがジョブのインポートと作成に含まれます
-
必要に応じて、
を選択。このエイリアスは、すべてのAPCモニタリングおよびジョブの再インポート/エクスポートで使用されます。訳文エイリアスが今後変更される場合、APCは新しい訳文に含まれるコンテンツをモニタリングし、ジョブは新しい訳文エイリアスに再インポートまたはそこからエクスポートされます。
-
(デフォルトおよび推奨)
APCと作成されたジョブは、ジョブ/APC作成時にエイリアスが指していた環境に関連づけられています。APCはその環境とコンテンツのみを監視します。ジョブはAPCにエクスポートされ、再インポートされます。
-
APCと作成されたジョブは、エイリアス自体に関連づけられています。APCはそのエイリアスとコンテンツのみを監視します。ジョブはAPCにエクスポートされ、再インポートされます。
エイリアスの訳文が変更されると、APCは新しいエイリアスの訳文(環境)を監視します。ジョブのエクスポートと再インポートが行われます。
-
-
必要に応じて、phraseへのインポートから除外する必要があるContentIDを入力します。
-
に の を提供する。
プレビュー API では、これらのフィールドが必要です。この API を使用した Contentful 2.0 統合機能は、インポートと変更監視 (APC) に使用されます。
-
Contentful からモニタリングまたはインポートする各スペースと環境を選択。
-
セットアップとアクセスは Contentful 内から行います。
-
-
保存をクリックします。
コネクターが
ページの一覧に追加されます。