# General Translation Integrations: 受支持的内容
URL: https://generaltranslation.com/zh/docs/integrations/mintlify/reference/supported-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 了解 Mintlify 项目中哪些文件和内容会被翻译。Mintlify 支持的内容参考。

本页明确列出 General Translation 在 Mintlify 项目中会翻译哪些内容、哪些内容保持不变，以及哪些文件始终会被排除。

## 概览 [#overview]

| 主题                    | 说明                          |
| --------------------- | --------------------------- |
| [已翻译内容](#translated)  | 已翻译的页面、frontmatter、代码片段和导航。 |
| [保留内容](#preserved)    | 翻译绝不会修改的代码和结构。              |
| [排除的文件](#excluded)    | 始终会被跳过的代码仓库文件。                |
| [项目要求](#requirements) | 代码仓库满足有效 Mintlify 项目的要求。      |

## 已翻译的内容 [#translated]

Locadex 会翻译你文档中供人阅读的内容。

### 页面

所有与已配置的 glob 模式匹配的 `.mdx` 和 `.md` 文件都会被翻译。翻译在 Markdown/MDX 语法层面进行，因此标题、段落、列表、表格、提示块、链接和自定义组件都会保留其结构。General Translation 还会在每个翻译后的标题上写入 Mintlify 原生的 `{#id}` 语法 (`experimentalAddHeaderAnchorIds: 'mintlify'`)，并复用源标题的 ID，从而使页内链接在不同语言版本中指向相同的目标。

### Frontmatter

页面标题、描述等 Frontmatter 字段也会被翻译，以确保导航标签和 SEO 元数据在各种语言中都能正常发挥作用。如果页面没有显式指定标题，Mintlify 会根据文件名推断标题 (`mintlify.inferTitleFromFilename`) 。

### 代码片段

`snippets/` 下的可复用代码片段会通过 `docsImportPattern` (`/snippets/[locale]`) 进行翻译和本地化，因此导入的内容会以读者所用的语言提供。

### 导航

`docs.json` 会使用 Mintlify 预设进行本地化：导航标签会被翻译，导航结构也会调整为 Mintlify 的多语言布局，每种语言对应一个条目。

在 show-default-locale 模式下，Locadex 预设还会对现有顶层重定向的源路径和目标路径进行本地化。Locadex 不会新建重定向条目。直接使用 CLI 的工作流可以选择启用：针对在同一次运行中被重命名或删除的页面，为其关联的重定向添加本地化副本。 (参见 [`options.mintlify.localizeRedirects`](/docs/integrations/mintlify/reference/config#localized-redirects)。)

### OpenAPI 规范

Locadex 会检测存储在 `.json`、`.yaml` 或 `.yml` 文件中的 OpenAPI 3.x 规范。它会翻译其中的 `summary` 和 `description` 字段，将翻译后的各个规范写入相应区域设置的目录中，并将这些本地化文件注册到 Mintlify。

## 保留的内容 [#preserved]

翻译绝不会改动以下内容：

* 代码块、内联代码和语法高亮。只有正文中的注释和文档字符串会被翻译。
* 自定义 MDX 组件、链接和格式。
* 文件结构——翻译不会重命名或重组你的组件或代码。

## 排除的文件 [#excluded]

区域设置文件夹本身会被排除，以避免翻译后的输出被再次翻译。此外，以下这些代码仓库中的常见文件也始终不会被纳入翻译范围：

| 文件               | 文件                   |
| ---------------- | -------------------- |
| `README.md`      | `HISTORY.md`         |
| `LICENSE.md`     | `CODE_OF_CONDUCT.md` |
| `COPYING.md`     | `CONTRIBUTING.md`    |
| `NOTICE.md`      | `SECURITY.md`        |
| `CHANGELOG.md`   | `GOVERNANCE.md`      |
| `AGENTS.md`      | `OWNERS.md`          |
| `MAINTAINERS.md` |                      |

如果你的代码仓库将可翻译内容保存在这些文件之一中，请在 setup 完成后调整生成的[配置](/docs/integrations/mintlify/reference/config)中的 `exclude` 列表。

## 项目要求 [#requirements]

General Translation 会在 setup 之前验证代码仓库，并拒绝不是有效 Mintlify 站点的项目：

* 代码仓库必须包含一个 `docs.json`，其 `$schema` 必须指向 Mintlify (`mintlify.com/docs.json`) 。
* 仍在使用旧版 `mint.json` 的项目会被拒绝——请先迁移到 `docs.json`。
* 看起来像 Next.js 应用的项目 (包含 `next.config.*` 文件) 会被拒绝，因为 Mintlify 工作流仅适用于 Mintlify 文档站点。

## Sitemap

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