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 (*)`