# General Translation Integrations: 使用翻译后的内容
URL: https://generaltranslation.com/zh/docs/integrations/mintlify/guides/using-translated-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 如何通过多语言导航、区域设置路由和重定向提供翻译后的 Mintlify 文档。

设置拉取请求合并后，你的 Mintlify 站点将支持你所选的每种语言。本指南说明该集成会如何更改你的项目，以便让读者进入正确的语言版本。

## 多语言导航 [#navigation]

Locadex 会将你的 `docs.json` 导航转换为 Mintlify 的多语言结构，为每种语言生成一个导航条目。Mintlify 会据此渲染语言切换器，并构建各语言对应的页面树。如果你的导航位于通过 `$ref` 引用的独立文件中，Locadex 会将这些更改写入该文件，并在 `docs.json` 中保留 `$ref`。

## URL 路由和默认区域设置 [#routing]

每种语言都使用各自的区域设置路径段 (例如 `/es/...`) 。从 **项目 > 自动化** 开始的设置也会为源区域设置添加前缀，例如 `/en/...`。

现有项目可能具有隐藏源区域设置前缀的生成配置。在这种布局下，源页面保留其原始路径，只有翻译后的语言会添加前缀。

 (如需了解每种模式会生成什么结果，请参阅[配置参考](/docs/integrations/mintlify/reference/config)) 。

## 重定向和本地化链接 [#redirects]

在 show-default-locale 模式下，Locadex 会对 `docs.json` 中现有顶层重定向的源路径和目标路径进行本地化处理，但不会创建新的重定向条目。Locadex 还会对内部链接、静态 URL 以及相对资源引用进行本地化处理，让读者在浏览时始终保持在自己的语言环境中。如果链接指向的页面尚无译文，则仍指向源 URL。

直接运行 CLI 时，可启用 [`options.mintlify.localizeRedirects`](/docs/integrations/mintlify/reference/config#localized-redirects)：如果源页面在同一次翻译运行中被重命名或删除，CLI 会为源区域设置下的重定向逐一添加各区域设置的副本。初始化生成的配置中不包含此项需主动启用的设置。CLI 不会改动现有条目，并会跳过没有已翻译目标页面的区域设置。

## OpenAPI 页面 [#openapi]

如果你的代码仓库中包含 JSON 或 YAML 格式的 OpenAPI 3.x 规范，Locadex 会将翻译后的规范注册到 Mintlify 配置中。这样，Mintlify 就能在各区域设置对应的路径下提供相应的规范。

`navigation.languages` 之外的 OpenAPI 注册项仍关联源规范；而位于某个目标语言导航内的注册项，则指向该区域设置对应的翻译版规范。

## 部署 [#deploy]

该集成只会修改代码仓库中的文件，因此发布方式与其他 Mintlify 项目完全一致：合并拉取请求后，照常由 Mintlify 部署来构建站点即可。无需额外的部署步骤。

## Next steps

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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.