From 31391703401b57c7981c5f6e7105bc6fa8e81b2b Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 27 Jul 2026 20:35:45 +0000
Subject: [PATCH] docs: translate subpath proxy asset routing updates
(es/fr/zh)
---
es/deploy/cloudflare.mdx | 22 ++++++++++++++++++----
es/deploy/route53-cloudfront.mdx | 28 +++++++++++++++++++++-------
fr/deploy/cloudflare.mdx | 22 ++++++++++++++++++----
fr/deploy/route53-cloudfront.mdx | 28 +++++++++++++++++++++-------
zh/deploy/cloudflare.mdx | 22 ++++++++++++++++++----
zh/deploy/route53-cloudfront.mdx | 26 ++++++++++++++++++++------
6 files changed, 116 insertions(+), 32 deletions(-)
diff --git a/es/deploy/cloudflare.mdx b/es/deploy/cloudflare.mdx
index 9ecc62b6af..d72ffc1bb1 100644
--- a/es/deploy/cloudflare.mdx
+++ b/es/deploy/cloudflare.mdx
@@ -82,8 +82,12 @@ async function handleRequest(request) {
return await fetch(request);
}
- // If the request is to the docs subpath
- if (/^\/docs/.test(urlObject.pathname)) {
+ // If the request is to the docs subpath or a Mintlify asset or API path
+ if (
+ /^\/docs/.test(urlObject.pathname) ||
+ /^\/mintlify-assets\//.test(urlObject.pathname) ||
+ /^\/_mintlify\//.test(urlObject.pathname)
+ ) {
// Then Proxy to Mintlify
const DOCS_URL = "[SUBDOMAIN].mintlify.site";
const CUSTOM_URL = "[YOUR_DOMAIN]";
@@ -108,6 +112,12 @@ async function handleRequest(request) {
}
```
+
+ Además de tu subruta, tu Worker debe hacer proxy de `/mintlify-assets/*`, que sirve el CSS, JavaScript y favicons de tu documentación, y `/_mintlify/*`, que gestiona las solicitudes del playground de API.
+
+ Si diriges el tráfico a tu Worker con patrones de ruta en lugar de un dominio personalizado, añade rutas para `yoursite.com/mintlify-assets/*` y `yoursite.com/_mintlify/*` junto con la ruta de tu subruta. Estas rutas deben originarse desde la raíz de tu dominio, no desde tu subruta.
+
+
Haz clic en **Deploy** y espera a que se propaguen los cambios.
@@ -174,8 +184,12 @@ Si usas Webflow para alojar tu sitio principal y quieres servir la documentació
return await fetch(request);
}
- // If the request is to the docs subpath
- if (/^\/docs/.test(urlObject.pathname)) {
+ // If the request is to the docs subpath or a Mintlify asset or API path
+ if (
+ /^\/docs/.test(urlObject.pathname) ||
+ /^\/mintlify-assets\//.test(urlObject.pathname) ||
+ /^\/_mintlify\//.test(urlObject.pathname)
+ ) {
// Proxy to Mintlify
const DOCS_URL = "[SUBDOMAIN].mintlify.site";
const CUSTOM_URL = "[YOUR_DOMAIN]";
diff --git a/es/deploy/route53-cloudfront.mdx b/es/deploy/route53-cloudfront.mdx
index dbfcf60e8d..b7411fe677 100644
--- a/es/deploy/route53-cloudfront.mdx
+++ b/es/deploy/route53-cloudfront.mdx
@@ -28,10 +28,11 @@ Dirige el tráfico a estas rutas con una política de caché **CachingDisabled**
- `/.well-known/vercel/*` - Obligatorio para la verificación del dominio
- `/docs/*` - Obligatorio para el enrutamiento por subruta
- `/docs/` - Obligatorio para el enrutamiento por subruta
+- `/_mintlify/*` - Obligatorio para las solicitudes del playground de API
-Dirige el tráfico a esta ruta con una política de caché **CachingEnabled**:
+Dirige el tráfico a estas rutas con una política de caché **CachingEnabled**:
-- `/mintlify-assets/_next/static/*`
+- `/mintlify-assets/*` - Obligatorio para CSS, JavaScript y favicons
- `Default (*)` - La página de inicio de tu sitio web
Todos los comportamientos (Behaviors) deben tener una **origin request policy** de `AllViewerExceptHostHeader`.
@@ -167,13 +168,26 @@ Esta configuración debe coincidir exactamente con el comportamiento de tu subru
- Establece "Viewer protocol policy" en **Redirect HTTP to HTTPS**.
- Establece "Allowed HTTP methods" en **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
-
- ### `/mintlify-assets/_next/static/*`
+
+ ### `/mintlify-assets/*`
-- Establece la "política de caché" en **CachingOptimized**
- - Establece la "política de solicitud de origen" en **AllViewerExceptHostHeader**
- - Establece la "política de protocolo del visor" en **Redirect HTTP to HTTPS**
+Crea un comportamiento con un **Path pattern** de `/mintlify-assets/*` con **Origin and origin groups** apuntando a la URL `.mintlify.site`. Esta ruta sirve el CSS, JavaScript y favicons de tu documentación desde la raíz de tu dominio.
+
+ - Establece "Cache policy" en **CachingOptimized**.
+ - Establece "Origin request policy" en **AllViewerExceptHostHeader**.
+ - Establece "Viewer protocol policy" en **Redirect HTTP to HTTPS**.
+
+
+ ### `/_mintlify/*`
+
+
+Crea un comportamiento con un **Path pattern** de `/_mintlify/*` con **Origin and origin groups** apuntando a la URL `.mintlify.site`. Esta ruta gestiona las solicitudes del playground de API desde la raíz de tu dominio.
+
+- Establece "Cache policy" en **CachingDisabled**.
+- Establece "Origin request policy" en **AllViewerExceptHostHeader**.
+- Establece "Viewer protocol policy" en **Redirect HTTP to HTTPS**.
+- Establece "Allowed HTTP methods" en **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
### `Default (*)`
diff --git a/fr/deploy/cloudflare.mdx b/fr/deploy/cloudflare.mdx
index 231848645b..588d6f20df 100644
--- a/fr/deploy/cloudflare.mdx
+++ b/fr/deploy/cloudflare.mdx
@@ -82,8 +82,12 @@ async function handleRequest(request) {
return await fetch(request);
}
- // Si la requête concerne le sous-chemin docs
- if (/^\/docs/.test(urlObject.pathname)) {
+ // Si la requête concerne le sous-chemin docs, une ressource Mintlify ou un chemin d'API
+ if (
+ /^\/docs/.test(urlObject.pathname) ||
+ /^\/mintlify-assets\//.test(urlObject.pathname) ||
+ /^\/_mintlify\//.test(urlObject.pathname)
+ ) {
// Alors rediriger via proxy vers Mintlify
const DOCS_URL = "[SUBDOMAIN].mintlify.site";
const CUSTOM_URL = "[YOUR_DOMAIN]";
@@ -108,6 +112,12 @@ async function handleRequest(request) {
}
```
+
+ En plus de votre sous-chemin, votre Worker doit proxyfier `/mintlify-assets/*`, qui sert le CSS, le JavaScript et les favicons de votre documentation, ainsi que `/_mintlify/*`, qui gère les requêtes du playground d'API.
+
+ Si vous routez le trafic vers votre Worker avec des modèles de route au lieu d'un domaine personnalisé, ajoutez des routes pour `yoursite.com/mintlify-assets/*` et `yoursite.com/_mintlify/*` en plus de la route de votre sous-chemin. Ces chemins doivent partir de la racine de votre domaine, pas de votre sous-chemin.
+
+
Cliquez sur **Deploy** et attendez que les modifications se propagent.
@@ -175,8 +185,12 @@ Si vous utilisez Webflow pour héberger votre site principal et que vous souhait
return await fetch(request);
}
- // Si la requête concerne le sous-chemin docs
- if (/^\/docs/.test(urlObject.pathname)) {
+ // Si la requête concerne le sous-chemin docs, une ressource Mintlify ou un chemin d'API
+ if (
+ /^\/docs/.test(urlObject.pathname) ||
+ /^\/mintlify-assets\//.test(urlObject.pathname) ||
+ /^\/_mintlify\//.test(urlObject.pathname)
+ ) {
// Proxy vers Mintlify
const DOCS_URL = "[SUBDOMAIN].mintlify.site";
const CUSTOM_URL = "[YOUR_DOMAIN]";
diff --git a/fr/deploy/route53-cloudfront.mdx b/fr/deploy/route53-cloudfront.mdx
index 9cca7fcd39..dd7a6140a1 100644
--- a/fr/deploy/route53-cloudfront.mdx
+++ b/fr/deploy/route53-cloudfront.mdx
@@ -28,10 +28,11 @@ Dirigez le trafic vers ces chemins avec une stratégie de mise en cache (**Cache
- `/.well-known/vercel/*` - Requis pour la vérification du domaine
- `/docs/*` - Requis pour le routage par sous-chemin
- `/docs/` - Requis pour le routage par sous-chemin
+- `/_mintlify/*` - Requis pour les requêtes du playground d'API
-Dirigez le trafic vers ce chemin avec une stratégie de mise en cache (**Cache Policy**) de **CachingEnabled** :
+Dirigez le trafic vers ces chemins avec une stratégie de mise en cache (**Cache Policy**) de **CachingEnabled** :
-- `/mintlify-assets/_next/static/*`
+- `/mintlify-assets/*` - Requis pour le CSS, le JavaScript et les favicons
- `Default (*)` - La page d'accueil de votre site web
Tous les Behaviors doivent avoir une **origin request policy** de `AllViewerExceptHostHeader`.
@@ -167,13 +168,26 @@ Ces paramètres doivent correspondre exactement au comportement de votre sous-ch
- Définissez "Viewer protocol policy" sur **Redirect HTTP to HTTPS**.
- Définissez "Allowed HTTP methods" sur **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
-
- ### `/mintlify-assets/_next/static/*`
+
+ ### `/mintlify-assets/*`
-- Définissez la « Cache policy » sur **CachingOptimized**
- - Définissez la « Origin request policy » sur **AllViewerExceptHostHeader**
- - Définissez la « Viewer protocol policy » sur **Redirect HTTP to HTTPS**
+Créez un comportement avec un **Path pattern** de `/mintlify-assets/*` et des **Origin and origin groups** pointant vers l'URL `.mintlify.site`. Ce chemin sert le CSS, le JavaScript et les favicons de votre documentation depuis la racine de votre domaine.
+
+ - Définissez « Cache policy » sur **CachingOptimized**.
+ - Définissez « Origin request policy » sur **AllViewerExceptHostHeader**.
+ - Définissez « Viewer protocol policy » sur **Redirect HTTP to HTTPS**.
+
+
+ ### `/_mintlify/*`
+
+
+Créez un comportement avec un **Path pattern** de `/_mintlify/*` et des **Origin and origin groups** pointant vers l'URL `.mintlify.site`. Ce chemin gère les requêtes du playground d'API depuis la racine de votre domaine.
+
+- Définissez « Cache policy » sur **CachingDisabled**.
+- Définissez « Origin request policy » sur **AllViewerExceptHostHeader**.
+- Définissez « Viewer protocol policy » sur **Redirect HTTP to HTTPS**.
+- Définissez « Allowed HTTP methods » sur **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
### `Default (*)`
diff --git a/zh/deploy/cloudflare.mdx b/zh/deploy/cloudflare.mdx
index a7ae2f33b8..5186d7d847 100644
--- a/zh/deploy/cloudflare.mdx
+++ b/zh/deploy/cloudflare.mdx
@@ -82,8 +82,12 @@ async function handleRequest(request) {
return await fetch(request);
}
- // 如果请求是 docs 子路径
- if (/^\/docs/.test(urlObject.pathname)) {
+ // 如果请求是 docs 子路径、Mintlify 静态资源或 API 路径
+ if (
+ /^\/docs/.test(urlObject.pathname) ||
+ /^\/mintlify-assets\//.test(urlObject.pathname) ||
+ /^\/_mintlify\//.test(urlObject.pathname)
+ ) {
// 然后代理到 Mintlify
const DOCS_URL = "[SUBDOMAIN].mintlify.site";
const CUSTOM_URL = "[YOUR_DOMAIN]";
@@ -108,6 +112,12 @@ async function handleRequest(request) {
}
```
+
+ 除了你的子路径外,你的 Worker 还必须代理 `/mintlify-assets/*`(用于提供文档的 CSS、JavaScript 和 favicon)以及 `/_mintlify/*`(用于处理 API playground 请求)。
+
+ 如果你使用路由模式而非自定义域将流量路由到 Worker,请在子路径路由的基础上,为 `yoursite.com/mintlify-assets/*` 和 `yoursite.com/_mintlify/*` 添加路由。这些路径必须源自你域名的根路径,而不是子路径。
+
+
点击 **Deploy**,然后等待更改生效。
@@ -175,8 +185,12 @@ async function handleRequest(request) {
return await fetch(request);
}
- // 如果请求是文档子路径
- if (/^\/docs/.test(urlObject.pathname)) {
+ // 如果请求是 docs 子路径、Mintlify 静态资源或 API 路径
+ if (
+ /^\/docs/.test(urlObject.pathname) ||
+ /^\/mintlify-assets\//.test(urlObject.pathname) ||
+ /^\/_mintlify\//.test(urlObject.pathname)
+ ) {
// 代理到 Mintlify
const DOCS_URL = "[SUBDOMAIN].mintlify.site";
const CUSTOM_URL = "[YOUR_DOMAIN]";
diff --git a/zh/deploy/route53-cloudfront.mdx b/zh/deploy/route53-cloudfront.mdx
index 23649baeaf..c440517438 100644
--- a/zh/deploy/route53-cloudfront.mdx
+++ b/zh/deploy/route53-cloudfront.mdx
@@ -28,10 +28,11 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx";
- `/.well-known/vercel/*` - 用于域名验证
- `/docs/*` - 用于子路径路由
- `/docs/` - 用于子路径路由
+- `/_mintlify/*` - 用于 API playground 请求
将流量路由到以下路径,并将缓存策略(Cache Policy)设置为 **CachingEnabled**:
-- `/mintlify-assets/_next/static/*`
+- `/mintlify-assets/*` - 用于 CSS、JavaScript 和 favicon
- `Default (*)` - 你的网站着陆页
所有 Behaviors 都必须将 **origin request policy** 设置为 `AllViewerExceptHostHeader`。
@@ -167,13 +168,26 @@ CloudFront 中的行为用于控制子路径逻辑。总体而言,我们希望
- 将 "Viewer protocol policy" 设置为 **Redirect HTTP to HTTPS**
- 将 "Allowed HTTP methods" 设置为 **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**
-
- ### `/mintlify-assets/_next/static/*`
+
+ ### `/mintlify-assets/*`
-- 将“Cache policy”设置为 **CachingOptimized**
- - 将“Origin request policy”设置为 **AllViewerExceptHostHeader**
- - 将“Viewer protocol policy”设置为 **Redirect HTTP to HTTPS**
+创建一个行为,在 **Path pattern** 中填写 `/mintlify-assets/*`,并将 **Origin and origin groups** 指向 `.mintlify.site` 的 URL。此路径从你域名的根路径提供文档的 CSS、JavaScript 和 favicon。
+
+ - 将 "Cache policy" 设置为 **CachingOptimized**。
+ - 将 "Origin request policy" 设置为 **AllViewerExceptHostHeader**。
+ - 将 "Viewer protocol policy" 设置为 **Redirect HTTP to HTTPS**。
+
+
+ ### `/_mintlify/*`
+
+
+创建一个行为,在 **Path pattern** 中填写 `/_mintlify/*`,并将 **Origin and origin groups** 指向 `.mintlify.site` 的 URL。此路径从你域名的根路径处理 API playground 请求。
+
+- 将 "Cache policy" 设置为 **CachingDisabled**。
+- 将 "Origin request policy" 设置为 **AllViewerExceptHostHeader**。
+- 将 "Viewer protocol policy" 设置为 **Redirect HTTP to HTTPS**。
+- 将 "Allowed HTTP methods" 设置为 **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**。
### `Default (*)`