本地化您的 Mintlify 文档

使用 General Translation,几分钟内即可翻译您的文档站点

开始使用
General Translation

Quickstart

Translate a Mintlify documentation site with General Translation.

The integration is powered by Locadex, an AI agent: connect the GitHub repository that holds your docs, choose your languages, and Locadex opens a pull request with internationalization (i18n) routing and translated content. There is nothing to install and no config to write by hand.

Before you start

You need:

  • A project.
  • A GitHub repository containing a valid Mintlify project: a docs.json whose $schema points at Mintlify (mintlify.com/docs.json), with no legacy mint.json.
  • Permission to install a GitHub App on that repository.

拉取请求已合并es, fr, ja

只需几步,即可本地化您的文档

只需几分钟,即可为整个文档站点生成可用于生产环境的译文

  1. 连接您的代码仓库

    将我们的 Locadex Agent 连接到存放 Mintlify 文档的 GitHub 代码仓库。

  2. 选择语言

    选择源区域设置和目标语言。无需安装任何工具,也无需手动编写配置。

  3. 合并 PR

    Locadex 会为您完成所有配置,并创建一个 PR,其中包含翻译后的页面、多语言导航和国际化(i18n)路由。合并 PR 后,翻译后的文档即可上线。

如何翻译 Mintlify 文档站点?

文字稿

In Hamburg, your Mintlify docs open in English, and the site offers no German. The navigation in docs.json lists one set of English pages and no languages. General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, and choose your docs repository in the Dashboard. Create an automation from the Generate translations and push template for Mintlify, then run its setup with your languages. Locadex's pull request adds a navigation entry per language and the translated pages. The merged site's menu switches the docs to Spanish, Japanese and German.

深受全球顶尖企业信赖

General Translation 提供完整的本地化技术栈,为开发者和用户带来流畅无阻的体验

  • 仪表板、落地页和 iOS 支持 11+ 个区域设置

  • 支持网站和文档的 14+ 种区域设置

  • 支持平台和文档的 47+ 种区域设置

  • 支持网站、iOS 和 Android 的 2+ 种区域设置

  • 支持网站和 GTM 的 7+ 种区域设置

  • 开源国际化库
  • 上下文感知翻译
  • 团队审校平台
  • 内容集成
  • Locadex Agent

充分结合上下文,呈现母语级译文

深入理解您的产品,参照整个文档站点核验,提供最高质量的译文

上下文贯穿每个层面

译文遵循您的表达方式和风格规则,准确把握产品的上下文与逻辑。

所有页面保持一致

每个页面都会经过校对,与源文逐一对照,并检查是否与其他页面保持一致。

与团队一起审校和编辑

每一行都可在仪表板中编辑,支持多语言并排对照、历史记录和评论。

持续本地化,紧跟每次更新

每当你更新文档,Locadex 都会翻译变更内容并为你创建拉取请求。你只需审校并合并

  1. 推送文档更改
  2. Locadex 翻译有变动的内容
  3. 自动创建拉取请求
  4. 审校并合并
  5. 所有语言版本均已上线

连接并本地化您的全套产品

General Translation 将您的代码、内容、译文和审校工作整合到同一平台

常见问题

翻译、国际化和本地化有什么区别?

翻译是将内容从一种语言转换为另一种语言。国际化(i18n)让你的网站具备支持多个区域设置的能力,涵盖路由、导航、日期和复数形式。本地化(l10n)的范围更广:针对每个区域设置调整整个产品,从文字到格式化,无所不包。对于 Mintlify 网站,国际化是指 Locadex 配置的区域设置路由和多语言导航,翻译是指各语言版本的页面,而 General Translation 则持续管理整个本地化工作流。

只需要翻译功能?请参阅 Mintlify 翻译。

直接用 AI API 翻译文档不就行了吗?

如果只是做一次翻译,可以。但要每周都交付各种语言的可靠文档,就需要围绕模型建立一整套系统。

你的页面不只是文本。MDX 组件、导入语句和代码块必须原样保留,frontmatter 的键不能变,{#configure-client} 这样的标题 ID 也必须保留在对应标题上,以免深层链接失效。

你的文档是一个站点,而不是单个页面。每种语言都需要对应的导航版本,区域设置代码必须符合平台要求,而“workspace”在第 1 页和第 400 页的译法必须一致(在你的应用中也一样,我们也支持应用本地化)。

你的文档每周都在更新。每次更新都应只翻译有改动的内容,保留审校人员的手动修改,并以拉取请求的形式提交到正确的分支。日后添加新语言也不应影响已有语言。

团队成员都需要掌握情况并能进行管理:逐行对照源文本与译文,查看历史记录和评论,管理角色,并为每种语言设置语气规则。

General Translation 提供端到端支持,包办上述所有工作。我们为客户处理数以千计的本地化 PRs,让他们能专注于打造深受全球用户喜爱的产品。

初始化设置需要多长时间?

只需几分钟,无需迁移。连接代码仓库,选择语言,然后合并 General Translation 创建的拉取请求,即可开始大规模翻译(Ramp 仅用几分钟就翻译了 40,000 个键,涉及数百万词)。你也可以点击“为智能体进行初始化设置”按钮,将初始化设置交给编程智能体完成。

支持哪些语言?

涵盖 Mintlify 支持的所有语言,包括西班牙语、法语、德语、日语、韩语、中文(简体和繁体)、葡萄牙语(包括巴西葡萄牙语)、阿拉伯语、希伯来语和印地语。General Translation 会将您选择的区域设置映射到 Mintlify 的语言代码。对于地区变体,除非 Mintlify 直接支持,否则会使用对应的基础语言。请参阅完整列表。

文档变更时,译文会同步更新吗?

会,译文会持续更新。我们的 Locadex Agent 会按你选择的方式,在创建拉取请求、提交代码或手动触发时运行,仅翻译变更内容,而非整个站点,并通过拉取请求交付,确保每次发布时,所有语言版本都能与源内容的变更同步上线。

译文会符合我们的语言风格和术语规范吗?

General Translation 支持通过自定义提示词设定语气和风格,并通过词汇表统一产品名称和关键术语的用法。所有翻译都会一致地应用这些上下文信息,涵盖应用、网站、文档、幻灯片和设计文件。

翻译会破坏我的 MDX 组件吗?

不会。翻译时会保留 MDX 语法和组件结构,仅翻译人类可读的内容。对于 Mintlify 网站,还会翻译 frontmatter 中的标题和描述。

费用是多少?

按用量计费,不收取席位费,无需订阅。Starter 方案的平台费为 $0,项目、用户和语言数量不限,并提供免费起始额度。完整费率请参阅定价页面。

让全球读者都能阅读你的 Mintlify 文档

免费开始使用,无需支付月费