# General Translation Integrations: 配置 Mintlify
URL: https://generaltranslation.com/zh/docs/integrations/mintlify/guides/configuring-mintlify.mdx
---

title: 配置 Mintlify
description: "如何将 Mintlify 文档仓库连接到 General Translation：本指南介绍如何选择语言，以及如何设置翻译的运行方式。"
related:
  links:
    - /docs/integrations/mintlify/guides/translating-content
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content

---

# 配置 Mintlify

将存放 Mintlify 文档的 GitHub 代码仓库 连接到 General Translation，然后选择所需语言以及翻译的运行方式。[Quickstart](/docs/integrations/mintlify/quickstart)介绍了最快的上手方式；本指南则会更详细地说明各项配置选项。

该集成运行在 [Locadex](/docs/platform/locadex/quickstart) 上，因此需要在仪表板的 **Locadex > 智能体** 中进行配置，而不是通过某个 package 或手动编辑配置文件来完成。

## 开始之前 [#before-start]

* 一个已开通包含 `locadex_workflows` 功能套餐的 General Translation [项目](/docs/platform/dashboard/get-started)。
* 一个包含有效 Mintlify 项目的 GitHub 代码仓库。Locadex 会检查代码仓库中是否存在 `$schema` 指向 Mintlify 的 `docs.json`。如果项目仍在使用旧版 `mint.json` (请先迁移到 `docs.json`) ，或看起来像是 Next.js 应用，Locadex 会拒绝该项目。

## 连接并关联你的代码仓库 [#connect]

1. 在仪表板中，打开你的项目，然后前往 **Locadex > 智能体**。
2. 点击 **Connect GitHub**，并为希望允许 Locadex 访问的代码仓库授权 General Translation GitHub App。
3. 选择包含你的 Mintlify 文档的代码仓库。每个项目只能关联一个代码仓库。

## 设置应用根目录 [#app-directory]

如果你的 `docs.json` 位于代码仓库根目录，请将应用根目录留空或设为 `.`。如果你的文档位于子目录中 (例如在 monorepo 中) ，请将应用根目录设为该路径，以便 Locadex 在正确的文件夹中运行。请参阅 [Monorepos](/docs/platform/locadex/guides/using-in-monorepos)。

## 选择语言 [#languages]

设置**默认区域设置** (即文档的编写语言) 以及要翻译成的**目标语言**。

Mintlify 支持一组固定的语言代码，General Translation 会将你选择的区域设置映射到这些代码。只有能映射到 Mintlify 所支持语言的区域设置才能使用。请参阅 [Locales](/docs/integrations/mintlify/reference/locales)。

如果之后要更改语言，请参阅 [Managing translations](/docs/integrations/mintlify/guides/managing-translations)。

## 隐藏默认区域设置 [#hide-default]

使用 **Hide default locale in URL paths** 开关来控制源语言内容的提供方式：

* **开启** (默认) ：默认区域设置的页面会保留在现有路径下 (不带区域设置前缀) ，只有翻译后的语言会带有区域设置前缀。
* **关闭**：所有语言 (包括默认语言) 都会在各自的区域设置前缀下提供。

此选项会改变 Locadex 重组文件和 `docs.json` 导航的方式。请参阅[配置参考](/docs/integrations/mintlify/reference/config)，了解每种模式具体会生成什么。

## 设置翻译的运行方式 [#triggers]

Locadex 会为它所做的每次更改创建一个 pull request。对于文档 代码仓库，它会在默认 branch 有新提交时运行；检查通过后，还可以自动 merge 翻译 pull request，这样你的文档无需手动操作也能始终保持翻译最新。你可以随时查看这些设置，并更改触发方式或自动合并行为——请参阅 [自动合并](/docs/platform/locadex/guides/auto-merging-prs)。
## Next steps

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