# General Translation Integrations: 支持的内容
URL: https://generaltranslation.com/zh/docs/integrations/payload/reference/supported-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 了解插件会翻译、保持不变或跳过哪些 Payload CMS 字段。gt-payload 支持内容的参考文档。

该插件会遍历 Payload 扁平化后的字段 schema，且仅翻译启用了本地化的文本。它会保留字段结构，以便通过 Payload Local API 将结果写回。

## 概览 [#overview]

| 主题                          | 说明                         |
| --------------------------- | -------------------------- |
| [已翻译的字段](#translated-fields) | 已本地化的 text、textarea 和富文本值。 |
| [嵌套内容](#nested-content)     | 组、标签页、数组、块以及富文本块。          |
| [保持不变的字段](#preserved-fields)   | 直接复制或保持不变的值。               |
| [字段排除](#field-opt-out)      | 按字段配置排除文本。                 |
| [字符数限制](#character-limits)  | Payload 与 SEO 的长度处理方式。     |
| [保存行为](#save-behavior)      | 草稿、直接保存和发布的处理方式。           |

## 已翻译的字段 [#translated-fields]

该插件会翻译以下已本地化字段中的非空值：

* `text` 字段，包括 `hasMany` 列表
* `textarea` 字段
* Lexical `richText` 字段

Payload 的默认区域设置即为源语言。其他所有受支持且已配置的区域设置均可作为翻译目标。

从源内容中删除的文本，会在下次运行时从对应的已翻译区域设置中一并删除。如果某个区域设置未被请求作为目标，或不存在可翻译的源文本，则不会为其启动翻译任务。

## 嵌套内容 [#nested-content]

可翻译字段可能出现在以下位置：

* 组和命名标签页
* 数组
* 块 (包括块引用) 
* Lexical 块和内联块字段

已本地化的容器会按区域设置分别保留各自的行。共享的数组和块会按 Payload ID 匹配行，确保翻译后的文本写回对应的源行。

## 保持不变的字段 [#preserved-fields]

该插件不会翻译以下内容：

* 未设置 `localized: true` 的字段，除非它们位于已本地化的容器内
* Payload slug 字段
* 只读、隐藏或虚拟字段
* 被识别为路径、URL 或电子邮件地址的 `text` 值 (`textarea` 和富文本则会照常翻译) 
* 非文本字段类型，例如关系、上传、日期、数字、复选框和 JSON
* Payload 行元数据，例如 ID 和块类型名称

对于不翻译的必填字段，如果目标区域设置中没有值，则会填入源值，以便 Payload 能够保存该区域设置。在 Payload 本地化结构支持的范围内，保持不变的字段中已有的目标区域设置值不会被修改。

富文本节点会保留标记、链接、上传内容、块和格式。如果翻译后的标记无法与源结构安全匹配，插件会跳过该字符串并报告 `broken_markup`。

## 字段排除 [#field-opt-out]

将字段的 `custom.gt.translate` 设置为 `false`，即可将该字段排除在翻译之外：

```ts title="src/collections/products.ts"
{
  name: 'sku',
  type: 'text',
  localized: true,
  custom: {
    gt: {
      translate: false,
    },
  },
}
```

如果在包含可翻译子孙字段的父字段上设置该选项，这些子孙字段也会一并被排除。

## 字符数限制 [#character-limits]

当译文超出字段的 `maxLength` 时，插件会请求更短的译文。如果译文仍超出硬性限制，插件会在单词边界处截断译文，并添加该区域设置对应的省略号字符。

由 Payload SEO 插件渲染的字段采用以下推荐限制：

| 字段               | 推荐长度    | 硬截断                      |
| ---------------- | ------- | ------------------------ |
| Meta title       | 60 个字符  | 仅当该字段同时设置了 `maxLength` 时 |
| Meta description | 150 个字符 | 仅当该字段同时设置了 `maxLength` 时 |

SEO 推荐值会触发更短译文的请求，但本身不会截断译文。

## 保存行为 [#save-behavior]

该插件会在禁用区域设置后备内容的情况下，读取源区域设置和目标区域设置的最新草稿，并通过 Local API 写入：

* 启用草稿时，保存为草稿。
* 未启用草稿时，直接保存。
* 从不发布。

在管理后台发起的读取和写入操作遵循当前登录用户的 Payload 访问规则。程序化调用可以传入一个 Payload 用户来执行相同的规则；若未传入，Payload Local API 将沿用其常规的 server-side 访问行为。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.