Payloadのコンテンツアーティファクト

プロバイダーへの書き戻しに必要な構造を保ちながら、選択したPayload CMSのフィールドと、サポート対象のLexicalテキストを翻訳します。

Payloadのページには、読者向けのコンテンツだけでなく、識別子、リレーション、アップロード、エディターの構造も含まれています。連携機能はまず、ローカライズ対象のフィールドを選択し、翻訳用のアーティファクトにまとめます。その後、payloadハンドラーが、アーティファクト内のサポート対象の単純な値とLexicalテキストを翻訳します。

コンテンツの選択と書き戻しには、Payload連携を使用してください。フィルタリングしていないCMSレコードを直接送信すると、プロバイダーによるフィールド選択が行われず、翻訳を意図していないデータまで含まれる可能性があります。

選択したフィールドとリッチテキスト #

選択したフィールドをまとめたアーティファクトには、タイトルやLexicalツリーを含めることができます。

json
{
  "title": "Delivery options",
  "body": {
    "root": {
      "type": "root",
      "children": [
        {
          "type": "paragraph",
          "children": [{ "type": "text", "text": "Choose your delivery method.", "format": 0 }]
        }
      ]
    }
  }
}

翻訳対象となるのは、タイトルとサポート対象のテキストコンテンツです。Lexicalのノード型、書式データ、サポート対象のインライン構造は、再構築の手がかりとなります。リンク先、アップロード、リレーション、構造を定義するブロックフィールドは、文字列を含んでいるだけでは文章として扱われません。ただし、サポート対象のブロックフィールド内で選択されたローカライズ対象のテキストは、プロバイダー側でフィルタリングした後に翻訳できます。

Lexicalでは、サポート対象のテキストのまとまりについて、書式とインライン構造が保持されます。カスタムノードについては、サポート対象の表現形式に適合しているか確認が必要です。Lexicalに対応していても、あらゆるエディターの文書ツリーに対応しているわけではありません。

翻訳元と翻訳先の対応付け #

翻訳元と翻訳先のフィールドパスによって、対応する値を特定します。以前の翻訳元がない状態で既存の翻訳先が渡されると、ハンドラーは対応する翻訳先の既存値を採用し、値がない箇所を翻訳します。記録上初めての同期だからといって、既存のローカライズ済みフィールドをすべて上書きするわけではありません。

以前の翻訳元がある場合は、翻訳元で変更された単位と、翻訳先の値が欠けている箇所が処理対象になります。既存のCMSドキュメントも、一部しか翻訳されていない可能性があるため、存在するだけで翻訳が完了しているとは判断できません。再構築では、選択した翻訳元のアーティファクトを基に、サポート対象の翻訳済みの値や保持された値を挿入します。元のバイト列を保持するのではなく、JSONとしてシリアライズします。

編集後は、リッチテキストの対応関係を確認する必要があります。一部の単語が変わっていなくても、段落構造やカスタムノードの変更が対応関係に影響する場合があります。アーティファクトの妥当性だけでなく、処理後のCMSフィールドと、実際に表示されるコンテンツも確認してください。

選択から書き戻しまでをつなぐ #

Payload連携は、スキーマの選択、ロケールの読み取り、接続設定、書き戻しを担います。プラグインのエクスポートについては、Payload CMSパッケージに記載されています。選択したフィールドを正しいドキュメントとロケールに書き戻せるよう、アーティファクトハンドラーの前後に、これらのプロバイダー側の手順を組み込んでください。

書き戻し後は、ローカライズ済みのCMSドキュメントを開き、通常のフィールドとリッチテキストの両方を確認してください。リンクをたどり、埋め込まれたリレーションを確認し、翻訳先に含まれるフィールドの範囲を翻訳元で選択した範囲と比較してください。アーティファクトの再構築によって、プロバイダーへの書き込み権限が付与されたり、コンテンツを公開できる状態かどうかが判断されたりすることはありません。