# 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) 提供支持，它是一个 AI 智能体。你只需连接存放 Mintlify 文档的 GitHub 仓库，选择所需语言，Locadex 就会创建一个拉取请求，为你的文档添加国际化 (i18n) 路由和已翻译内容。无需安装任何包，也无需手动编写配置文件。

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

你需要准备：

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

## 快速开始 [#quickstart]

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

### 1. 连接 GitHub

在 General Translation 仪表板中，打开 **项目 > 集成 > 目录**，然后连接 GitHub。为包含你的 Mintlify 文档的仓库授权 General Translation GitHub App。

### 2. 创建自动化

打开 **项目 > Automations**，选择 **Generate translations and push**。选择已关联的仓库、包含 `docs.json` 的目录，并将框架设为 **Mintlify**。确认目标分支和触发器，然后点击 **Create automation**。

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

### 3. 运行设置

打开自动化，然后点击 **Run setup**。设置**源区域设置**和**目标语言**，然后确认。参见 [Locales](/docs/integrations/mintlify/reference/locales)。

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

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

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

setup PR 合并后，Locadex 会遵循该自动化配置的触发条件。新的翻译自动化默认会在拉取请求有变更时运行。要在更改进入目标分支后再进行翻译，请将 **Run when** 设置为 **有 commit 被推送时**。请参阅[管理翻译](/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