# General Translation Integrations: 受支持的内容
URL: https://generaltranslation.com/zh/docs/integrations/mintlify/reference/supported-content.mdx
---

title: 受支持的内容
description: General Translation 在 Mintlify 项目中支持翻译的文件和内容参考。Mintlify 支持的内容参考。

---

# 支持的内容

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

## 概览 [#overview]

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

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

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

### 页面

所有与已配置的 glob 模式匹配的 `.mdx` 和 `.md` 文件都会被翻译。翻译在 Markdown/MDX 语法层面进行，因此标题、段落、列表、表格、提示块、链接和自定义组件都会保留其结构。General Translation 还会添加稳定的标题锚点 ID (`experimentalAddHeaderAnchorIds: 'mintlify'`) ，以确保页内链接在不同语言版本中仍能正常工作。

### Frontmatter

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

### 代码片段

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

### 导航

`docs.json` 会使用 Mintlify 预设进行本地化：导航标签会被翻译，导航结构也会调整为 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 文档站点。