# General Translation Integrations: 翻译内容
URL: https://generaltranslation.com/zh/docs/integrations/mintlify/guides/translating-content.mdx
---
title: 翻译内容
description: 如何翻译 Mintlify 文档，以及 Locadex 会保留哪些内容。
related:
  links:
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content
    - /docs/integrations/mintlify/guides/configuring-mintlify

---

连接好您的代码仓库后，Locadex 会翻译您的 Mintlify 文档，并创建一个包含结果的拉取请求。本指南说明一次翻译运行的工作方式，以及它会和不会更改哪些内容。

## 运行首次翻译 [#first-run]

首次翻译会在设置阶段完成。关联代码仓库并选择语言后，Locadex 会：

1. 生成针对 Mintlify 优化的 General Translation 配置。
2. 将你的 `docs.json` 导航重组为多语言布局，每个区域设置对应一个条目。
3. 翻译你的 Markdown、MDX 文件和 `docs.json` 中的标签。
4. 创建一个拉取请求，其中包含配置、重组后的导航和翻译后的文件。

检查该拉取请求并将其合并，即可发布翻译后的文档。你也可以打开 **项目 > 自动化**，选择 **生成翻译并推送**，然后点击 **立即运行**。

## 哪些内容会被翻译 [#translated]

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

* 所有 `.mdx` 和 `.md` 页面——包括标题、段落、列表、表格和提示块。
* frontmatter 字段 (例如页面标题和描述) ，这样你的元数据在每种语言中都能正常工作。
* 可复用的 [snippets](https://mintlify.com/docs) 以及 `docs.json` 中的导航标签。

要查看精确的文件 glob 模式，以及仓库中始终会被排除的文件，请参阅 [Supported content](/docs/integrations/mintlify/reference/supported-content)。

## 保留哪些内容 [#preserved]

翻译是在 Markdown 和 MDX 语法层面进行的，因此结构和代码都会保持不变：

* 代码块、内联代码和语法高亮都不会被改动——只翻译注释和文档字符串。
* 自定义组件、链接和格式都会按原样保留。
* General Translation 会添加稳定的标题锚点 ID，因此页内链接在不同语言版本中仍可正常使用。

## 上下文感知翻译 [#context]

翻译由能够理解技术术语及周边内容的 AI 智能体生成，因此能确保语义和产品术语在不同语言中保持一致。要在整个项目中统一术语和语气，请在仪表板中定义翻译上下文。请参阅 [定义翻译上下文](/docs/platform/dashboard/guides/adding-translation-context)。
## Next steps

- /docs/integrations/mintlify/guides/managing-translations
- /docs/integrations/mintlify/guides/using-translated-content
- /docs/integrations/mintlify/guides/configuring-mintlify