From 8e1ab39954a2fc48f2d8965767d1b6d73a971bb4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 27 Aug 2026 10:18:30 +0000 Subject: [PATCH 1/2] docs: fix quality gaps in recently changed pages --- ai/mintlify-mcp.mdx | 15 +++++++++++++-- cli/commands.mdx | 2 ++ deploy/route53-cloudfront.mdx | 7 +++++-- editor/pages.mdx | 10 ++++++++++ poc-onboarding.mdx | 6 +++--- 5 files changed, 33 insertions(+), 7 deletions(-) diff --git a/ai/mintlify-mcp.mdx b/ai/mintlify-mcp.mdx index 463c364ea..0932a3403 100644 --- a/ai/mintlify-mcp.mdx +++ b/ai/mintlify-mcp.mdx @@ -9,10 +9,10 @@ keywords: ["MCP", "write access", "AI", "editing", "Claude", "ChatGPT", "Cursor" The admin MCP server gives AI tools write access to your Mintlify content and settings. Use it to update content and access your dashboard. With the admin MCP, you can use your preferred AI tools to edit pages, restructure navigation, update `docs.json`, open pull requests, change settings, create workflows, and more. -Connect an MCP client such as Claude, Claude Code, ChatGPT, or Cursor to the admin MCP server. Use it to collaborate on your Mintlify content and settings with the same tools you use to write code. All changes happen on a branch and require a pull request to merge. If your organization has multiple deployments, a single admin MCP connection can access and switch between all of them. +Connect an MCP client such as Claude, Claude Code, ChatGPT, or Cursor to the admin MCP server. Use it to collaborate on your Mintlify content and settings with the same tools you use to write code. Content edits happen on a branch and ship through a pull request or commit when you call `save`. [Deployment management](#deployment-management) changes, such as workflow and settings updates, apply immediately to the live deployment. If your organization has multiple deployments, a single admin MCP connection can access and switch between all of them. - The admin MCP server allows AI tools to access your Mintlify dashboard. Treat it as a tool with write access. Connect it only from trusted AI tools and review every pull request before merging. + The admin MCP server allows AI tools to access your Mintlify dashboard. Treat it as a tool with write access. Connect it only from trusted AI tools, review every pull request before merging, and be aware that deployment management changes apply immediately without a pull request. The admin MCP is a hosted Mintlify service at `https://mcp.mintlify.com`. Every client connects to the same endpoint and authenticates with your Mintlify account. @@ -167,6 +167,17 @@ You can also override the setting on a per-call basis by passing an explicit `mo - **`update_config`**: Modify `docs.json` (theme, navigation roots, integrations, SEO settings). +### Deployment management + +Code mode handles deployment-level operations that have no dedicated tool, such as managing workflows, deployment settings, members, billing, integrations, and analytics. Code mode tools don't require a `checkout`. + +- **`search_code_operations`**: Search the deployment management methods available to code mode. Each result includes the method's full input schema. +- **`execute_code`**: Run a TypeScript script against the deployment management methods. The connection's granted scopes gate every method, and any method you weren't granted returns an authorization error. + + + Code mode writes apply immediately to the live deployment. They don't create a branch or open a pull request. Confirm the intended change before prompting an AI tool to update workflows, settings, members, billing, or integrations. + + ### Session - **`list_deployments`**: List the deployments your connection can access, returning each `{subdomain, name}`. Call this to discover which `subdomain` to pass to `checkout`. diff --git a/cli/commands.mdx b/cli/commands.mdx index 6d334fba6..416c76574 100644 --- a/cli/commands.mdx +++ b/cli/commands.mdx @@ -6,6 +6,8 @@ keywords: ["CLI", "mint", "commands", "flags", "reference"] boost: 3 --- +This page is a complete reference for the commands and flags of the `mint` CLI. To install the CLI, see [Installation](/cli/install). + ## Global flags These flags are available on all commands. diff --git a/deploy/route53-cloudfront.mdx b/deploy/route53-cloudfront.mdx index 6222b0ce2..1f4a7b74a 100644 --- a/deploy/route53-cloudfront.mdx +++ b/deploy/route53-cloudfront.mdx @@ -28,7 +28,7 @@ Route traffic to these paths with a Cache Policy of **CachingDisabled**: - `/docs/` - Required for subpath routing - `/_mintlify/*` - Required for API playground requests -Route traffic to these paths with a Cache Policy of **CachingEnabled**: +Route traffic to these paths with a Cache Policy of **CachingOptimized**: - `/mintlify-assets/*` - Required for CSS, JavaScript, and favicons - `Default (*)` - Your website's landing page @@ -211,10 +211,13 @@ All pages should route to your main landing page. When you append your chosen su Next, connect the CloudFront distribution to your primary domain. +Before creating the Route 53 record, add your domain to the distribution. In your distribution's "General" tab, add your domain (for example, `yoursite.com`) as an **Alternate domain name (CNAME)** and attach an AWS Certificate Manager (ACM) certificate that covers it. Without an alternate domain name, CloudFront rejects requests that arrive through your domain. + For this section, you can also refer to AWS's official guide on [Configuring Amazon Route 53 to route traffic to a CloudFront - distribution](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config). + distribution](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config), + which covers these prerequisites. 1. Navigate to [Route53](https://aws.amazon.com/route53) inside the AWS console. diff --git a/editor/pages.mdx b/editor/pages.mdx index 58492841a..a8f5d57ea 100644 --- a/editor/pages.mdx +++ b/editor/pages.mdx @@ -49,6 +49,16 @@ Drag elements in the Navigation view to reorder or nest them. The editor writes To change a page's title, slug, description, or layout, open its settings from the navigation tree. See [Pages](/organize/pages) for more information on specific settings. +## Delete a page + +To delete a page, click **More options** in the top-right of the page, then click **Move to trash**. You can also delete a page from its options menu in the navigation tree. + +Deleting a page removes both the file and its navigation entry. The deletion commits to your repository when you publish. If you delete a page by mistake, use the undo prompt that appears after deleting. + +To remove a page from your published navigation without deleting its file, select **Remove from publishing** in the page's options menu in the navigation tree. + +Viewers can't delete pages. For private pages, the menu shows **Delete page** instead, and the deletion is immediate because private pages aren't committed to your repository. + ## Version history Version history lets you review and restore earlier saved versions of a page. It isn't available for `docs.json`. diff --git a/poc-onboarding.mdx b/poc-onboarding.mdx index ed137ab19..8215f28c8 100644 --- a/poc-onboarding.mdx +++ b/poc-onboarding.mdx @@ -36,7 +36,7 @@ Your repository remains the source of truth. The dashboard lets you edit, config | Documentation owner | Runs the POC and completes most steps. | A few hours total | | GitHub administrator | Approves the Mintlify GitHub App. | 15 minutes | | Designer or brand owner | Provides logos, colors, and fonts. | 30 minutes | -| Identity or IT administrator | Configures DNS for a custom domain, if you test authentication. | 1 to 2 hours | +| Identity or IT administrator | Configures DNS for a custom domain and connects your identity provider, if you test [authentication](/deploy/authentication-setup). | 1 to 2 hours | ### Gather your content and brand assets @@ -102,7 +102,7 @@ Share the goal, baseline, and criteria with your AE or SE. -Use the `.mintlify.site` URL during the POC unless you need to test authentication. Authentication requires a [custom domain](/customize/custom-domain) or `*.mintlify.app` subdomain, and does not work on a custom basepath such as `yourcompany.com/docs`. +Use the `.mintlify.site` URL during the POC. [Authentication](/deploy/authentication-setup) works on your `.mintlify.site` subdomain or a [custom domain](/customize/custom-domain), but does not work on a custom subpath such as `yourcompany.com/docs`. ## Step 2: Invite your team @@ -303,7 +303,7 @@ Most POCs take two to three weeks: | Week | Focus | |---|---| -| Week 1 | Connect the repository, invite your team, define success, and start the content migration. Start domain setup if you need authentication. | +| Week 1 | Connect the repository, invite your team, define success, and start the content migration. Start [authentication setup](/deploy/authentication-setup) if you plan to test it. | | Week 2 | Review content, publish a change, apply branding, test the assistant, and evaluate one AI workflow. | | Week 3 | Review the results with your decision maker. | From 1ed422d00d5d03eb3c4310276fbee77b1d2c404f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 27 Aug 2026 10:25:19 +0000 Subject: [PATCH 2/2] docs: mirror PR changes into es, fr, zh translations --- es/ai/mintlify-mcp.mdx | 17 +++++++++++++++-- es/cli/commands.mdx | 2 ++ es/deploy/route53-cloudfront.mdx | 12 +++++++----- es/editor/pages.mdx | 14 ++++++++++++++ es/poc-onboarding.mdx | 6 +++--- fr/ai/mintlify-mcp.mdx | 17 +++++++++++++++-- fr/cli/commands.mdx | 2 ++ fr/deploy/route53-cloudfront.mdx | 6 ++++-- fr/editor/pages.mdx | 14 ++++++++++++++ fr/poc-onboarding.mdx | 6 +++--- zh/ai/mintlify-mcp.mdx | 17 +++++++++++++++-- zh/cli/commands.mdx | 2 ++ zh/deploy/route53-cloudfront.mdx | 6 ++++-- zh/editor/pages.mdx | 14 ++++++++++++++ zh/poc-onboarding.mdx | 6 +++--- 15 files changed, 117 insertions(+), 24 deletions(-) diff --git a/es/ai/mintlify-mcp.mdx b/es/ai/mintlify-mcp.mdx index 436439a88..5a1566fad 100644 --- a/es/ai/mintlify-mcp.mdx +++ b/es/ai/mintlify-mcp.mdx @@ -11,10 +11,10 @@ keywords: ["MCP", "write access", "AI", "editing", "Claude", "ChatGPT", "Cursor" El servidor Admin MCP otorga a las herramientas de IA acceso de escritura a tu contenido y configuración de Mintlify. Úsalo para actualizar contenido y acceder a tu panel. Con el Admin MCP, puedes usar tus herramientas de IA preferidas para editar páginas, reestructurar la navegación, actualizar `docs.json`, abrir pull requests, cambiar configuraciones, crear workflows y más. -Conecta cualquier cliente MCP como Claude, Claude Code, ChatGPT o Cursor al servidor Admin MCP para colaborar en tu contenido y configuración de Mintlify con las mismas herramientas que usas para escribir código. Cuando usas el servidor Admin MCP, todos los cambios ocurren en una rama y requieren una pull request para fusionarse. Si tu organización tiene varias implementaciones, una sola conexión de Admin MCP puede acceder a todas ellas y alternar entre ellas. +Conecta cualquier cliente MCP como Claude, Claude Code, ChatGPT o Cursor al servidor Admin MCP para colaborar en tu contenido y configuración de Mintlify con las mismas herramientas que usas para escribir código. Las ediciones de contenido ocurren en una rama y se publican mediante una pull request o un commit cuando llamas a `save`. Los cambios de [gestión de implementaciones](#deployment-management), como las actualizaciones de workflows y de configuración, se aplican de inmediato a la implementación en vivo. Si tu organización tiene varias implementaciones, una sola conexión de Admin MCP puede acceder a todas ellas y alternar entre ellas. - El servidor Admin MCP permite que las herramientas de IA accedan a tu panel de Mintlify. Trátalo como a un compañero de trabajo con acceso de escritura. Conéctalo solo desde herramientas de IA de confianza y revisa cada pull request antes de fusionarla. + El servidor Admin MCP permite que las herramientas de IA accedan a tu panel de Mintlify. Trátalo como a un compañero de trabajo con acceso de escritura. Conéctalo solo desde herramientas de IA de confianza, revisa cada pull request antes de fusionarla y ten en cuenta que los cambios de gestión de implementaciones se aplican de inmediato sin una pull request. El Admin MCP es un servicio alojado por Mintlify en `https://mcp.mintlify.com`. Todos los clientes se conectan al mismo endpoint y se autentican con tu cuenta de Mintlify. @@ -187,6 +187,19 @@ También puedes anular el ajuste caso por caso pasando un `mode` explícito a `s - **`update_config`**: Modifica `docs.json` (tema, raíces de navegación, integraciones, configuración de SEO). +
+ ### Gestión de implementaciones +
+ +El modo de código gestiona las operaciones a nivel de implementación que no tienen una herramienta dedicada, como administrar workflows, la configuración de la implementación, los miembros, la facturación, las integraciones y las analíticas. Las herramientas del modo de código no requieren un `checkout`. + +- **`search_code_operations`**: Busca los métodos de gestión de implementaciones disponibles para el modo de código. Cada resultado incluye el esquema de entrada completo del método. +- **`execute_code`**: Ejecuta un script de TypeScript contra los métodos de gestión de implementaciones. Los ámbitos otorgados a la conexión controlan cada método, y cualquier método que no te haya sido otorgado devuelve un error de autorización. + + + Las escrituras del modo de código se aplican de inmediato a la implementación en vivo. No crean una rama ni abren una pull request. Confirma el cambio previsto antes de pedirle a una herramienta de IA que actualice workflows, configuraciones, miembros, facturación o integraciones. + +
### Sesión
diff --git a/es/cli/commands.mdx b/es/cli/commands.mdx index 3387a087b..8d1096489 100644 --- a/es/cli/commands.mdx +++ b/es/cli/commands.mdx @@ -6,6 +6,8 @@ keywords: ["CLI", "mint", "comandos", "flags", "referencia"] boost: 3 --- +Esta página es una referencia completa de los comandos y flags de la CLI `mint`. Para instalarla, consulta [Instalar la CLI](/es/cli/install). +
## Flags globales
diff --git a/es/deploy/route53-cloudfront.mdx b/es/deploy/route53-cloudfront.mdx index e7f56817d..e8a0bd8ab 100644 --- a/es/deploy/route53-cloudfront.mdx +++ b/es/deploy/route53-cloudfront.mdx @@ -30,7 +30,7 @@ Dirige el tráfico a estas rutas con una política de caché **CachingDisabled** - `/docs/` - Obligatorio para el enrutamiento por subruta - `/_mintlify/*` - Obligatorio para las solicitudes del playground de API -Dirige el tráfico a estas rutas con una política de caché **CachingEnabled**: +Dirige el tráfico a estas rutas con una política de caché **CachingOptimized**: - `/mintlify-assets/*` - Obligatorio para CSS, JavaScript y favicons - `Default (*)` - La página de inicio de tu sitio web @@ -75,7 +75,7 @@ Los comportamientos de tu subruta deben permitir todos los métodos HTTP. CloudF ## Agregar origen predeterminado -1. Después de crear la distribución, ve a la pestaña "Origins". +1. Después de crear la distribución, ve a la pestaña "Origins". ![Una distribución de CloudFront con la pestaña "Origins" resaltada.](/images/cloudfront/origins.png) @@ -89,7 +89,7 @@ Los comportamientos de tu subruta deben permitir todos los métodos HTTP. CloudF Si usas Vercel, usa el domain `.vercel.app` disponible para cada proyecto. -3. Crea un nuevo Origin y agrega tu URL de staging como el "Origin domain". +3. Crea un nuevo Origin y agrega tu URL de staging como el "Origin domain". ![Página de CloudFront "Create origin" con el campo de entrada "Origin domain" resaltado.](/images/cloudfront/default-origin.png) @@ -235,14 +235,16 @@ Todas las páginas deberían enrutar a tu página de inicio principal. Cuando ag A continuación, conecta la distribución de CloudFront a tu dominio principal. +Antes de crear el registro de Route 53, agrega tu dominio a la distribución. En la pestaña "General" de tu distribución, agrega tu dominio (por ejemplo, `yoursite.com`) como **Alternate domain name (CNAME)** y adjunta un certificado de AWS Certificate Manager (ACM) que lo cubra. Sin un nombre de dominio alternativo, CloudFront rechaza las solicitudes que llegan a través de tu dominio. + Para esta sección, también puedes consultar la guía oficial de AWS sobre [Configurar Amazon Route 53 para enrutar el tráfico a una - distribución de CloudFront](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config) + distribución de CloudFront](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config), que cubre estos requisitos previos. 1. Ve a [Route53](https://aws.amazon.com/route53) en la consola de AWS. -2. Ve a la "Hosted zone" de tu dominio principal. +2. Ve a la "Hosted zone" de tu dominio principal. 3. Selecciona **Create record**. diff --git a/es/editor/pages.mdx b/es/editor/pages.mdx index ab3d08fdd..cca63a438 100644 --- a/es/editor/pages.mdx +++ b/es/editor/pages.mdx @@ -65,6 +65,20 @@ Arrastre elementos en la vista Navigation para reordenarlos o anidarlos. El edit Para cambiar el título, el slug, la descripción o el layout de una página, abra su configuración desde el árbol de navegación. Consulte [Páginas](/es/organize/pages) para obtener más información sobre cada ajuste. +
+ +## Eliminar una página + +
+ +Para eliminar una página, haga clic en **More options** en la esquina superior derecha de la página y luego haga clic en **Move to trash**. También puede eliminar una página desde su menú de opciones en el árbol de navegación. + +Eliminar una página elimina tanto el archivo como su entrada de navegación. La eliminación se hace commit en su repositorio cuando publica. Si elimina una página por error, use el aviso de deshacer que aparece después de eliminarla. + +Para quitar una página de su navegación publicada sin eliminar su archivo, seleccione **Remove from publishing** en el menú de opciones de la página en el árbol de navegación. + +Los viewers no pueden eliminar páginas. Para las páginas privadas, el menú muestra **Delete page** en su lugar, y la eliminación es inmediata porque las páginas privadas no se hacen commit en su repositorio. +
## Historial de versiones diff --git a/es/poc-onboarding.mdx b/es/poc-onboarding.mdx index 5e96a78c4..5d40993a9 100644 --- a/es/poc-onboarding.mdx +++ b/es/poc-onboarding.mdx @@ -42,7 +42,7 @@ Tu repositorio sigue siendo la fuente de la verdad. El dashboard te permite edit | Responsable de la documentación | Dirige la POC y completa la mayoría de los pasos. | Unas pocas horas en total | | Administrador de GitHub | Aprueba la aplicación de GitHub de Mintlify. | 15 minutos | | Diseñador o responsable de marca | Proporciona logotipos, colores y fuentes. | 30 minutos | -| Administrador de identidad o TI | Configura el DNS para un dominio personalizado, si pruebas la autenticación. | 1 a 2 horas | +| Administrador de identidad o TI | Configura el DNS para un dominio personalizado y conecta tu proveedor de identidad, si pruebas la [autenticación](/es/deploy/authentication-setup). | 1 a 2 horas |
### Reúne tu contenido y tus recursos de marca @@ -114,7 +114,7 @@ Comparte el objetivo, la línea base y los criterios con tu AE o SE. -Usa la URL `.mintlify.site` durante la POC. La autenticación funciona en un [dominio personalizado](/es/customize/custom-domain) o en tu subdominio `.mintlify.site`, pero no funciona en un subpath personalizado como `yourcompany.com/docs`. Consulta [Configuración de autenticación](/es/deploy/authentication-setup). +Usa la URL `.mintlify.site` durante la POC. La [autenticación](/es/deploy/authentication-setup) funciona en tu subdominio `.mintlify.site` o en un [dominio personalizado](/es/customize/custom-domain), pero no funciona en un subpath personalizado como `yourcompany.com/docs`.
## Paso 2: Invita a tu equipo @@ -341,7 +341,7 @@ La mayoría de las POC toman dos a tres semanas: | Semana | Enfoque | |---|---| -| Semana 1 | Conecta el repositorio, invita a tu equipo, define el éxito y comienza la migración del contenido. Inicia la configuración del dominio si necesitas autenticación. | +| Semana 1 | Conecta el repositorio, invita a tu equipo, define el éxito y comienza la migración del contenido. Inicia la [configuración de la autenticación](/es/deploy/authentication-setup) si planeas probarla. | | Semana 2 | Revisa el contenido, publica un cambio, aplica tu marca, prueba el asistente y evalúa un flujo de trabajo de IA. | | Semana 3 | Revisa los resultados con tu responsable de la decisión. | diff --git a/fr/ai/mintlify-mcp.mdx b/fr/ai/mintlify-mcp.mdx index 9682f5dc8..7e61d282d 100644 --- a/fr/ai/mintlify-mcp.mdx +++ b/fr/ai/mintlify-mcp.mdx @@ -11,10 +11,10 @@ keywords: ["MCP", "write access", "AI", "editing", "Claude", "ChatGPT", "Cursor" Le serveur Admin MCP donne aux outils d'IA un accès en écriture à votre contenu et à vos paramètres Mintlify. Utilisez-le pour mettre à jour le contenu et accéder à votre tableau de bord. Avec l'Admin MCP, vous pouvez utiliser vos outils d'IA préférés pour modifier des pages, restructurer la navigation, mettre à jour `docs.json`, ouvrir des pull requests, modifier des paramètres, créer des workflows, et plus encore. -Connectez n'importe quel client MCP comme Claude, Claude Code, ChatGPT ou Cursor au serveur Admin MCP pour collaborer sur votre contenu et vos paramètres Mintlify avec les mêmes outils que vous utilisez pour écrire du code. Lorsque vous utilisez le serveur Admin MCP, toutes les modifications se produisent sur une branche et nécessitent une pull request pour être fusionnées. Si votre organisation dispose de plusieurs déploiements, une seule connexion Admin MCP peut accéder à tous ces déploiements et basculer entre eux. +Connectez n'importe quel client MCP comme Claude, Claude Code, ChatGPT ou Cursor au serveur Admin MCP pour collaborer sur votre contenu et vos paramètres Mintlify avec les mêmes outils que vous utilisez pour écrire du code. Les modifications de contenu se produisent sur une branche et sont livrées via une pull request ou un commit lorsque vous appelez `save`. Les changements de [gestion des déploiements](#deployment-management), tels que les mises à jour de workflows et de paramètres, s'appliquent immédiatement au déploiement en ligne. Si votre organisation dispose de plusieurs déploiements, une seule connexion Admin MCP peut accéder à tous ces déploiements et basculer entre eux. - Le serveur Admin MCP permet aux outils d'IA d'accéder à votre tableau de bord Mintlify. Considérez-le comme un collègue avec un accès en écriture. Connectez-le uniquement depuis des outils d'IA de confiance et examinez chaque pull request avant de la fusionner. + Le serveur Admin MCP permet aux outils d'IA d'accéder à votre tableau de bord Mintlify. Considérez-le comme un collègue avec un accès en écriture. Connectez-le uniquement depuis des outils d'IA de confiance, examinez chaque pull request avant de la fusionner, et sachez que les changements de gestion des déploiements s'appliquent immédiatement, sans pull request. L'Admin MCP est un service Mintlify hébergé à l'adresse `https://mcp.mintlify.com`. Chaque client se connecte au même endpoint et s'authentifie avec votre compte Mintlify. @@ -187,6 +187,19 @@ Vous pouvez également remplacer ce paramètre appel par appel en passant un `mo - **`update_config`**: Modifie `docs.json` (thème, racines de navigation, intégrations, paramètres SEO). +
+ ### Gestion des déploiements +
+ +Le mode code gère les opérations au niveau du déploiement qui n'ont pas d'outil dédié, comme la gestion des workflows, des paramètres de déploiement, des membres, de la facturation, des intégrations et des analyses. Les outils du mode code ne nécessitent pas de `checkout`. + +- **`search_code_operations`**: Recherche les méthodes de gestion des déploiements disponibles pour le mode code. Chaque résultat inclut le schéma d'entrée complet de la méthode. +- **`execute_code`**: Exécute un script TypeScript sur les méthodes de gestion des déploiements. Les scopes accordés à la connexion contrôlent chaque méthode, et toute méthode qui ne vous a pas été accordée renvoie une erreur d'autorisation. + + + Les écritures du mode code s'appliquent immédiatement au déploiement en ligne. Elles ne créent pas de branche et n'ouvrent pas de pull request. Confirmez la modification prévue avant de demander à un outil d'IA de mettre à jour des workflows, des paramètres, des membres, la facturation ou des intégrations. + +
### Session
diff --git a/fr/cli/commands.mdx b/fr/cli/commands.mdx index 368eaf07a..830b87cad 100644 --- a/fr/cli/commands.mdx +++ b/fr/cli/commands.mdx @@ -6,6 +6,8 @@ keywords: ["CLI", "mint", "commandes", "flags", "référence"] boost: 3 --- +Cette page est une référence complète des commandes et des flags de la CLI `mint`. Pour installer la CLI, consultez [Installer la CLI](/fr/cli/install). +
## Flags globaux
diff --git a/fr/deploy/route53-cloudfront.mdx b/fr/deploy/route53-cloudfront.mdx index 1d7cbf81f..93b871678 100644 --- a/fr/deploy/route53-cloudfront.mdx +++ b/fr/deploy/route53-cloudfront.mdx @@ -30,7 +30,7 @@ Dirigez le trafic vers ces chemins avec une stratégie de mise en cache (**Cache - `/docs/` - Requis pour le routage par sous-chemin - `/_mintlify/*` - Requis pour les requêtes du playground d'API -Dirigez le trafic vers ces chemins 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 **CachingOptimized** : - `/mintlify-assets/*` - Requis pour le CSS, le JavaScript et les favicons - `Default (*)` - La page d'accueil de votre site web @@ -235,10 +235,12 @@ Toutes les pages devraient être acheminées vers votre page d’accueil princip Ensuite, connectez la distribution CloudFront à votre domaine principal. +Avant de créer l'enregistrement Route 53, ajoutez votre domaine à la distribution. Dans l'onglet « General » de votre distribution, ajoutez votre domaine (par exemple, `yoursite.com`) comme **Alternate domain name (CNAME)** et attachez un certificat AWS Certificate Manager (ACM) qui le couvre. Sans nom de domaine alternatif, CloudFront rejette les requêtes qui arrivent via votre domaine. + Pour cette section, vous pouvez également consulter le guide officiel d’AWS sur la [configuration d’Amazon Route 53 pour acheminer le trafic vers une distribution - CloudFront](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config) + CloudFront](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config), qui couvre ces prérequis. 1. Accédez à [Route 53](https://aws.amazon.com/route53) dans la console AWS. diff --git a/fr/editor/pages.mdx b/fr/editor/pages.mdx index a65a2ace8..f6acda73b 100644 --- a/fr/editor/pages.mdx +++ b/fr/editor/pages.mdx @@ -65,6 +65,20 @@ Faites glisser des éléments dans la vue Navigation pour les réordonner ou les Pour modifier le titre, le slug, la description ou le layout d'une page, ouvrez ses paramètres depuis l'arborescence de navigation. Consultez [Pages](/fr/organize/pages) pour plus d'informations sur chaque paramètre. +
+ +## Supprimer une page + +
+ +Pour supprimer une page, cliquez sur **More options** en haut à droite de la page, puis sur **Move to trash**. Vous pouvez aussi supprimer une page depuis son menu d'options dans l'arborescence de navigation. + +La suppression d'une page supprime à la fois le fichier et son entrée de navigation. La suppression est commitée dans votre dépôt lorsque vous publiez. Si vous supprimez une page par erreur, utilisez l'invite d'annulation qui apparaît après la suppression. + +Pour retirer une page de votre navigation publiée sans supprimer son fichier, sélectionnez **Remove from publishing** dans le menu d'options de la page dans l'arborescence de navigation. + +Les viewers ne peuvent pas supprimer de pages. Pour les pages privées, le menu affiche **Delete page** à la place, et la suppression est immédiate car les pages privées ne sont pas commitées dans votre dépôt. +
## Historique des versions diff --git a/fr/poc-onboarding.mdx b/fr/poc-onboarding.mdx index 8aef458c5..e53c0d5db 100644 --- a/fr/poc-onboarding.mdx +++ b/fr/poc-onboarding.mdx @@ -42,7 +42,7 @@ Votre dépôt reste la source de vérité. Le tableau de bord vous permet de mod | Responsable de la documentation | Pilote le POC et réalise la plupart des étapes. | Quelques heures au total | | Administrateur GitHub | Approuve la GitHub App Mintlify. | 15 minutes | | Designer ou responsable de la marque | Fournit les logos, les couleurs et les polices. | 30 minutes | -| Administrateur des identités ou IT | Configure le DNS pour un domaine personnalisé, si vous testez l'authentification. | 1 à 2 heures | +| Administrateur des identités ou IT | Configure le DNS pour un domaine personnalisé et connecte votre fournisseur d'identité, si vous testez l'[authentification](/fr/deploy/authentication-setup). | 1 à 2 heures |
### Rassembler votre contenu et vos éléments de marque @@ -114,7 +114,7 @@ Partagez l'objectif, la valeur de référence et les critères avec votre AE ou -Utilisez l'URL `.mintlify.site` pendant le POC. L'authentification fonctionne sur un [domaine personnalisé](/fr/customize/custom-domain) ou votre sous-domaine `.mintlify.site`, mais ne fonctionne pas sur un sous-chemin personnalisé tel que `yourcompany.com/docs`. Consultez [Configuration de l'authentification](/fr/deploy/authentication-setup). +Utilisez l'URL `.mintlify.site` pendant le POC. L'[authentification](/fr/deploy/authentication-setup) fonctionne sur votre sous-domaine `.mintlify.site` ou un [domaine personnalisé](/fr/customize/custom-domain), mais ne fonctionne pas sur un sous-chemin personnalisé tel que `yourcompany.com/docs`.
## Étape 2 : inviter votre équipe @@ -341,7 +341,7 @@ La plupart des POC durent deux à trois semaines : | Semaine | Priorité | |---|---| -| Semaine 1 | Connecter le dépôt, inviter votre équipe, définir la réussite et démarrer la migration du contenu. Commencer la configuration du domaine si vous avez besoin de l'authentification. | +| Semaine 1 | Connecter le dépôt, inviter votre équipe, définir la réussite et démarrer la migration du contenu. Commencer la [configuration de l'authentification](/fr/deploy/authentication-setup) si vous prévoyez de la tester. | | Semaine 2 | Vérifier le contenu, publier une modification, appliquer l'image de marque, tester l'assistant et évaluer un workflow d'IA. | | Semaine 3 | Passer en revue les résultats avec votre décideur. | diff --git a/zh/ai/mintlify-mcp.mdx b/zh/ai/mintlify-mcp.mdx index 84e3d7c02..cbc282999 100644 --- a/zh/ai/mintlify-mcp.mdx +++ b/zh/ai/mintlify-mcp.mdx @@ -11,10 +11,10 @@ keywords: ["MCP", "写入权限", "AI", "编辑", "Claude", "ChatGPT", "Cursor", 管理员 MCP 服务器赋予 AI 工具对你的 Mintlify 内容和设置的写入权限。可使用它来更新内容并访问你的控制台。借助管理员 MCP,你可以使用你常用的 AI 工具来编辑页面、调整导航结构、更新 `docs.json`、提交拉取请求、修改设置、创建工作流等等。 -将任意 MCP 客户端 (例如 Claude、Claude Code、ChatGPT 或 Cursor) 连接到管理员 MCP 服务器,即可使用与编写代码相同的工具协同处理你的 Mintlify 内容和设置。使用管理员 MCP 服务器时,所有更改都会发生在某个 branch 上,并需要通过拉取请求合并。如果你的组织有多个部署,单个管理员 MCP 连接即可访问所有这些部署并在它们之间切换。 +将任意 MCP 客户端 (例如 Claude、Claude Code、ChatGPT 或 Cursor) 连接到管理员 MCP 服务器,即可使用与编写代码相同的工具协同处理你的 Mintlify 内容和设置。内容编辑会发生在某个 branch 上,并在你调用 `save` 时通过拉取请求或提交交付。[部署管理](#deployment-management)更改 (例如工作流和设置更新) 会立即应用到线上部署。如果你的组织有多个部署,单个管理员 MCP 连接即可访问所有这些部署并在它们之间切换。 - 管理员 MCP 服务器允许 AI 工具访问你的 Mintlify 控制台。请将其视为拥有写入权限的同事。仅从受信任的 AI 工具连接它,并在合并前审查每一个拉取请求。 + 管理员 MCP 服务器允许 AI 工具访问你的 Mintlify 控制台。请将其视为拥有写入权限的同事。仅从受信任的 AI 工具连接它,在合并前审查每一个拉取请求,并注意部署管理更改会在没有拉取请求的情况下立即生效。 管理员 MCP 是由 Mintlify 托管的服务,地址为 `https://mcp.mintlify.com`。每个客户端都连接到同一个端点,并使用你的 Mintlify 账户进行身份认证。 @@ -187,6 +187,19 @@ keywords: ["MCP", "写入权限", "AI", "编辑", "Claude", "ChatGPT", "Cursor", - **`update_config`**: 修改 `docs.json` (主题、导航根节点、集成、SEO 设置)。 +
+ ### 部署管理 +
+ +代码模式 (code mode) 用于处理没有专用工具的部署级操作,例如管理工作流、部署设置、成员、账单、集成和分析。代码模式的工具不需要执行 `checkout`。 + +- **`search_code_operations`**: 搜索代码模式可用的部署管理方法。每个结果都包含该方法的完整输入 schema。 +- **`execute_code`**: 针对部署管理方法运行一段 TypeScript 脚本。连接被授予的作用域会控制每个方法的访问权限,任何未被授予的方法都会返回授权错误。 + + + 代码模式的写入会立即应用到线上部署。它们不会创建 branch,也不会打开拉取请求。在提示 AI 工具更新工作流、设置、成员、账单或集成之前,请先确认预期的更改。 + +
### 会话
diff --git a/zh/cli/commands.mdx b/zh/cli/commands.mdx index 7d61d208b..a3aeac18f 100644 --- a/zh/cli/commands.mdx +++ b/zh/cli/commands.mdx @@ -6,6 +6,8 @@ keywords: ["CLI", "mint", "命令", "选项", "参考"] boost: 3 --- +本页是 `mint` CLI 命令和选项的完整参考。若要安装 CLI,请参阅[安装 CLI](/zh/cli/install)。 +
## 全局选项
diff --git a/zh/deploy/route53-cloudfront.mdx b/zh/deploy/route53-cloudfront.mdx index 749fa7e0a..a0e639059 100644 --- a/zh/deploy/route53-cloudfront.mdx +++ b/zh/deploy/route53-cloudfront.mdx @@ -30,7 +30,7 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx"; - `/docs/` - 用于子路径路由 - `/_mintlify/*` - 用于 API playground 请求 -将流量路由到以下路径,并将缓存策略(Cache Policy)设置为 **CachingEnabled**: +将流量路由到以下路径,并将缓存策略(Cache Policy)设置为 **CachingOptimized**: - `/mintlify-assets/*` - 用于 CSS、JavaScript 和 favicon - `Default (*)` - 你的网站着陆页 @@ -235,8 +235,10 @@ CloudFront 中的行为用于控制子路径逻辑。总体而言,我们希望 接下来,将 CloudFront 分配连接到你的主域名。 +在创建 Route 53 记录之前,请先将你的域名添加到该分配。在分配的 “General” 标签页中,将你的域名(例如 `yoursite.com`)添加为 **Alternate domain name (CNAME)**,并附加一个覆盖该域名的 AWS Certificate Manager (ACM) 证书。如果没有备用域名,CloudFront 会拒绝通过你的域名到达的请求。 + - 本节你也可以参考 AWS 的官方指南:[将 Amazon Route 53 配置为将流量路由到 CloudFront 分配](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config) + 本节你也可以参考 AWS 的官方指南:[将 Amazon Route 53 配置为将流量路由到 CloudFront 分配](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config),其中涵盖了这些前提条件。 1. 在 AWS 控制台中进入 [Route53](https://aws.amazon.com/route53)。 diff --git a/zh/editor/pages.mdx b/zh/editor/pages.mdx index d4c0d6276..15b23bb26 100644 --- a/zh/editor/pages.mdx +++ b/zh/editor/pages.mdx @@ -65,6 +65,20 @@ Home 默认会隐藏部分文件,包括 `docs.json`、名称以点开头的文 若要修改页面的标题、slug、描述或 layout,请从导航树中打开该页面的设置。有关各项设置的更多信息,请参阅[页面](/zh/organize/pages)。 +
+ +## 删除页面 + +
+ +若要删除页面,请点击页面右上角的 **More options**,然后点击 **Move to trash**。你也可以在导航树中通过页面的选项菜单删除页面。 + +删除页面会同时移除文件及其导航条目。删除操作会在你发布时提交到你的仓库。如果误删了页面,请使用删除后出现的撤销提示。 + +若要在不删除文件的情况下把页面从已发布的导航中移除,请在导航树中该页面的选项菜单里选择 **Remove from publishing**。 + +Viewers 无法删除页面。对于私有页面,菜单会显示 **Delete page**,并且删除会立即生效,因为私有页面不会提交到你的仓库。 +
## 版本历史 diff --git a/zh/poc-onboarding.mdx b/zh/poc-onboarding.mdx index eb2ee7125..994bb2803 100644 --- a/zh/poc-onboarding.mdx +++ b/zh/poc-onboarding.mdx @@ -42,7 +42,7 @@ noindex: true | 文档负责人 | 主导 POC 并完成大部分步骤。 | 总计几个小时 | | GitHub 管理员 | 批准 Mintlify GitHub 应用。 | 15 分钟 | | 设计师或品牌负责人 | 提供徽标、颜色和字体。 | 30 分钟 | -| 身份或 IT 管理员 | 如果你要测试身份验证,为自定义域名配置 DNS。 | 1 到 2 小时 | +| 身份或 IT 管理员 | 如果你要测试[身份验证](/zh/deploy/authentication-setup),为自定义域名配置 DNS 并连接你的身份提供商。 | 1 到 2 小时 |
### 收集你的内容和品牌资产 @@ -114,7 +114,7 @@ noindex: true -在 POC 期间请使用 `.mintlify.site` URL。身份验证可在[自定义域名](/zh/customize/custom-domain)或你的 `.mintlify.site` 子域名上使用,但在自定义子路径(例如 `yourcompany.com/docs`)上不起作用。请参阅[身份验证设置](/zh/deploy/authentication-setup)。 +在 POC 期间请使用 `.mintlify.site` URL。[身份验证](/zh/deploy/authentication-setup)可在你的 `.mintlify.site` 子域名或[自定义域名](/zh/customize/custom-domain)上使用,但在自定义子路径(例如 `yourcompany.com/docs`)上不起作用。
## 第 2 步:邀请你的团队 @@ -341,7 +341,7 @@ noindex: true | 周 | 重点 | |---|---| -| 第 1 周 | 连接仓库、邀请团队、定义成功标准并开始内容迁移。如果需要身份验证,开始域名设置。 | +| 第 1 周 | 连接仓库、邀请团队、定义成功标准并开始内容迁移。如果你计划测试身份验证,请开始进行[身份验证设置](/zh/deploy/authentication-setup)。 | | 第 2 周 | 审查内容、发布一次更改、应用品牌样式、测试助手并评估一个 AI 工作流。 | | 第 3 周 | 与决策者一起审查结果。 |