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

该集成运行在 [Locadex](/docs/platform/locadex/quickstart) 上，因此其仓库和自动化需在仪表板的 **项目 > 集成** 和 **项目 > 自动化** 中进行配置。

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

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

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

1. 在仪表板中，打开 **项目 > 集成 > Catalog**。
2. 连接 GitHub，并为包含你的 Mintlify 文档的仓库授权 General Translation GitHub App。
3. 打开 **项目 > 自动化**，然后选择 **生成翻译并推送**。
4. 选择仓库、目标目录以及 **Mintlify** 框架。

## 设置目标目录 [#target-directory]

如果你的 `docs.json` 位于代码仓库根目录，请将 **目标目录** 设置为 `.`。如果你的文档位于子目录中，例如在 monorepo 中，请将 **目标目录** 设置为该路径，以便 Locadex 在正确的文件夹中运行。请参阅[在 monorepo 中使用 Locadex](/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)。

## 选择默认区域设置的 URL 布局 [#default-locale-url]

从 **项目 > 自动化** 启动的设置流程会为每种语言创建带区域设置前缀的布局，其中也包括源区域设置。例如，英语源页面会位于 `/en/...` 下。

如果现有项目已配置为隐藏源区域设置，源页面将继续沿用原始路径。该行为会记录在生成的 `gt.config.json` 中；请参见[配置参考](/docs/integrations/mintlify/reference/config#options)。

此布局会影响 Locadex 重组文件及 `docs.json` 导航的方式。请在合并前审校该设置的 pull request。

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

Locadex 会使用它的更改创建或更新 pull request。对于同一个 automation branch，它会复用一个尚未关闭的 PR；在上一个 PR 被 merge 或关闭后，则会创建一个新的 PR。

新的翻译自动化默认使用 **pull request 发生更改时**，并且 **自动合并** 为关闭状态。选择 **有 commit 被推送时**，可在更改到达目标 branch 后进行翻译；当可靠的必需检查能够保护该 branch 时，可开启 **自动合并**。请参阅 [自动合并 Locadex PR](/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