-- 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**.
+
+
+
+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 231848645..588d6f20d 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 9cca7fcd3..dd7a6140a 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 a7ae2f33b..5186d7d84 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 23649baea..c44051743 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 (*)`