# General Translation Integrations: 快速开始
URL: https://generaltranslation.com/zh/docs/integrations/mintlify/quickstart.mdx
---

title: 快速开始
description: 使用 General Translation 翻译 Mintlify 文档站点的快速入门指南。
related:
  links:
    - /docs/integrations/mintlify/guides/translating-content
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content
    - /docs/integrations/mintlify/guides/configuring-mintlify

---

# 快速开始

使用 Mintlify 集成，自动将你的 Mintlify 文档翻译成所需的各种语言。

该集成由 [Locadex](/docs/platform/locadex/quickstart) 提供支持，它是 General Translation 的 AI 智能体。你只需连接存放 Mintlify 文档的 GitHub 仓库，选择所需语言，Locadex 就会创建一个拉取请求，为你的文档添加国际化 (i18n) 路由和已翻译内容。无需安装任何包，也无需手动编写配置文件。

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

你需要准备：

* 一个 General Translation [项目](/docs/platform/dashboard/get-started)，且所用套餐包含 `locadex_workflows` 功能。
* 一个包含有效 Mintlify 项目的 GitHub 仓库：其中有一个 `$schema` 指向 Mintlify (`mintlify.com/docs.json`) 的 `docs.json`，且不存在旧版 `mint.json`。
* 拥有在该仓库上安装 GitHub App 的权限。

*注意：如果你的套餐未包含* `locadex_workflows` *功能，仪表板会显示升级提示，而不会显示 Locadex 设置，因此你无法连接仓库。*

## 快速开始 [#quickstart]

设置只需五分钟。Locadex 会为你完成配置，你只需选择代码仓库和语言即可。

### 1. 连接 GitHub

在 General Translation 仪表板中，打开你的项目，然后前往 **Locadex > 智能体**。点击 **Connect GitHub** 并完成授权。按照提示流程，在你希望 Locadex 访问的代码仓库上安装 General Translation GitHub App (可选择所有代码仓库或指定代码仓库) 。

### 2. 关联你的代码仓库

回到仪表板，选择包含 Mintlify 文档的代码仓库。每个项目只能关联一个代码仓库；如果还有其他代码仓库，请另外创建项目。

*如果你的文档位于 monorepo 的子目录中，请将应用根目录设为该路径。参见 [Monorepos](/docs/platform/locadex/guides/using-in-monorepos)。*

### 3. 选择语言

设置你的**默认区域设置** (即文档所使用的语言) 以及要翻译成的**目标语言**。你也可以切换 **Hide default locale in URL paths**，以控制源语言的 URL 路径是否省略区域设置前缀。参见 [Locales](/docs/integrations/mintlify/reference/locales)。

### 4. 审核并合并拉取请求

Locadex 会先运行其 setup 工作流，然后在你的仓库中发起一个拉取请求。这个过程可能需要几分钟。该 PR 会添加 General Translation 配置，调整 `docs.json` 导航以支持多语言，并包含翻译后的 Markdown 和 MDX 文件。审核这些更改后，合并即可发布翻译后的文档。

### 5. 保持翻译为最新

setup PR 合并后，Locadex 会监控你的默认 branch。当你推送新增或修改过的内容时，它会自动翻译这些更新。请参阅[管理翻译](/docs/integrations/mintlify/guides/managing-translations)。
## Next steps

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