Payload 内容制品

翻译选定的 Payload CMS 字段和受支持的 Lexical 文本,同时保留提供方回写所需的结构。

Payload 页面不仅包含可读内容,还包含 ID、关联关系、上传文件和编辑器结构。集成会先选取本地化字段,将其组合成待翻译的制品,再由 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 文档,检查普通字段和富文本。逐一访问链接、检查嵌入的关联关系,并将目标内容的字段覆盖范围与源内容中选定的字段进行比较。制品重建不会授予提供方写入权限,也不会判断内容是否已达到发布要求。