# General Translation Knowledge Base: 如何翻译 Mintlify 文档站点？
URL: https://generaltranslation.com/zh/kb/translate-mintlify-docs.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 为每种语言创建一个文件夹，在其中存放每个页面的译文副本，并将每种语言添加到 docs.json 导航中。General Translation 的 AI 智能体 Locadex 会提交一个拉取请求，添加翻译后的页面和各语言的导航，之后还会持续翻译后续变更。
Category: 工作流工具
Last updated: 2026-10-21
Authors: Kevin Liu, Kevin Wu
Published: 2026-10-21

翻译 Mintlify 文档站点，就是为每种语言创建一个文件夹，在其中存放每个页面的译文副本，并在 `docs.json` 导航的 `languages` 数组中列出每种语言。页面中混杂着正文、代码块、MDX 组件、frontmatter 和链接，因此既要翻译正文以及 `title` 和 `description` 字段，又要保证代码和组件原封不动，内部链接也必须指向读者所用语言的页面。此后，源页面每修改一次，其译文就会随之过时，直到有人重新翻译为止。

## Video

The video is narrated in English, with English captions.

[How do I translate a Mintlify docs site?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-translate-mintlify-docs.mp4) (47秒)

General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, choose your docs repository in the Dashboard, create an automation from the Generate translations and push template for Mintlify, run its setup with your languages, and merge the pull request that adds a navigation entry per language and the translated pages.

## 翻译 Mintlify 站点的几种方式

| 方式                                    | 擅长之处                                          | 留给你的工作                                           |
| ------------------------------------- | --------------------------------------------- | ------------------------------------------------ |
| 使用 Mintlify 的 `languages` 导航，人工翻译     | 根据 `docs.json` 为每种语言生成语言切换器和页面树               | 将每个译后页面写入对应的语言文件夹，为每种语言编写完整导航，并追踪每次源内容修改导致哪些译文过时 |
| Google Translate                      | 翻译你粘贴进来的页面，无需任何初始化设置                          | 它逐段孤立翻译；区分正文与代码和组件、编写文件夹和导航，都得你自己完成              |
| 基于 AI API (OpenAI API、Claude API) 的脚本 | 可指示它只翻译正文，不改动代码块和组件                           | 编写脚本来保护 MDX 语法、跨页面统一产品术语、生成文件夹和导航，并在页面变更时重新运行    |
| General Translation (Locadex)         | 提交一个包含译后页面、各语言导航和本地化链接的拉取请求，之后按你选择的触发方式翻译每次变更 | 审核并合并初始化设置的拉取请求，之后审核后续拉取请求，或开启 **Auto-merge**    |

如果译者只负责少量且很少变动的页面，可使用 Mintlify 导航配合人工翻译；如果只需对小型、稳定的站点翻译一遍，可使用 Google Translate 或一次性 AI API 脚本。如果文档每次发布都有变动，且每种语言都要及时跟进，请使用 General Translation。

## 使用 Locadex 翻译 Mintlify 文档

General Translation 借助其 AI 智能体 Locadex 翻译 Mintlify 文档。此功能需要 Starter 或 Enterprise 方案。

1. 在仪表板中，前往 **Project > Integrations > Catalog** 连接 GitHub。
2. 在 **Project > Automations** 下，基于 **Generate translations and push** 创建自动化，并将框架设为 **Mintlify**。
3. 点击 **Run setup**，然后选择所需语言。
4. 审阅并合并 Locadex 创建的拉取请求。

该拉取请求会添加 `gt.config.json`、为每种语言添加一个 `docs.json` 导航条目，并添加翻译后的页面。翻译后，代码和组件的结构保持不变，指向已翻译页面的链接也会保留读者当前所用的语言。Mintlify 的 **Run setup** 对话框中有一个 **Hide default locale in URL paths** 开关，默认开启：源页面沿用现有路径，每种翻译语言则各有独立的区域设置文件夹，例如 `/es/...`。如果关闭此开关，源页面也会移入区域设置文件夹 (英文页面移至 `/en/...`) ，其 URL 也会随之改变。

## 保持译文最新

此后，每当拉取请求有变更 (默认) 或有新提交推送时，Locadex 都会自动运行。每次运行都会应用项目所分配的上下文组 (词汇表和自定义提示词) 。这些上下文组也可以与你的应用共享，确保两边的产品名称保持一致。完整步骤请参阅 [Mintlify 快速入门](/docs/integrations/mintlify/quickstart)。

## Related questions

- [Locadex 智能体能做什么？](https://generaltranslation.com/zh/kb/what-is-locadex.mdx): Locadex 是 General Translation 推出的 AI 智能体，可在你的 GitHub 代码仓库中对代码进行国际化处理并翻译内容。它的自动化流程会在创建拉取请求、推送提交或你手动启动时运行，所有更改都以拉取请求的形式交付。
- [如何在 Sanity 中翻译内容？](https://generaltranslation.com/zh/kb/translate-sanity-content.mdx): 将每种语言存储为独立文档，或在每个字段中按区域设置分别存储值，然后将源内容翻译为每个目标区域设置。General Translation 的 gt-sanity 插件会在 Sanity Studio 中添加 Translate 操作，并默认将每条译文导入为草稿，供你审阅后发布。
- [如何在 Storyblok 中翻译内容？](https://generaltranslation.com/zh/kb/translate-storyblok-content.mdx): 在 Storyblok 中，先将目标语言添加到空间，再为每个可翻译字段按语言分别设置值。General Translation 的 Storyblok 集成可在仪表板中通过“同步并应用”填充这些值，并生成草稿，供你在 Storyblok 中审阅并发布。
- [如何审阅和编辑译文？](https://generaltranslation.com/zh/kb/review-translations.mdx): 将每条译文与其源内容及其他区域设置的版本进行对比，修正读着别扭的地方。借助 General Translation，你可以在仪表板的翻译页面中编辑译文，并通过标签和评论跟踪审阅进度；其 AI 智能体 Locadex 下一次运行翻译时，会将这些修改纳入拉取请求。

## Previous and next questions

- Previous question: [如何翻译 JSX 之外的字符串？](https://generaltranslation.com/zh/kb/translate-strings-outside-jsx.mdx)
- Next question: [如何翻译 Node.js 应用？](https://generaltranslation.com/zh/kb/translate-node-app.mdx)

## Sitemap

See the [Knowledge Base sitemap](https://generaltranslation.com/zh/kb/sitemap.md) for every article.