- 
-
+On the [Assistant](https://app.mintlify.com/products/assistant) page in your dashboard, click the status toggle to enable or disable the assistant for your site.
## Set deflection emails
@@ -51,11 +46,6 @@ In the Response Handling section, configure domains that the assistant can use f
- Domains must be publicly available.
- The assistant can't search domains that require JavaScript to load.
-
- 
- 
-
-
For more precise control over what the assistant can search, use filtering syntax.
- **Domain-level filtering**
diff --git a/assistant/use.mdx b/assistant/use.mdx
index 51d44250e4..1a98cebbaa 100644
--- a/assistant/use.mdx
+++ b/assistant/use.mdx
@@ -83,11 +83,6 @@ https://yourdocs.mintlify.site/quickstart?assistant=How%20do%20I%20get%20started
Highlight text on a page and click the **Add to assistant** button to open the assistant chat panel and add the highlighted text as context. You can add multiple text snippets or code blocks to the assistant's context.
-
-
-
-
-
## Code blocks
Click the **Ask Assistant** button in a code block to open the assistant chat panel and add the code block as context. You can add multiple code blocks or text snippets to the assistant's context.
@@ -110,11 +105,6 @@ Limits:
- Maximum file size: 5 MB per attachment
- Maximum attachments per message: 10
-
-
-
-
-
## Troubleshooting
- 
-
-
If the automation can run with default settings, it activates immediately. Otherwise, the automation's configure page opens so you can fill in any required configurations.
3. If the configure page opens, fill in the required fields and click **Save**.
@@ -125,12 +116,12 @@ When you re-enable a scheduled automation or change its schedule, Mintlify recal
## Delete an automation
+Deletion is permanent and cannot be undone.
+
1. Open the [Automations](https://app.mintlify.com/products/automations) page in your dashboard.
2. Click the 
-
-
### Revisit a previous run
`mint test` saves a report for each completed run. When a saved report exists, the next interactive run starts with options for it:
diff --git a/cli/preview.mdx b/cli/preview.mdx
index c8bbadc047..b2ec8fc732 100644
--- a/cli/preview.mdx
+++ b/cli/preview.mdx
@@ -43,7 +43,7 @@ You must authenticate the CLI with your Mintlify account to enable search and th
mint login
```
-After you authenticate with the `mint login` command, the CLI stores your credentials in `~/.config/mintlify/config.json` so you stay logged in across sessions. The CLI also prompts you to select a default project, which commands like `mint automations` use.
+After you authenticate with the `mint login` command, the CLI stores your credentials in `~/.config/mintlify/config.json` so you stay logged in across sessions. The CLI also prompts you to select a default project.
Once logged in, run `mint dev` to start the local preview with search and the assistant enabled. The assistant uses the same indexed content as your deployed documentation site.
diff --git a/contact-support.mdx b/contact-support.mdx
index 21f9dd950a..d27a27f170 100644
--- a/contact-support.mdx
+++ b/contact-support.mdx
@@ -13,11 +13,7 @@ Visit our [YouTube](https://www.youtube.com/@GetMintlify/videos) channel for tut
## Message support
-Send us a message from your [dashboard](https://app.mintlify.com/). Click the 
-
+Send us a message from your [dashboard](https://app.mintlify.com/). Click 
-
+Install the Mintlify GitHub App on the [Git settings](https://app.mintlify.com/settings/project/git-settings) page of your dashboard. When GitHub asks which repositories to grant access to, choose **Only select repositories** and select your documentation repository.
## Permissions
diff --git a/deploy/gitlab.mdx b/deploy/gitlab.mdx
index 4fb0d056f3..7bf866af0b 100644
--- a/deploy/gitlab.mdx
+++ b/deploy/gitlab.mdx
@@ -32,9 +32,6 @@ When you open [Git Settings](https://app.mintlify.com/settings/project/git-setti
-
-
-
- 
-
-
-
-
- 
-
- 
-
+2. Click the preview you want to redeploy.
+3. Click **Redeploy**.
## Preview widget
@@ -95,10 +89,6 @@ Restrict preview access to authenticated members of your Mintlify organization.
1. Go to the **Previews** section of the [General](https://app.mintlify.com/settings/project/general) page in your dashboard.
2. Click the **Preview authentication** toggle to enable or disable preview authentication.
-
- 
- 
-
### Password-protect an individual preview
@@ -109,10 +99,6 @@ Password-protect a specific preview to share it with external reviewers without
3. Click **Create custom preview**.
4. Enter the name of the branch you want to preview.
5. Toggle **Make private** on and enter a password. Passwords must be at least 8 characters.
-
- 
- 
-
6. Click **Create preview**.
## Preview lifetime
diff --git a/deploy/route53-cloudfront.mdx b/deploy/route53-cloudfront.mdx
index 7acb28a2f4..ad9549f509 100644
--- a/deploy/route53-cloudfront.mdx
+++ b/deploy/route53-cloudfront.mdx
@@ -41,23 +41,9 @@ The behaviors for your subpath must allow all HTTP methods. CloudFront only allo
1. Navigate to [CloudFront](https://aws.amazon.com/cloudfront) inside the AWS console.
2. Click **Create distribution**.
-
-
- 
-
-
3. For the Origin domain, input `[SUBDOMAIN].mintlify.site` where `[SUBDOMAIN]` is your project's unique subdomain.
-
-
- 
-
-
4. For "Web Application Firewall (WAF)," enable security protections.
-
- 
-
-
-
-
-
+
@@ -56,26 +48,26 @@ Añade el campo `contextual` a tu archivo `docs.json` y especifica qué opciones
```json
{
- "contextual": {
- "options": [
- "copy",
- "view",
- "assistant",
- "download-pdf",
- "chatgpt",
- "claude",
- "perplexity",
+ "contextual": {
+ "options": [
+ "copy",
+ "view",
+ "assistant",
+ "chatgpt",
+ "claude",
+ "perplexity",
"grok",
- "aistudio",
- "devin",
- "devin-desktop",
- "mcp",
+ "aistudio",
+ "devin",
+ "devin-desktop",
+ "mcp",
"cursor",
"vscode",
"devin-mcp",
- "downloadApiSpec"
+ "download-spec",
+ "download-pdf"
]
- }
+ }
}
```
@@ -99,7 +91,7 @@ De forma predeterminada, el menú contextual aparece en el encabezado de la pág
| `header` | Muestra las opciones en el menú contextual de la parte superior de la página (predeterminado) |
| `toc` | Muestra las opciones en la barra lateral de la tabla de contenidos |
-
+
## Agregar opciones personalizadas
@@ -184,7 +176,7 @@ contextual:
---
```
-Se aplican los mismos campos y reglas de validación que en `docs.json`, incluidas las [opciones personalizadas](#adding-custom-options) y la configuración `display`. Si la sobrescritura de página no es válida, Mintlify utiliza la configuración global de `contextual`.
+Se aplican los mismos campos y reglas de validación que en `docs.json`, incluidas las [opciones personalizadas](#add-custom-options) y la configuración `display`. Si la sobrescritura de página no es válida, Mintlify utiliza la configuración global de `contextual`.
### Ejemplos de opciones personalizadas
diff --git a/es/analytics/export.mdx b/es/analytics/export.mdx
index 20022728d3..da669e1cd3 100644
--- a/es/analytics/export.mdx
+++ b/es/analytics/export.mdx
@@ -15,20 +15,6 @@ Exporta categorías de analíticas a CSV para análisis más profundos, informes
2. Selecciona una categoría para exportar: tráfico, referencias, conversaciones del assistant, búsquedas o comentarios.
3. Espera a que Mintlify te envíe por correo un enlace de descarga.
-
- 
-
- 
-
-
-
- 
-
+Usa el selector de rango en una vista de analíticas para ajustar el período de los datos mostrados. Elige un rango predefinido, como **Last 7 days** o **All time**, o selecciona un rango personalizado en el calendario. Las exportaciones también usan el rango de tiempo seleccionado.
diff --git a/es/api-playground/troubleshooting.mdx b/es/api-playground/troubleshooting.mdx
index 0806a59a4b..cbd5ded456 100644
--- a/es/api-playground/troubleshooting.mdx
+++ b/es/api-playground/troubleshooting.mdx
@@ -26,11 +26,7 @@ Si sus páginas de la API no se muestran correctamente, revise estos problemas d
pasa la validación aquí, hay muchas probabilidades de que el problema esté en otra parte.
Además, Mintlify no es compatible con OpenAPI 2.0. Si tu documento usa esta versión de la especificación,
- podrías encontrarte con este problema. Puedes convertir tu documento en [editor.swagger.io](https://editor.swagger.io/) (en Edit > Convert to OpenAPI 3):
-
-
- 
-
+ podrías encontrarte con este problema. Puedes convertir tu documento en [editor.swagger.io](https://editor.swagger.io/) (en Edit > Convert to OpenAPI 3).
diff --git a/es/api/automations/trigger.mdx b/es/api/automations/trigger.mdx
index 6319843cf0..e91e6fbc4d 100644
--- a/es/api/automations/trigger.mdx
+++ b/es/api/automations/trigger.mdx
@@ -16,12 +16,6 @@ Este endpoint solo admite automatizaciones configuradas con un activador de **Pr
- **Eventos de versión**: Ejecuta la automatización **Draft changelog** cuando creas una etiqueta de versión, para que el changelog se redacte al mismo tiempo que se publica la versión.
- **Herramientas personalizadas**: Activa automatizaciones desde herramientas internas, comandos de Slack o tareas programadas que ya ejecutas.
-
-
-
-
-
-
-
-
-
## Interpretar las exportaciones de tráfico
diff --git a/es/analytics/index.mdx b/es/analytics/index.mdx
index 7ff0c690e5..97daf6be1b 100644
--- a/es/analytics/index.mdx
+++ b/es/analytics/index.mdx
@@ -17,8 +17,8 @@ La página de [analíticas](https://app.mintlify.com/analytics) en tu dashboard
Los datos de analíticas suelen aparecer a los pocos minutos de una interacción. Los eventos muy recientes podrían no aparecer de inmediato.
-
- ## Elige una vista de analíticas
+
@@ -47,26 +47,12 @@ Los datos de analíticas suelen aparecer a los pocos minutos de una interacción
## Filtrar por período
-Usa el selector de rango en una vista de analíticas para ajustar el período de los datos mostrados. Las exportaciones también usan el rango de tiempo seleccionado.
-
-
-
+ ## Selecciona una vista de analíticas
-
-
-
+Usa el selector de rango en una vista de analíticas para ajustar el período de los datos mostrados. Elige un rango predefinido, como **Last 7 days** o **All time**, o selecciona un rango personalizado en el calendario. Las exportaciones también usan el rango de tiempo seleccionado.
## Filtrar por página o ruta
-Usa el menú **Filter** para acotar el panel a una sola página o ruta. Cuando seleccionas una ruta, la página de analíticas muestra datos de cada ruta dentro de esa ruta. Por ejemplo, si filtras por `docs/authentication`, la página de analíticas muestra datos de todas las páginas del path `docs/authentication/*`. Las vistas Assistant y Search siempre muestran datos de todo el sitio.
+Usa el menú **Filter** para acotar el panel a una sola página o ruta. Cuando seleccionas una ruta, la página de analíticas muestra datos de cada página dentro de esa ruta. Por ejemplo, si filtras por `docs/authentication`, la página de analíticas muestra datos de todas las páginas del path `docs/authentication/*`. Las vistas Assistant y Search siempre muestran datos de todo el sitio.
En la vista Traffic, filtrar por página cambia el ranking de páginas populares para que comience en la página seleccionada y continúe hacia abajo en el ranking, en lugar de mostrar solo esa página.
diff --git a/es/api-playground/adding-sdk-examples.mdx b/es/api-playground/adding-sdk-examples.mdx
index d87c6b1505..a0e46c1788 100644
--- a/es/api-playground/adding-sdk-examples.mdx
+++ b/es/api-playground/adding-sdk-examples.mdx
@@ -74,10 +74,6 @@ Ve a tu [Panel de Speakeasy](https://app.speakeasy.com) y abre la pestaña **API
Desde la página de la entrada del registro, copia la URL pública proporcionada.
-
-
-
-
-## Encuentra el ID de la automatización
-
-
-Ejecuta [`mint automations list`](/es/cli/commands#mint-automations-list) en tu terminal y copia el ID de la salida.
-
## Ejemplo
diff --git a/es/assistant/configure.mdx b/es/assistant/configure.mdx
index f64562f960..34fa1a1848 100644
--- a/es/assistant/configure.mdx
+++ b/es/assistant/configure.mdx
@@ -4,20 +4,15 @@ description: "Configura el assistant de IA en el dashboard de Mintlify: disponib
keywords: ["assistant", "configuración", "derivación", "protección contra bots", "facturación"]
---
-Configura el assistant en la página [Assistant](https://dashboard.mintlify.com/products/assistant) de tu dashboard. Administra la facturación y el uso en la página [Uso](https://dashboard.mintlify.com/settings/organization/usage).
+Configura el assistant en la página [Assistant](https://app.mintlify.com/products/assistant) de tu dashboard. Administra la facturación y el uso en la página [Uso](https://app.mintlify.com/settings/organization/usage).
## Habilitar o deshabilitar el assistant
-Cambia el estado para habilitar o deshabilitar el assistant en tu sitio de documentación.
+En la página [Assistant](https://app.mintlify.com/products/assistant) de tu dashboard, haz clic en el interruptor de estado para habilitar o deshabilitar el assistant en tu sitio.
-
-
-
-
-
-
+
+Si prefieres dirigir las preguntas de soporte a tus canales existentes, desactiva **Contact form** en la sección Manejo de respuestas.
-
- 
- 
-
+Cuando desactivas el formulario de contacto, el assistant dirige a los usuarios a tu dirección de correo de soporte como texto plano en lugar de mostrar el formulario dentro del chat. Las preguntas de ventas siguen usando el formulario dentro del chat cuando configuras un correo de ventas.
+
-
-
-
Para un control más preciso sobre lo que el assistant puede buscar, usa la sintaxis de filtrado.
- **Filtrado a nivel de dominio**
@@ -84,7 +73,7 @@ Ayuda a tus usuarios a iniciar conversaciones con el assistant agregando pregunt
El assistant puede generar preguntas específicas de la página basándose en la página que el usuario está viendo, o puedes agregar preguntas persistentes que estén disponibles en todas las páginas.
-Puedes agregar hasta tres preguntas iniciales. Haz clic en **Preguntar al asistente** para obtener preguntas recomendadas basadas en tu documentación.
+Puedes agregar hasta tres preguntas iniciales. Haz clic en **Ask Assistant** para obtener preguntas recomendadas basadas en tu documentación.
@@ -99,7 +88,7 @@ En la sección **Bot Protection**, habilita captcha invisible para proteger tu a
Para habilitar la protección contra bots:
-1. Ve a la página de [configuración del Assistant](https://dashboard.mintlify.com/products/assistant/settings) en tu dashboard.
+1. Ve a la página de [configuración del Assistant](https://app.mintlify.com/products/assistant/settings) en tu dashboard.
2. En la sección **Bot Protection**, activa **Invisible Captcha**.
Los cambios tardan hasta 10 minutos en propagarse.
@@ -142,4 +131,4 @@ En la sección **Spending controls** de tu dashboard, configura alertas de uso p
### Volúmenes de créditos más altos
-Si 10,000 créditos al mes no son suficientes, [contacta con ventas](mailto:sales@mintlify.com) para hablar de un plan Enterprise con paquetes de créditos personalizados.
+Para planes de más de 10,000 créditos al mes, [contacta con ventas](mailto:sales@mintlify.com) para hablar de paquetes de créditos personalizados.
diff --git a/es/assistant/index.mdx b/es/assistant/index.mdx
index c6ccf124ab..2964750ba5 100644
--- a/es/assistant/index.mdx
+++ b/es/assistant/index.mdx
@@ -38,7 +38,7 @@ Por defecto, el assistant no indexa páginas ocultas. Para incluir páginas ocul
El assistant solo responde preguntas basándose en la información de tu documentación. Si no puede encontrar información relevante después de buscar, responde que no tiene suficiente información para contestar.
-Puedes [configurar un correo de derivación](/es/assistant/configure#set-deflection-email) para que el assistant proporcione tu correo de soporte a los usuarios cuyas preguntas no puede responder. Esto da a los usuarios un camino a seguir, incluso si la documentación no aborda su pregunta específica.
+Puedes [configurar un correo de derivación](/es/assistant/configure#set-deflection-emails) para que el assistant proporcione tu correo de soporte a los usuarios cuyas preguntas no puede responder. Esto da a los usuarios un camino a seguir, incluso si la documentación no aborda su pregunta específica.
## Configurar correos de derivación
@@ -32,18 +27,17 @@ Cuando habilitas la derivación y el assistant detecta una pregunta que coincide
El mismo formulario de contacto está disponible en el [widget del assistant](/es/assistant/widget) integrado en otros sitios.
-Si prefieres dirigir las preguntas de soporte a tus canales existentes, desactiva **Mostrar formulario de contacto** en la sección Manejo de respuestas. Cuando el formulario de contacto está desactivado, el assistant dirige a los usuarios a tu dirección de correo de soporte como texto plano en lugar de mostrar el formulario dentro del chat. Las preguntas de ventas siguen usando el formulario dentro del chat cuando hay un correo de ventas configurado. Este ajuste está activado por defecto.
+
-
-
+Cuando desactivas el formulario de contacto, el assistant dirige a los usuarios a tu dirección de correo de soporte como texto plano en lugar de mostrar el formulario dentro del chat. Las preguntas de ventas siguen usando el formulario dentro del chat cuando configuras un correo de ventas.
+
## Desviar a un enlace de soporte
-Cambia el modo de derivación a **Enlace** para enviar a los usuarios a tu plataforma de soporte existente (por ejemplo, un centro de ayuda, un portal de tickets o un foro de la comunidad) en lugar de recopilar el correo mediante un formulario dentro del chat.
+Cambia el modo de derivación a **Link** para enviar a los usuarios a tu plataforma de soporte existente (por ejemplo, un centro de ayuda, un portal de tickets o un foro de la comunidad) en lugar de recopilar el correo mediante un formulario dentro del chat.
Introduce la URL completa de tu destino de soporte. La URL debe usar `http` o `https` y no puede incluir credenciales.
@@ -60,11 +54,6 @@ En la sección Manejo de respuestas, configura los dominios en los que el assist
- Los dominios deben ser accesibles públicamente.
- El assistant no puede buscar en dominios que requieran JavaScript para cargar.
-
-
-
-
-
Para un control más preciso sobre lo que el assistant puede buscar, usa la sintaxis de filtrado.
- **Filtrado a nivel de dominio**
@@ -84,7 +73,7 @@ Ayuda a tus usuarios a iniciar conversaciones con el assistant agregando pregunt
El assistant puede generar preguntas específicas de la página basándose en la página que el usuario está viendo, o puedes agregar preguntas persistentes que estén disponibles en todas las páginas.
-Puedes agregar hasta tres preguntas iniciales. Haz clic en **Preguntar al asistente** para obtener preguntas recomendadas basadas en tu documentación.
+Puedes agregar hasta tres preguntas iniciales. Haz clic en **Ask Assistant** para obtener preguntas recomendadas basadas en tu documentación.
@@ -99,7 +88,7 @@ En la sección **Bot Protection**, habilita captcha invisible para proteger tu a
Para habilitar la protección contra bots:
-1. Ve a la página de [configuración del Assistant](https://dashboard.mintlify.com/products/assistant/settings) en tu dashboard.
+1. Ve a la página de [configuración del Assistant](https://app.mintlify.com/products/assistant/settings) en tu dashboard.
2. En la sección **Bot Protection**, activa **Invisible Captcha**.
Los cambios tardan hasta 10 minutos en propagarse.
@@ -142,4 +131,4 @@ En la sección **Spending controls** de tu dashboard, configura alertas de uso p
### Volúmenes de créditos más altos
## Información del assistant
diff --git a/es/assistant/use.mdx b/es/assistant/use.mdx
index 2eccb531da..6a7a816d8c 100644
--- a/es/assistant/use.mdx
+++ b/es/assistant/use.mdx
@@ -93,20 +93,15 @@ https://yourdocs.mintlify.site/quickstart?assistant=How%20do%20I%20get%20started
Resalta texto en una página y haz clic en el botón emergente **Add to assistant** para abrir el panel de chat del assistant y agregar el texto resaltado como contexto. Puedes agregar múltiples fragmentos de texto o bloques de código al contexto del assistant.
-
-
-
-
-
-
+
+
-
-
-
## Bloques de código
-Haz clic en el botón **Preguntar al asistente** en un bloque de código para abrir el panel de chat del assistant y agregar el bloque de código como contexto. Puedes agregar múltiples bloques de código o fragmentos de texto al contexto del assistant.
+Haz clic en el botón **Ask Assistant** en un bloque de código para abrir el panel de chat del assistant y agregar el bloque de código como contexto. Puedes agregar múltiples bloques de código o fragmentos de texto al contexto del assistant.
-
-
+
+
@@ -124,11 +119,6 @@ Límites:
- Tamaño máximo de archivo: 5 MB por adjunto
- Máximo de adjuntos por mensaje: 10
-
-
-
-
-
-Los administradores de la organización pueden requerir que todos los miembros de la organización inicien sesión a través de tu proveedor de identidad. Cuando Require SSO (Requerir SSO) está activado, Mintlify rechaza los inicios de sesión con contraseña, enlace mágico y Google OAuth.
+Para exigir que todos los miembros de tu organización inicien sesión a través de tu proveedor de identidad, activa **Require SSO**. Cuando **Require SSO** está activado, Mintlify rechaza los inicios de sesión con contraseña, enlace mágico y Google OAuth.
1. Ve a la página [Identity & access](https://app.mintlify.com/settings/organization/sso) en tu dashboard.
2. Confirma que el SSO funciona de extremo a extremo. En una ventana de navegación privada, inicia sesión en tu dashboard de Mintlify desde el catálogo de aplicaciones de tu proveedor de identidad (iniciado por el IdP) y desde la [página de inicio de sesión de Mintlify](https://app.mintlify.com/login) con un correo electrónico de un dominio verificado (iniciado por el SP). Ambos flujos deben redirigirte a través de tu proveedor de identidad y llevarte al dashboard.
@@ -235,15 +235,9 @@ Para proveedores distintos de Microsoft Entra u Okta SAML, [contáctanos](mailto
1. En Google Workspace, ve a **Web and mobile apps**.
2. Haz clic en **Add custom SAML app** en el menú desplegable **Add app**.
-
- 
-
Copia la SSO URL, el Entity ID y el certificado x509 proporcionados y envíalos al equipo de Mintlify.
-
- 
-
En la página Service provider details, introduce lo siguiente:
@@ -253,10 +247,6 @@ Para proveedores distintos de Microsoft Entra u Okta SAML, [contáctanos](mailto
* Name ID format: `EMAIL`
* Name ID: `Basic Information > Primary email`
-
- 
-
-
En la página siguiente, introduce las siguientes declaraciones de atributos:
| Google Directory Attribute | App Attribute |
diff --git a/es/deploy/github.mdx b/es/deploy/github.mdx
index fcf2c2ab56..aac64d68af 100644
--- a/es/deploy/github.mdx
+++ b/es/deploy/github.mdx
@@ -65,15 +65,7 @@ Después de completar cualquiera de las opciones, instala la Aplicación de GitH
Debes ser propietario de la organización o tener permisos de administrador en un repositorio para instalar la aplicación. Si no cuentas con los permisos necesarios, el propietario del repositorio debe aprobar la solicitud de instalación.
-Instala la Aplicación de GitHub de Mintlify desde tu [dashboard](https://dashboard.mintlify.com/settings/organization/github-app).
-
-
-
-
+Instala la Aplicación de GitHub de Mintlify en la página [Git settings](https://app.mintlify.com/settings/project/git-settings) de tu dashboard. Cuando GitHub te pregunte a qué repositorios quieres dar acceso, elige **Only select repositories** y selecciona tu repositorio de documentación.
-
-
-
## Solución de problemas
diff --git a/es/assistant/widget.mdx b/es/assistant/widget.mdx
index 8c99bf0840..7f18b6d931 100644
--- a/es/assistant/widget.mdx
+++ b/es/assistant/widget.mdx
@@ -16,7 +16,7 @@ El [asistente](/es/assistant) responde preguntas en tu sitio de Mintlify. Para i
Añade el widget a cualquier sitio web o aplicación web con un script alojado. El widget gestiona su propio activador y se renderiza dentro de un Shadow DOM cerrado, lo que evita que los estilos de tu aplicación afecten al widget.
-La única opción de navegador obligatoria es el ID público del widget. Gestiona el estado de activación, los orígenes permitidos, los adjuntos, la protección contra bots y el [formulario de contacto de deflection](/es/assistant/configure#set-deflection-email) desde tu panel. Configura las preguntas iniciales específicas del embed y un correo electrónico de soporte en la configuración del navegador.
+La única opción de navegador obligatoria es el ID público del widget. Gestiona el estado de activación, los orígenes permitidos, los adjuntos, la protección contra bots y el [formulario de contacto de deflection](/es/assistant/configure#set-deflection-emails) desde tu panel. Configura las preguntas iniciales específicas del embed y un correo electrónico de soporte en la configuración del navegador.
## Requisitos previos
diff --git a/es/automations/manage.mdx b/es/automations/manage.mdx
index 57ce3dad95..ca683a769e 100644
--- a/es/automations/manage.mdx
+++ b/es/automations/manage.mdx
@@ -14,20 +14,12 @@ import GitlabAutomationSetup from '/snippets/es/gitlab-automation-setup.mdx';
- Para GitHub: la [aplicación de GitHub de Mintlify](/es/deploy/github) instalada en cada repositorio que planees usar en la automatización
- Para GitLab: una cuenta de GitLab conectada (consulta [Configuración de GitLab](#gitlab-setup) más abajo)
-
- También puedes crear, listar y eliminar automatizaciones desde la terminal con [`mint automations`](/es/cli/commands#mint-automations). La CLI es útil para scripts y CI. El dashboard es la forma más sencilla de configurar y supervisar las ejecuciones de automatizaciones.
-
-
-
-
Si la automatización puede ejecutarse con la configuración predeterminada, se activa de inmediato. De lo contrario, se abre la página de configuración de la automatización para que completes los ajustes obligatorios.
3. Si se abre la página de configuración, completa los campos obligatorios y haz clic en **Save**.
@@ -48,8 +40,8 @@ Cada automatización tiene un activador predeterminado que controla cuándo se e
- **Actualización de contenido**: se ejecuta cada vez que envías contenido al repositorio de tu proyecto, incluidas las fusiones de pull requests y los pushes directos.
- **Cambio de código**: se ejecuta cuando se fusiona una pull request en un repositorio de código fuente conectado. Debes especificar al menos un repositorio de origen. Haz clic en **Add repo** para activar la automatización con pull requests de más de un repositorio. Para cada repositorio, puedes configurar opcionalmente **Exclude author** para ignorar pull requests de un autor específico, y **Listening to changes in** para activar el disparador solo con pull requests que tengan cambios bajo una ruta específica.
-- **Programación personalizada**: se ejecuta de forma recurrente según la programación que definas. Elige un preajuste (**Daily**, **Every Monday**, **Every Friday** o **Twice weekly**) y una hora de inicio, o selecciona **Custom cron** e introduce una expresión cron estándar de 5 campos (`minute hour day month weekday`). Los valores de cron se almacenan en UTC; el dashboard convierte las horas de los preajustes hacia y desde tu zona horaria local. Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada.
-- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada, o cuando se publica un nuevo mensaje de nivel superior en un canal de Slack seleccionado. Está disponible para automatizaciones personalizadas. Selecciona la integración y el evento y completa los campos adicionales que aparezcan. Para activadores de Slack, elige uno o más canales a los que se haya añadido la [app de Mintlify para Slack](/es/agent/slack).
+- **Programación personalizada**: se ejecuta de forma recurrente según la programación que definas. Elige un preajuste (**Daily**, **Every Monday**, **Every Friday** o **Twice weekly**) y una hora de inicio, o selecciona **Custom cron** e introduce una expresión cron estándar de 5 campos (`minute hour day month weekday`). Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada.
+- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada, o cuando se publica un nuevo mensaje en un canal de Slack seleccionado. Está disponible para automatizaciones personalizadas. Selecciona la integración y el evento y completa los campos adicionales que aparezcan. Para activadores de Slack, elige uno o más canales a los que se haya añadido la [app de Mintlify para Slack](/es/agent/slack).
- **Webhook**: se ejecuta cuando una solicitud `POST` autenticada llega al endpoint de webhook de la automatización. Solo está disponible para automatizaciones personalizadas. Guarda primero la automatización. La tarjeta del activador muestra entonces la URL del webhook y una acción **Copy auth header** para el encabezado `Authorization: Bearer `. Proporciona una clave de API de organización sin caducar con acceso de escritura desde la página [API keys](https://app.mintlify.com/settings/organization/api-keys). Úsalo para lanzar una ejecución desde un pipeline de CI/CD, un script de publicación o una herramienta interna. Consulta [Activar webhook de automatización](/es/api/automations/webhook) para conocer el endpoint y los límites de tasa.
Nuestro objetivo es responder a todos los mensajes en un plazo de 24 horas, pero puede haber demoras en períodos de alta demanda.
@@ -33,4 +29,4 @@ Envíanos un mensaje desde tu [dashboard](https://dashboard.mintlify.com/). Haz
## Contacto por correo electrónico
-Si no puedes acceder a tu dashboard, escríbenos a support@mintlify.com. Incluye la URL de tu [dashboard](https://dashboard.mintlify.com/) con tu organización y despliegue en el correo para que podamos ayudarte más rápido. Por ejemplo, `dashboard.mintlify.com/your-org/your-deployment`.
\ No newline at end of file
+Si no puedes acceder a tu dashboard, escríbenos a support@mintlify.com. Incluye la URL de tu [dashboard](https://app.mintlify.com/) con tu organización y despliegue en el correo para que podamos ayudarte más rápido. Por ejemplo, `app.mintlify.com/your-org/your-deployment`.
\ No newline at end of file
diff --git a/es/dashboard/sso.mdx b/es/dashboard/sso.mdx
index 9e0b441a58..1b5440e9db 100644
--- a/es/dashboard/sso.mdx
+++ b/es/dashboard/sso.mdx
@@ -127,7 +127,7 @@ Para eliminar un dominio, haz clic en el botón de eliminar
## Activar una automatización
1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
2. Haz clic en el interruptor junto a una automatización para activarla.
-
-
-
-
Si la automatización puede ejecutarse con la configuración predeterminada, se activa de inmediato. De lo contrario, se abre la página de configuración de la automatización para que completes los ajustes obligatorios.
3. Si se abre la página de configuración, completa los campos obligatorios y haz clic en **Save**.
@@ -48,8 +40,8 @@ Cada automatización tiene un activador predeterminado que controla cuándo se e
- **Actualización de contenido**: se ejecuta cada vez que envías contenido al repositorio de tu proyecto, incluidas las fusiones de pull requests y los pushes directos.
- **Cambio de código**: se ejecuta cuando se fusiona una pull request en un repositorio de código fuente conectado. Debes especificar al menos un repositorio de origen. Haz clic en **Add repo** para activar la automatización con pull requests de más de un repositorio. Para cada repositorio, puedes configurar opcionalmente **Exclude author** para ignorar pull requests de un autor específico, y **Listening to changes in** para activar el disparador solo con pull requests que tengan cambios bajo una ruta específica.
-- **Programación personalizada**: se ejecuta de forma recurrente según la programación que definas. Elige un preajuste (**Daily**, **Every Monday**, **Every Friday** o **Twice weekly**) y una hora de inicio, o selecciona **Custom cron** e introduce una expresión cron estándar de 5 campos (`minute hour day month weekday`). Los valores de cron se almacenan en UTC; el dashboard convierte las horas de los preajustes hacia y desde tu zona horaria local. Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada.
-- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada, o cuando se publica un nuevo mensaje de nivel superior en un canal de Slack seleccionado. Está disponible para automatizaciones personalizadas. Selecciona la integración y el evento y completa los campos adicionales que aparezcan. Para activadores de Slack, elige uno o más canales a los que se haya añadido la [app de Mintlify para Slack](/es/agent/slack).
+- **Programación personalizada**: se ejecuta de forma recurrente según la programación que definas. Elige un preajuste (**Daily**, **Every Monday**, **Every Friday** o **Twice weekly**) y una hora de inicio, o selecciona **Custom cron** e introduce una expresión cron estándar de 5 campos (`minute hour day month weekday`). Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada.
+- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada, o cuando se publica un nuevo mensaje en un canal de Slack seleccionado. Está disponible para automatizaciones personalizadas. Selecciona la integración y el evento y completa los campos adicionales que aparezcan. Para activadores de Slack, elige uno o más canales a los que se haya añadido la [app de Mintlify para Slack](/es/agent/slack).
- **Webhook**: se ejecuta cuando una solicitud `POST` autenticada llega al endpoint de webhook de la automatización. Solo está disponible para automatizaciones personalizadas. Guarda primero la automatización. La tarjeta del activador muestra entonces la URL del webhook y una acción **Copy auth header** para el encabezado `Authorization: Bearer
@@ -61,7 +53,7 @@ En las automatizaciones con un activador de **Cambio de código** en GitHub, cad
- **Listening to changes in**: añade rutas que la pull request debe modificar para que se ejecute la automatización. Las rutas pueden ser archivos, carpetas o patrones glob (por ejemplo, `docs/**/*.mdx`). Las sugerencias provienen de los archivos rastreados del repositorio; también puedes escribir una ruta personalizada.
- **Excluding PRs from**: añade nombres de usuario de GitHub o cuentas de bot cuyas pull requests no deben activar la automatización. Es útil para omitir fusiones realizadas por cuentas de automatización. Las sugerencias provienen de los contribuidores recientes; también puedes escribir un nombre de usuario personalizado.
-Cada repositorio admite hasta 20 rutas y 20 autores excluidos. Al cambiar el repositorio en una tarjeta se borran sus filtros. Los repositorios de origen en GitLab no admiten filtros por repositorio y siguen usando un único selector de repositorio.
+Cada repositorio admite hasta 20 rutas y 20 autores excluidos. Al cambiar el repositorio de una automatización se borran sus filtros.
+ `mint format` reescribe los archivos in situ. Confirma o guarda tus cambios antes de ejecutarlo para que puedas revisar el diff.
+
+
Formatea todos los archivos `.mdx` del directorio actual siguiendo el estilo canónico de Mintlify. El comando analiza cada archivo con el mismo analizador MDX que utiliza el editor web y luego lo reescribe in situ si la salida canónica difiere.
```bash
@@ -670,9 +667,9 @@ mint format
Ejecuta el comando desde la raíz de tu proyecto de documentación. Recorre cada subdirectorio, omitiendo las rutas que coincidan con `.gitignore` y cualquier regla de exclusión de Mintlify. Los archivos que ya coincidan con la salida canónica se dejan intactos.
-
- `mint format` reescribe los archivos in situ. Confirma o guarda tus cambios antes de ejecutarlo para que puedas revisar el diff.
-
+
+ Ejecutar `mint format` puede generar muchos cambios según el tamaño de tu proyecto. Para evitar conflictos de fusión y no introducir cambios en otro trabajo en curso, primero resuelve todas las ramas pendientes importantes. Luego crea una nueva rama para los cambios de formato y ejecuta `mint format` en esa rama.
+
Cuando termina, el comando muestra cuántos archivos MDX se reformatearon y cuántos no se pudieron analizar. Si algún archivo falla, el comando termina con el código `1` e imprime la ruta del archivo y el error, de modo que puedas ejecutarlo en CI para exigir un formato coherente. Consulta [Instalar en CI](/es/cli/install#install-in-ci) para ver un pipeline de ejemplo.
diff --git a/es/cli/preview.mdx b/es/cli/preview.mdx
index 33f5481e56..88b9aa1937 100644
--- a/es/cli/preview.mdx
+++ b/es/cli/preview.mdx
@@ -49,7 +49,7 @@ Debes autenticar la CLI con tu cuenta de Mintlify para habilitar la búsqueda y
mint login
```
-Después de autenticarte con el comando `mint login`, la CLI almacena tus credenciales en `~/.config/mintlify/config.json` para que permanezcas conectado entre sesiones. La CLI también te solicita que selecciones un proyecto predeterminado, que comandos como `mint automations` utilizan.
+Después de autenticarte con el comando `mint login`, la CLI almacena tus credenciales en `~/.config/mintlify/config.json` para que permanezcas conectado entre sesiones. La CLI también te solicita que selecciones un proyecto predeterminado.
Una vez que hayas iniciado sesión, ejecuta `mint dev` para iniciar la previsualización local con la búsqueda y el asistente habilitados. El asistente usa el mismo contenido indexado que tu sitio de documentación desplegado.
diff --git a/es/contact-support.mdx b/es/contact-support.mdx
index 158e8b690d..9fcbc9a7c6 100644
--- a/es/contact-support.mdx
+++ b/es/contact-support.mdx
@@ -7,7 +7,7 @@ description: "Contacta al soporte de Mintlify para obtener ayuda con tu sitio de
## Consulta nuestra documentación
-Usa el atajo de teclado Cmd + I (macOS) o Ctrl + I (Windows/Linux) para iniciar un chat con nuestro Asistente de IA entrenado con nuestra documentación.
+Usa el atajo de teclado Cmd + I (macOS) o Ctrl + I (Windows/Linux). Esto inicia un chat con nuestro asistente de IA entrenado con nuestra documentación.
### Modo de actualización
@@ -93,7 +85,7 @@ Para automatizaciones personalizadas y otras automatizaciones predefinidas compa
Para habilitar integraciones en una automatización, abre su página de configuración, despliega **Advanced options** y selecciona las integraciones que quieres usar en **Integrations**.
-Si seleccionas **Integración** como activador, la integración que activa la automatización se añade automáticamente como herramienta. Consulta [Integraciones](/es/automations/integrations) para conocer los alcances, eventos y permisos.
+Si seleccionas **Integración** como activador de una automatización personalizada, la integración que la activa siempre es una herramienta de esa automatización. Consulta [Integraciones](/es/automations/integrations) para conocer los alcances de conexión, los eventos compatibles y los permisos.
[value]
| Clave | Descripción | Usado por |
| --- | --- | --- |
-| `subdomain` | Subdominio predeterminado de la documentación. | `mint dev`, `mint automations`, `mint analytics`, `mint add-domain`, `mint score` |
+| `subdomain` | Subdominio predeterminado de la documentación. | `mint dev`, `mint analytics`, `mint add-domain`, `mint score` |
| `dateFrom` | Fecha de inicio predeterminada para las consultas de analíticas. | `mint analytics` |
| `dateTo` | Fecha de fin predeterminada para las consultas de analíticas. | `mint analytics` |
@@ -442,7 +442,7 @@ Verifica enlaces rotos internos en tu documentación.
mint broken-links [flags]
```
-El comando excluye los archivos que coinciden con los patrones de [.mintignore](/es/organize/mintignore). Los enlaces que apuntan a archivos ignorados se reportan como rotos.
+El comando analiza los archivos `.mdx` y `.md` en busca de enlaces y excluye los archivos que coinciden con los patrones de [.mintignore](/es/organize/mintignore). No se verifican los enlaces dentro de archivos de especificación OpenAPI (`.yaml`, `.yml`, `.json`). Los enlaces que apuntan a archivos ignorados se reportan como rotos.
| Flag | Descripción |
| --- | --- |
@@ -537,13 +537,6 @@ mint test
Solo las páginas incluidas en la navegación de tu `docs.json` aparecen para su selección.
-
-
-
-
+
### Notificaciones de Slack
@@ -152,14 +144,12 @@ Cuando vuelves a activar una automatización programada o cambias su programaci
## Eliminar una automatización
-Puedes eliminar automatizaciones personalizadas desde el dashboard. Las automatizaciones predefinidas no se pueden eliminar desde el dashboard. Desactívalas en su lugar o usa la CLI para eliminarlas.
+La eliminación es permanente y no se puede deshacer.
1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
2. Haz clic en el botón de configuración
## Ejecutar una automatización manualmente
@@ -218,13 +208,15 @@ Cada resultado muestra uno de los siguientes estados:
Puedes actuar sobre los resultados directamente desde la lista. Para las ejecuciones pendientes de revisión, haz clic en **Accept** para fusionar los cambios o en **Preview** para abrir el [preview deployment](/es/deploy/preview-deployments) de la rama de la ejecución. Para los resultados fallidos, haz clic en **Re-trigger** para iniciar la ejecución de nuevo.
-El botón **Preview** solo aparece cuando la ejecución tiene un preview deployment vinculado. Los preview deployments caducan tras un período de inactividad; una vez caducados, el botón queda deshabilitado.
+El botón **Preview** solo aparece cuando la ejecución tiene un preview deployment vinculado. Los preview deployments caducan tras un período de inactividad. Una vez caducados, el botón muestra **Preview expired** y deja de funcionar.
### Resolver conflictos de fusión
-Si la pull request de una ejecución tiene conflictos con tu rama de despliegue, al hacer clic en **Accept** se abre un cuadro de diálogo que ofrece resolver los conflictos por ti. Haz clic en **Resolve and merge** para que el agente fusione los últimos cambios de la rama de despliegue en la rama de la pull request, resuelva los conflictos y fusione la pull request automáticamente. La ejecución se muestra como **Running** mientras el agente trabaja y cambia a **Accepted** cuando la pull request se fusiona. Si el agente no puede resolver los conflictos, resuélvelos manualmente en tu repositorio y haz clic en **Accept** de nuevo.
+Si la pull request de una ejecución tiene conflictos con tu rama de despliegue, el agente te pide que resuelvas los conflictos cuando haces clic en **Accept** en una ejecución de automatización.
+
+Haz clic en **Resolve and merge** para que el agente fusione los últimos cambios de la rama de despliegue en la rama de la pull request, resuelva los conflictos y fusione la pull request automáticamente. Si el agente no puede resolver los conflictos, resuélvelos manualmente en tu repositorio y luego haz clic en **Accept**.
Para ver el prompt de una ejecución, los archivos que leyó o modificó y cualquier pull request, haz clic en el menú de acciones
### Opciones
@@ -238,7 +236,9 @@ Si el comando falla con `Domain is already in use by another deployment in your
Cuando pasas `--basePath`, la CLI guarda el base path después de registrar el dominio. El nuevo path se aplica en tu próximo despliegue, y tu sitio sigue sirviéndose desde el path actual hasta entonces. El `CNAME` envía todo el tráfico del dominio a Mintlify, así que solo añádelo si el dominio no aloja nada más. En caso contrario, mantén tu DNS actual y configura un reverse proxy a Mintlify para el base path. Consulta [Hospedar la documentación en un subpath](/es/deploy/docs-subpath) para ver guías por proveedor.
-### Ejemplos
+
+ ### Ejemplos
+
Añade un dominio personalizado en la raíz:
@@ -426,7 +426,7 @@ mint config
-
-
### Volver a una ejecución anterior
@@ -662,6 +655,10 @@ La puntuación general utiliza puntuación ponderada, por lo que las verificacio
## `mint format`
## Mira tutoriales en video
@@ -19,11 +19,7 @@ Visita nuestro canal de [YouTube](https://www.youtube.com/@GetMintlify/videos) p
## Soporte mediante mensajes
-Envíanos un mensaje desde tu [dashboard](https://dashboard.mintlify.com/). Haz clic en el botón de soporte
-
+Envíanos un mensaje desde tu [dashboard](https://app.mintlify.com/). Haz clic en
-
+Instala la Aplicación de GitHub de Mintlify en la página [Git settings](https://app.mintlify.com/settings/project/git-settings) de tu dashboard. Cuando GitHub te pregunte a qué repositorios quieres dar acceso, elige **Only select repositories** y selecciona tu repositorio de documentación.
## Permisos
@@ -130,7 +122,7 @@ Si los pushes a tu repositorio no desencadenan implementaciones, revisa los sigu
Comprueba que la aplicación esté instalada en el repositorio correcto.
- 1. Ve a la [configuración de la Aplicación de GitHub](https://dashboard.mintlify.com/settings/organization/github-app) en tu dashboard.
+ 1. Ve a la página [Git settings](https://app.mintlify.com/settings/project/git-settings) de tu dashboard.
1. Verifica que tu repositorio esté en la lista de instalaciones activas de la aplicación.
@@ -154,37 +146,6 @@ Si tienes problemas con la Aplicación de GitHub, restablecer la conexión puede
1. En tu Dashboard de Mintlify, ve a [Git Settings](https://app.mintlify.com/settings/project/git-settings) e instala la Aplicación de GitHub.
- 2. Autoriza tu cuenta en la sección [My Profile](https://dashboard.mintlify.com/settings/account) de tu dashboard.
+ 2. Autoriza tu cuenta en la sección [My Profile](https://app.mintlify.com/settings/account) de tu dashboard.
-
-
-
-Las funciones de comentarios de sugerencias de edición y de creación de issues solo están disponibles para repositorios públicos de GitHub. Si estas opciones no están disponibles en tu dashboard, verifica la visibilidad de tu repositorio.
-
-Si tu repositorio es público y no puedes habilitar las opciones de sugerencias de edición o de creación de issues en tu dashboard, vuelve a validar tu configuración de Git.
-
-
-
- Ve a [Git Settings](https://app.mintlify.com/settings/project/git-settings) en tu dashboard.
-
-
- Haz clic en la marca de verificación verde en la esquina del recuadro de configuración de Git para volver a validar la configuración de tu repositorio. Esto forzará la actualización de la configuración para reflejar si tu repositorio es público o privado.
-
-
- 
-
- 
-
-
-
\ No newline at end of file
diff --git a/es/deploy/gitlab.mdx b/es/deploy/gitlab.mdx
index c6e249feaf..63414ac72f 100644
--- a/es/deploy/gitlab.mdx
+++ b/es/deploy/gitlab.mdx
@@ -34,9 +34,6 @@ Cuando abras [Git Settings](https://app.mintlify.com/settings/project/git-settin
En tu proyecto de GitLab, ve a **Settings** > **General** y ubica tu **Project ID**.
-
-
-
Ve a **Settings** > **Access Tokens** y selecciona **Add new token**.
@@ -51,10 +48,6 @@ Cuando abras [Git Settings](https://app.mintlify.com/settings/project/git-settin
Si los Project Access Tokens no están disponibles, puedes usar un Personal Access Token en su lugar. Ten en cuenta que los Personal Access Tokens caducan y deben actualizarse.
-
-
-
-
De vuelta en el asistente de configuración, completa los siguientes campos:
@@ -78,8 +71,9 @@ Cuando abras [Git Settings](https://app.mintlify.com/settings/project/git-settin
Para modificar la configuración de tu conexión con GitLab después de la configuración inicial, ve a [Git Settings](https://app.mintlify.com/settings/project/git-settings) y actualiza tu ID de proyecto, token de acceso, rama o URL de instancia directamente.
-
-
-
-
-
-
-
+
- Haz clic en la insignia verde **Active** en la esquina del recuadro de configuración de GitLab para volver a validar tu origen de Git. Un toast de éxito confirma cuando se completa la revalidación, y aparece un toast de error si tu configuración necesita revisión.
+ Haz clic en la insignia verde **Active** en la esquina del recuadro de configuración de GitLab para volver a validar tu origen de Git.
-## Crear el webhook
+
1. En GitLab, ve a **Settings** > **Webhooks**.
2. Haz clic en **Add new webhook**.
-
-
-
Asigna al webhook el nombre **Mintlify**.
@@ -112,10 +104,6 @@ Los webhooks notifican a Mintlify cuando envías cambios, para que las implement
En tu Dashboard de Mintlify, haz clic en **Show webhook token**. Copia el token del webhook.
-
-
-
-
En GitLab, pega el token del webhook desde tu Dashboard de Mintlify en el campo **Secret token**.
@@ -134,17 +122,9 @@ Los webhooks notifican a Mintlify cuando envías cambios, para que las implement
- **Events**: **Push events** (All branches) y **Merge requests events**
Añade el webhook.
-
-
-
-
Después de crear el webhook, haz clic en el menú desplegable **Test**. Haz clic en **Push events** para enviar un payload de prueba. Si la prueba devuelve `Hook executed successfully: HTTP 200`, configuraste el webhook correctamente.
-
-
-
-
diff --git a/es/deploy/multi-repo.mdx b/es/deploy/multi-repo.mdx
index 4cae9ddd6f..dbdb21226d 100644
--- a/es/deploy/multi-repo.mdx
+++ b/es/deploy/multi-repo.mdx
@@ -60,11 +60,6 @@ Un repositorio actúa como la **fuente base** de la implementación. Su `docs.js
Ve a la [configuración de Git](https://app.mintlify.com/settings/project/git-settings) en tu panel.
-
-
-
-
-
diff --git a/es/deploy/preview-deployments.mdx b/es/deploy/preview-deployments.mdx
index 536f29eee9..87687a52c5 100644
--- a/es/deploy/preview-deployments.mdx
+++ b/es/deploy/preview-deployments.mdx
@@ -67,14 +67,8 @@ También puedes crear implementaciones de vista previa de forma programática us
Vuelve a implementar una vista previa para actualizar el contenido o volver a intentarlo después de una implementación fallida.
1. Ve a la página [Activity](https://app.mintlify.com/activity) de tu dashboard.
-2. Haz clic en la pestaña **Previews**.
-3. Haz clic en la vista previa que quieres volver a implementar.
-4. Haz clic en **Redeploy**.
-
-
-
-
-
+2. Haz clic en la vista previa que quieres volver a implementar.
+3. Haz clic en **Redeploy**.
## Volver a validar la configuración de Git
+
Si tu despliegue muestra un comportamiento inesperado, como opciones de rama faltantes o una configuración desactualizada, puedes forzar a Mintlify a actualizar tu origen de Git.
@@ -88,11 +82,12 @@ Si tu despliegue muestra un comportamiento inesperado, como opciones de rama fal
Ve a [Git Settings](https://app.mintlify.com/settings/project/git-settings) en tu Dashboard.
+ ## Crear el webhook
Los webhooks notifican a Mintlify cuando envías cambios, para que las implementaciones se activen automáticamente.
@@ -101,9 +96,6 @@ Los webhooks notifican a Mintlify cuando envías cambios, para que las implement
-
-
-
-
-
-
-
-
-
-
+2. Haz clic en la vista previa que quieres volver a implementar.
+3. Haz clic en **Redeploy**.
## Widget de vista previa
@@ -90,7 +84,7 @@ El widget de vista previa aparece en las implementaciones de vista previa y est
1. Haz clic en el widget para mostrar todos los archivos agregados, modificados o eliminados en la vista previa.
1. Haz clic en un archivo para ver los cambios en la página correspondiente.
1. Usa la barra de búsqueda para filtrar la lista de archivos con cambios.
-1. Pasa el cursor sobre un archivo y haz clic en el icono **Abrir en el editor** para editar el archivo directamente en el editor web.
+1. Pasa el cursor sobre un archivo y haz clic en el icono **Open in editor** para editar el archivo directamente en el editor web.
El widget solo aparece en las implementaciones de vista previa, no en tu sitio en producción ni en las vistas previas locales.
@@ -114,10 +108,6 @@ Restringe el acceso a las vistas previas a los miembros autenticados de tu organ
1. Ve a la sección **Previews** en la página de [General](https://app.mintlify.com/settings/project/general) de tu dashboard.
2. Haz clic en el interruptor **Preview authentication** para habilitar o deshabilitar la autenticación de la vista previa.
-
-
-
-
```js Format
@@ -52,10 +52,6 @@ Después de desplegar, abre tu sitio en una ventana privada o de incógnito y co
Agrega `.mintlify.site/` como una regla gestionada.
-
- 
-
-
Esto garantiza que todos los recursos servidos por Mintlify (incluidas imágenes, hojas de estilo y otros recursos de documentación) se traten como esenciales y se carguen incluso cuando Osano bloquee contenido de terceros sin categorizar.
diff --git a/es/optimize/feedback.mdx b/es/optimize/feedback.mdx
index bf2a2524ae..eaf7830268 100644
--- a/es/optimize/feedback.mdx
+++ b/es/optimize/feedback.mdx
@@ -49,20 +49,6 @@ Para recopilar y ver los comentarios de los usuarios, debes habilitar los coment
* **Contextual feedback**: Comentarios de formato libre sobre el contenido de una página. Opcionalmente, habilita la recopilación de correos electrónicos para permitir que los usuarios proporcionen su dirección de correo al enviar comentarios.
* **Code snippet feedback**: Comentarios específicamente sobre fragmentos de código.
-
- 
-
- 
-
-
- 
-
-
Los valores más altos muestran más coincidencias por consulta, lo cual es útil para sitios con una cobertura temática amplia donde los usuarios esperan revisar muchos candidatos. Los valores más bajos mantienen compacto el panel de resultados y dirigen a los usuarios hacia la coincidencia mejor clasificada.
-
-
### Proteger con contraseña una vista previa individual
@@ -130,10 +120,6 @@ Protege con contraseña una vista previa específica para compartirla con reviso
3. Selecciona **Create custom preview**.
4. Ingresa el nombre del branch que quieres previsualizar.
5. Activa **Make private** e ingresa una contraseña. Las contraseñas deben tener al menos 8 caracteres.
-
-
-
-
6. Selecciona **Create preview**.
@@ -89,16 +70,8 @@ Los comportamientos de tu subruta deben permitir todos los métodos HTTP. CloudF
3. Crea un nuevo Origin y agrega tu URL de staging como el "Origin domain".
-
- 
-
-
Ahora deberías tener dos Origins: uno con `[SUBDOMAIN].mintlify.site` y otro con tu URL de staging.
-
- 
-
-
Si `.well-known/*` es demasiado genérico, puedes acotarlo a un mínimo de 2 comportamientos para Vercel:
- `/.well-known/vercel/*` - Obligatorio para la verificación de domain de Vercel
@@ -149,10 +113,6 @@ Crea un comportamiento con un **Path pattern** de la subruta que elijas, por eje
CloudFront solo permite solicitudes `GET` y `HEAD` de forma predeterminada. Si no permites todos los métodos HTTP, CloudFront rechaza las solicitudes `POST` que Mintlify usa para analíticas, y tu panel no mostrará ninguna vista de página aunque tu documentación se cargue normalmente.
-
- 
-
-
-
+
Una rama apunta a una confirmación específica en tu repositorio. Tu documentación en producción se compila desde una rama de implementación. Puedes tener cualquier número de otras ramas con cambios que aún no se han publicado en tu documentación en producción. Si quieres incorporar los cambios de una rama en tu documentación en producción, puedes fusionar la rama en tu rama de implementación mediante una solicitud de extracción.
Usa ramas para trabajar en cambios sin afectar tu documentación en producción, experimentar de forma segura con nuevas funcionalidades y obtener revisiones antes de publicar.
-
+
Descarga una copia completa de un repositorio en tu computadora, incluidos todos los archivos y el historial completo. Cuando clonas un repositorio, obtienes todo lo necesario para trabajar de forma local.
```bash
@@ -74,27 +74,27 @@ Si eres completamente nuevo en Git y en el control de versiones, aquí tienes un
```
-
+
Una instantánea guardada de tus cambios en un momento específico. Cada confirmación incluye un mensaje que describe qué cambió y crea un registro permanente en el historial de tu proyecto.
-
+
Ocurre cuando dos personas cambian de forma diferente la misma parte de un archivo. Git te pide que elijas manualmente qué cambio conservar o que combines ambos cambios.
-
+
La rama principal de tu proyecto. Los cambios en esta rama se publican automáticamente en tu sitio de documentación. A menudo se llama `main`, pero puedes configurar cualquier rama como tu rama de implementación.
-
+
Un diff (o diferencia) muestra los cambios entre dos versiones de un archivo. Al revisar solicitudes de extracción, los diffs resaltan qué es diferente respecto a la versión original del archivo.
-
+
Combina los cambios de una rama en otra. Normalmente se hace mediante una solicitud de extracción, después de la revisión, para incorporar el trabajo de nuevas funcionalidades en tu rama de implementación.
-
+
Obtén los cambios más recientes desde el repositorio remoto en tu copia local. Te mantiene al día con el trabajo de otras personas.
```bash
@@ -102,11 +102,11 @@ Si eres completamente nuevo en Git y en el control de versiones, aquí tienes un
```
-
+
Una forma de proponer la fusión de tus cambios en una rama con tu documentación en producción. Permite la revisión y la discusión antes de que los cambios se publiquen. Comúnmente llamada PR y también llamada merge request en GitLab.
-
+
Envía tus confirmaciones locales al repositorio remoto. Esto hace que tus cambios estén disponibles para otras personas y puede desencadenar implementaciones automáticas.
```bash
@@ -114,15 +114,15 @@ Si eres completamente nuevo en Git y en el control de versiones, aquí tienes un
```
-
+
Una versión de tu repositorio alojada en un servidor. Tu repositorio local se conecta a un repositorio remoto para enviar (`push`) y obtener (`pull`) cambios.
-
+
El código fuente de tu documentación, con todos los archivos y su historial, que conforman las páginas de tu sitio de documentación. El editor web se conecta a tu repositorio de documentación para acceder y modificar contenido.
-
+
Prepara cambios específicos para incluirlos en tu próxima confirmación. La preparación (staging) te permite organizar los cambios en confirmaciones lógicas.
```bash
diff --git a/es/integrations/analytics/google-analytics.mdx b/es/integrations/analytics/google-analytics.mdx
index 6db39eeec8..0cbd3d36ec 100644
--- a/es/integrations/analytics/google-analytics.mdx
+++ b/es/integrations/analytics/google-analytics.mdx
@@ -20,8 +20,6 @@ Necesitas crear un flujo web para obtener el ID de medición que debes ingresar
Haz clic en el ícono de engranaje en la parte inferior izquierda de la pantalla de Google Analytics. Luego, haz clic en Data Streams.
-
-
Crea un flujo web y establece la URL de tu sitio de documentación de Mintlify como la URL del flujo.
Tu ID de medición tiene el formato `G-XXXXXXX` y aparece en Stream Details inmediatamente después de crear el flujo web.
diff --git a/es/integrations/privacy/osano.mdx b/es/integrations/privacy/osano.mdx
index 61811b3064..e9e01f8dc3 100644
--- a/es/integrations/privacy/osano.mdx
+++ b/es/integrations/privacy/osano.mdx
@@ -11,7 +11,7 @@ Añade el consentimiento de cookies de [Osano](https://www.osano.com/) a tu docu
## Configuración
-Crea un archivo `osano.js` en cualquier ubicación dentro de tu directorio de contenido con el siguiente contenido. Mintlify incluye automáticamente cualquier archivo `.js` de tu directorio de contenido en todas las páginas.
+Crea un archivo `osano.js` dentro de tu directorio de contenido con el siguiente contenido.
-
-
6. Selecciona **Create preview**.
@@ -161,7 +147,7 @@ Si tu implementación de vista previa falla, prueba estos pasos de solución de
- Falta `docs.json` en la raíz de contenido configurada. Si tu `docs.json` está en un subdirectorio, confirma que la opción **docs.json is in a subdirectory** apunte a la ruta correcta.
- Sintaxis no válida en `docs.json` (por ejemplo, un archivo vacío o una coma final perdida que rompe el análisis JSON).
- Errores de esquema en `docs.json`, como un `theme` no válido, una `navigation` mal formada o valores de `$ref` sin resolver.
- - Rutas de archivos ausentes o incorrectas referenciadas en tu `navigation`.
+ - Rutas de archivos ausentes o incorrectas referenciadas en tu navegación.
- frontmatter no válido en archivos MDX.
- Enlaces de imágenes rotos o archivos de imagen ausentes.
- **Validar localmente**: Ejecuta `mint dev` y `mint validate` en local para detectar errores de configuración y compilación antes de subir los cambios al repositorio.
diff --git a/es/deploy/route53-cloudfront.mdx b/es/deploy/route53-cloudfront.mdx
index 53d702082f..791e167a6a 100644
--- a/es/deploy/route53-cloudfront.mdx
+++ b/es/deploy/route53-cloudfront.mdx
@@ -45,23 +45,9 @@ Los comportamientos de tu subruta deben permitir todos los métodos HTTP. CloudF
1. Navega a [CloudFront](https://aws.amazon.com/cloudfront) en la consola de AWS.
2. Selecciona **Create distribution**.
-
-
- 
-
-
3. En Origin domain, ingresa `[SUBDOMAIN].mintlify.site`, donde `[SUBDOMAIN]` es el subdomain único de tu proyecto.
-
-
- 
-
-
4. En «Web Application Firewall (WAF)», habilita las protecciones de seguridad.
-
- 
-
-
Las reglas de WAF pueden bloquear las solicitudes `POST` que Mintlify usa para analíticas y otras funciones interactivas. Si las analíticas dejan de aparecer en tu panel después de habilitar WAF, revisa los registros de WAF en busca de solicitudes bloqueadas a rutas bajo `/docs/_mintlify/`.
@@ -74,11 +60,6 @@ Los comportamientos de tu subruta deben permitir todos los métodos HTTP. CloudF
1. Después de crear la distribución, ve a la pestaña "Origins".
-
-
- 
-
-
2. Busca tu URL de staging que refleje el dominio principal. Esto varía según el proveedor de alojamiento de tu página de inicio. Por ejemplo, la URL de staging de Mintlify es [mintlify-landing-page.vercel.app](https://mintlify-landing-page.vercel.app).
## Configurar comportamientos
@@ -109,25 +82,16 @@ Los comportamientos en CloudFront permiten controlar la lógica de subrutas. A g
- **Si un usuario llega a cualquier otra página**, redirigir a la página de inicio actual.
1. Ve a la pestaña "Behaviors" de tu distribución de CloudFront.
-
-
- 
-
-
2. Selecciona el botón **Create behavior** y crea los siguientes comportamientos.
### `/.well-known/*`
-Crea comportamientos para las rutas de verificación de domain de Vercel con un **Patrón de ruta** de `/.well-known/*` y establece **Origin and origin groups** en la URL de tu documentación.
+Crea comportamientos para las rutas de verificación de domain de Vercel con un **Path pattern** de `/.well-known/*` y establece **Origin and origin groups** en la URL de tu documentación.
Para "Cache policy", selecciona **CachingDisabled** para garantizar que estas solicitudes de verificación se procesen sin caché.
-
- 
-
-
### Tu subruta con comodín
@@ -193,19 +153,10 @@ Crea un comportamiento con un **Path pattern** de `/_mintlify/*` con **Origin an
Edita el comportamiento de `Default (*)`.
-
- 
-
-
1. Cambia **Origin and origin groups** del comportamiento predeterminado a la URL de staging (en nuestro caso, `mintlify-landing-page.vercel.app`).
+2. Haz clic en **Save changes**.
-
- 
-
-
-2. Selecciona **Guardar cambios**.
-
-
+
- Si no tienes una cuenta de Mintlify, regístrate en [dashboard.mintlify.com/signup](https://dashboard.mintlify.com/signup).
+ Si no tienes una cuenta de Mintlify, regístrate en [app.mintlify.com/signup](https://app.mintlify.com/signup).
@@ -67,13 +67,7 @@ Esta guía te guía paso a paso para configurar un proyecto headless de Mintlify
1. En la página de [Git settings](https://app.mintlify.com/settings/project/git-settings), selecciona el repositorio que creaste a partir de la plantilla inicial.
2. Activa el interruptor **Set up as monorepo**.
3. Introduce `/docs` como la ruta al directorio que contiene tu archivo `docs.json`.
- 4. Haz clic en **Guardar cambios**.
-
-
- 
-
- 
-
+ 4. Haz clic en **Save changes**.
@@ -84,9 +78,9 @@ Esta guía te guía paso a paso para configurar un proyecto headless de Mintlify
PUBLIC_MINTLIFY_ASSISTANT_KEY=your-assistant-api-key
```
- Tu subdominio es el nombre de dominio de tu proyecto. Es la parte de la URL de tu dashboard que aparece después del nombre de la organización. Por ejemplo, si la URL de tu dashboard es `https://dashboard.mintlify.com/org-name/domain-name`, tu subdominio es `domain-name`.
+ Tu subdominio es el nombre de dominio de tu proyecto. Es la parte de la URL de tu dashboard que aparece después del nombre de la organización. Por ejemplo, si la URL de tu dashboard es `https://app.mintlify.com/org-name/domain-name`, tu subdominio es `domain-name`.
- Genera una clave de API del assistant en la página [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard. Esta clave de API del assistant empieza por `mint_dsc_`.
+ Genera una clave de API del assistant en la página [API keys](https://app.mintlify.com/settings/organization/api-keys) de tu dashboard. Esta clave de API del assistant empieza por `mint_dsc_`.
diff --git a/es/guides/git-concepts.mdx b/es/guides/git-concepts.mdx
index 05370bcda9..fd030e773a 100644
--- a/es/guides/git-concepts.mdx
+++ b/es/guides/git-concepts.mdx
@@ -60,13 +60,13 @@ Si eres completamente nuevo en Git y en el control de versiones, aquí tienes un
### Verifica que hayas configurado los comportamientos correctamente
@@ -226,10 +177,6 @@ Confirma que cada comportamiento apunte al origen correcto: la URL `.mintlify.si
Para probar tu distribución, ve a la pestaña "General" y visita la URL de **Distribution domain name**.
-
- 
-
-
Todas las páginas deberían enrutar a tu página de inicio principal. Cuando agregas la subruta que elegiste, por ejemplo `/docs`, la URL debería servir tu documentación de Mintlify.
@@ -265,17 +212,7 @@ Primero, agrega tu dominio a la distribución de CloudFront. Sin un nombre de do
1. Ve a [Route53](https://aws.amazon.com/route53) en la consola de AWS.
2. Ve a la "Hosted zone" de tu dominio principal.
3. Selecciona **Create record**.
-
-
- 
-
-
4. Activa `Alias` y luego, en **Route traffic to**, selecciona la opción `Alias to CloudFront distribution`.
-
-
- 
-
-
5. Selecciona **Create records**.
diff --git a/es/guides/custom-frontend.mdx b/es/guides/custom-frontend.mdx
index 7a296f11ed..46deb3613c 100644
--- a/es/guides/custom-frontend.mdx
+++ b/es/guides/custom-frontend.mdx
@@ -39,7 +39,7 @@ Esta guía te guía paso a paso para configurar un proyecto headless de Mintlify
## Requisitos previos
-* Una [cuenta de Mintlify](https://dashboard.mintlify.com)
+* Una [cuenta de Mintlify](https://app.mintlify.com)
* Una [cuenta de GitHub](https://github.com)
* [Node.js](https://nodejs.org) v20.17.0 o posterior (se recomiendan las versiones LTS)
* Familiaridad con [Astro](https://docs.astro.build)
@@ -56,7 +56,7 @@ Esta guía te guía paso a paso para configurar un proyecto headless de Mintlify
-
-
-
+ 4. Haz clic en **Save changes**.
-
-
-
-
-
-
## Gestionar comentarios
diff --git a/es/optimize/search.mdx b/es/optimize/search.mdx
index 60872edc54..3a9cb3a4dc 100644
--- a/es/optimize/search.mdx
+++ b/es/optimize/search.mdx
@@ -116,19 +116,6 @@ Controla cuántos resultados devuelve la barra de búsqueda por consulta desde t
Ve a la página de configuración de [General](https://app.mintlify.com/settings/project/general) en tu dashboard. En la sección "Search", establece **Results per query** al valor que quieras.
-
-
-
-
-
Los valores más altos muestran más coincidencias por consulta, lo cual es útil para sitios con una cobertura temática amplia donde los usuarios esperan revisar muchos candidatos. Los valores más bajos mantienen compacto el panel de resultados y dirigen a los usuarios hacia la coincidencia mejor clasificada.
diff --git a/fr/ai/contextual-menu.mdx b/fr/ai/contextual-menu.mdx
index 8c67324f39..318721d66f 100644
--- a/fr/ai/contextual-menu.mdx
+++ b/fr/ai/contextual-menu.mdx
@@ -1,6 +1,6 @@
---
title: "Menu contextuel"
-description: "Ajoutez à votre documentation un menu contextuel avec des intégrations d'IA en un clic pour ChatGPT, Claude, Perplexity, Google AI Studio et les outils MCP."
+description: "Ajoutez à votre documentation un menu contextuel avec des intégrations d'IA en un clic pour ChatGPT, Claude, Perplexity, Google AI Studio, Devin, Devin Desktop et les outils MCP."
keywords: ["Outils d'IA", "ChatGPT", "Claude", "Perplexity", "MCP", "Grok", "cursor", "vscode", "vs code", "Google AI Studio", "aistudio", "Devin", "Windsurf", "Devin Desktop", "pdf", "copier la page", "bouton copier", "copier le markdown", "copier en markdown", "afficher en markdown", "menu contextuel", "menu de page", "menu IA", "actions IA", "ouvrir dans", "télécharger pdf", "exporter pdf", "demander à l'IA", "openapi", "télécharger la spec"]
---
@@ -37,18 +37,10 @@ Le menu contextuel comprend plusieurs options prédéfinies que vous pouvez acti
| **Se connecter à Cursor** | `cursor` | Installe votre serveur MCP hébergé dans Cursor |
| **Se connecter à VS Code** | `vscode` | Installe votre serveur MCP hébergé dans VS Code |
| **Se connecter à Devin** | `devin-mcp` | Installe votre serveur MCP hébergé dans Devin |
-| **Télécharger la spécification d'API** | `downloadApiSpec` | Télécharge la spécification OpenAPI de votre déploiement. Si plusieurs spécifications sont configurées, les télécharge dans une archive zip. N'apparaît que sur les pages de référence d'API. |
+| **Télécharger la spécification d'API** | `download-spec` | Télécharge la spécification OpenAPI de votre déploiement. S'il y a plusieurs spécifications, les télécharge dans une archive zip. N'apparaît que sur les pages de référence d'API. |
| **Options personnalisées** | Objet | Ajoutez des options personnalisées au menu contextuel |
-
-
-
-
-
- L'option `downloadApiSpec` n'apparaît que sur les pages de référence d'API (pages dont le frontmatter déclare `api`, `openapi` ou `asyncapi`). Sur les déploiements avec authentification ou authentification utilisateur activée, seuls les lecteurs authentifiés peuvent télécharger la spécification.
-
-
-
-
-
-
+
@@ -56,16 +48,15 @@ Ajoutez le champ `contextual` à votre fichier `docs.json` et indiquez les optio
```json
{
- "contextual": {
- "options": [
- "copy",
- "view",
- "assistant",
- "download-pdf",
- "chatgpt",
- "claude",
- "perplexity",
- "grok",
+ "contextual": {
+ "options": [
+ "copy",
+ "view",
+ "assistant",
+ "chatgpt",
+ "claude",
+ "perplexity",
+ "grok",
"aistudio",
"devin",
"devin-desktop",
@@ -73,9 +64,10 @@ Ajoutez le champ `contextual` à votre fichier `docs.json` et indiquez les optio
"cursor",
"vscode",
"devin-mcp",
- "downloadApiSpec"
+ "download-spec",
+ "download-pdf"
]
- }
+ }
}
```
@@ -99,8 +91,8 @@ Par défaut, le menu contextuel apparaît dans l’en-tête de la page. Vous pou
| `header` | Affiche les options dans le menu contextuel en haut de la page (par défaut) |
| `toc` | Affiche les options dans la barre latérale de la table des matières |
-
- ## Ajout d’options personnalisées
+
+ ## Ajouter des options personnalisées
Créez des options personnalisées dans le menu contextuel en ajoutant un objet au tableau `options`. Chaque option personnalisée requiert les propriétés suivantes :
@@ -184,7 +176,7 @@ contextual:
---
```
-Les mêmes champs et règles de validation s’appliquent que dans `docs.json`, y compris les [options personnalisées](#adding-custom-options) et le paramètre `display`. Si un remplacement au niveau d’une page est invalide, Mintlify revient à la configuration `contextual` globale.
+Les mêmes champs et règles de validation s’appliquent que dans `docs.json`, y compris les [options personnalisées](#add-custom-options) et le paramètre `display`. Si un remplacement au niveau d’une page est invalide, Mintlify revient à la configuration `contextual` globale.
### Exemples d’options personnalisées
diff --git a/fr/analytics/export.mdx b/fr/analytics/export.mdx
index 4ac1dd3b1a..c503010c1a 100644
--- a/fr/analytics/export.mdx
+++ b/fr/analytics/export.mdx
@@ -15,20 +15,6 @@ Exportez les catégories d'analytics au format CSV pour une analyse plus approfo
2. Sélectionnez une catégorie à exporter : trafic, référents, conversations avec l'assistant, recherches ou retours.
3. Attendez que Mintlify vous envoie un lien de téléchargement par e-mail.
-
-
-
-
-
-
-
-
-
+Utilisez le sélecteur de plage dans une vue analytics pour ajuster la période des données affichées. Choisissez une plage prédéfinie, comme **Last 7 days** ou **All time**, ou sélectionnez une plage personnalisée dans le calendrier. Les exports utilisent également la plage de temps sélectionnée.
diff --git a/fr/api-playground/troubleshooting.mdx b/fr/api-playground/troubleshooting.mdx
index 4872acf384..3bb64036e9 100644
--- a/fr/api-playground/troubleshooting.mdx
+++ b/fr/api-playground/troubleshooting.mdx
@@ -26,11 +26,7 @@ Si vos pages API ne s’affichent pas correctement, consultez ces problèmes de
est validé ici, il y a de fortes chances que le problème se situe ailleurs.
Par ailleurs, Mintlify ne prend pas en charge OpenAPI 2.0. Si votre document utilise cette version de la spécification,
- vous pourriez rencontrer ce problème. Vous pouvez convertir votre document sur [editor.swagger.io](https://editor.swagger.io/) (dans Edit > Convert to OpenAPI 3) :
-
-
- 
-
+ vous pourriez rencontrer ce problème. Vous pouvez convertir votre document sur [editor.swagger.io](https://editor.swagger.io/) (dans Edit > Convert to OpenAPI 3).
diff --git a/fr/api/automations/trigger.mdx b/fr/api/automations/trigger.mdx
index 889793350f..549b54b754 100644
--- a/fr/api/automations/trigger.mdx
+++ b/fr/api/automations/trigger.mdx
@@ -16,12 +16,6 @@ Cet endpoint ne prend en charge que les automatisations configurées avec un dé
- **Événements de version** : Exécutez l'automatisation **Draft changelog** lorsque vous créez un tag de version, afin que le changelog soit rédigé au moment même où la version est publiée.
- **Outillage personnalisé** : Déclenchez des automatisations depuis vos outils internes, des commandes Slack ou des tâches planifiées que vous exécutez déjà.
-
-
-
-
-
1. Dans Google Workspace, accédez à **Web and mobile apps**.
2. Cliquez sur **Add custom SAML app** dans le menu déroulant **Add app**.
-
- 
-
Copiez l'URL SSO, l'Entity ID et le certificat x509 fournis, puis envoyez-les à l'équipe Mintlify.
-
- 
-
Sur la page Service provider details, saisissez les éléments suivants :
@@ -253,10 +247,6 @@ Pour les fournisseurs autres que Microsoft Entra ou Okta SAML, [contactez-nous](
* Name ID format : `EMAIL`
* Name ID : `Basic Information > Primary email`
-
- 
-
-
À la page suivante, ajoutez les déclarations d'attribut suivantes :
| Google Directory Attribute | App Attribute |
diff --git a/fr/deploy/github.mdx b/fr/deploy/github.mdx
index 3043d29f0e..82613e8f78 100644
--- a/fr/deploy/github.mdx
+++ b/fr/deploy/github.mdx
@@ -65,15 +65,7 @@ Après avoir suivi l’une ou l’autre option, installez la GitHub App en suiva
Vous devez être propriétaire de l’organisation ou disposer des autorisations d’administrateur sur un référentiel pour installer l’application. Si vous n’avez pas les autorisations nécessaires, le propriétaire du référentiel doit approuver la demande d’installation.
-Installez la GitHub App de Mintlify depuis votre [Dashboard](https://dashboard.mintlify.com/settings/organization/github-app).
-
-
-
-
+Installez la GitHub App de Mintlify depuis la page [Git settings](https://app.mintlify.com/settings/project/git-settings) de votre Dashboard. Lorsque GitHub vous demande à quels référentiels accorder l’accès, choisissez **Only select repositories** et sélectionnez votre référentiel de documentation.
-
-
-
-
## Interpréter les exports de trafic
diff --git a/fr/analytics/index.mdx b/fr/analytics/index.mdx
index 4d26d9a281..e364779874 100644
--- a/fr/analytics/index.mdx
+++ b/fr/analytics/index.mdx
@@ -17,8 +17,8 @@ La page [analytics](https://app.mintlify.com/analytics) de votre dashboard montr
Les données analytics apparaissent généralement quelques minutes après une interaction. Les événements très récents peuvent ne pas apparaître immédiatement.
-
- ## Choisir une vue analytics
+
@@ -47,26 +47,12 @@ Les données analytics apparaissent généralement quelques minutes après une i
## Filtrer par période
-Utilisez le sélecteur de plage dans une vue analytics pour ajuster la période des données affichées. Les exports utilisent également la plage de temps sélectionnée.
-
-
-
+ ## Sélectionner une vue analytics
-
-
-
+Utilisez le sélecteur de plage dans une vue analytics pour ajuster la période des données affichées. Choisissez une plage prédéfinie, comme **Last 7 days** ou **All time**, ou sélectionnez une plage personnalisée dans le calendrier. Les exports utilisent également la plage de temps sélectionnée.
## Filtrer par page ou par chemin
-Utilisez le menu **Filter** pour restreindre le tableau de bord à une seule page ou à un chemin. Lorsque vous sélectionnez un chemin, la page analytics affiche les données de chaque chemin qu'il contient. Par exemple, si vous filtrez sur `docs/authentication`, la page analytics affiche les données de toutes les pages du chemin `docs/authentication/*`. Les vues Assistant et Search affichent toujours les données de l'ensemble du site.
+Utilisez le menu **Filter** pour restreindre le tableau de bord à une seule page ou à un chemin. Lorsque vous sélectionnez un chemin, la page analytics affiche les données de chaque page située sous ce chemin. Par exemple, si vous filtrez sur `docs/authentication`, la page analytics affiche les données de toutes les pages du chemin `docs/authentication/*`. Les vues Assistant et Search affichent toujours les données de l'ensemble du site.
Dans la vue Traffic, filtrer par page modifie le classement des pages populaires pour qu'il commence à la page sélectionnée et se poursuive vers le bas du classement, plutôt que d'afficher uniquement cette page.
diff --git a/fr/api-playground/adding-sdk-examples.mdx b/fr/api-playground/adding-sdk-examples.mdx
index 9a230116f2..08a36592c1 100644
--- a/fr/api-playground/adding-sdk-examples.mdx
+++ b/fr/api-playground/adding-sdk-examples.mdx
@@ -74,10 +74,6 @@ Accédez à votre [tableau de bord Speakeasy](https://app.speakeasy.com) et ouvr
Depuis la page de l'entrée du registre, copiez l'URL publique fournie.
-
-
-
-
- ## Trouver l'identifiant de l'automatisation
-
-
-Exécutez [`mint automations list`](/fr/cli/commands#mint-automations-list) dans votre terminal et copiez l'identifiant depuis la sortie.
-
## Exemple
diff --git a/fr/assistant/configure.mdx b/fr/assistant/configure.mdx
index edfe141827..91f895aba5 100644
--- a/fr/assistant/configure.mdx
+++ b/fr/assistant/configure.mdx
@@ -4,20 +4,15 @@ description: "Configurez l'assistant IA dans le tableau de bord Mintlify : dispo
keywords: ["assistant", "paramètres", "redirection", "protection contre les bots", "facturation"]
---
-Configurez l'assistant sur la page [Assistant](https://dashboard.mintlify.com/products/assistant) de votre tableau de bord. Gérez la facturation et l'utilisation sur la page [Utilisation](https://dashboard.mintlify.com/settings/organization/usage).
+Configurez l'assistant sur la page [Assistant](https://app.mintlify.com/products/assistant) de votre tableau de bord. Gérez la facturation et l'utilisation sur la page [Utilisation](https://app.mintlify.com/settings/organization/usage).
## Activer ou désactiver l'assistant
-Basculez le statut pour activer ou désactiver l'assistant sur votre site de documentation.
+Sur la page [Assistant](https://app.mintlify.com/products/assistant) de votre tableau de bord, cliquez sur le bouton de statut pour activer ou désactiver l'assistant sur votre site.
-
-
-
-
-
-
+
+Si vous préférez rediriger les questions de support vers vos canaux existants, désactivez **Contact form** dans la section Gestion des réponses.
-
-
-
-
+Lorsque vous désactivez le formulaire de contact, l'assistant redirige les utilisateurs vers votre adresse e-mail de support en texte brut au lieu d'afficher le formulaire dans le chat. Les questions commerciales continuent d'utiliser le formulaire dans le chat lorsque vous configurez un e-mail commercial.
+
-Les administrateurs de l'organisation peuvent exiger que toutes les personnes de l'organisation se connectent via votre fournisseur d'identité. Lorsque Require SSO est activé, Mintlify rejette les connexions par mot de passe, lien magique et Google OAuth.
+Pour exiger que toutes les personnes de votre organisation se connectent via votre fournisseur d'identité, activez **Require SSO**. Lorsque **Require SSO** est activé, Mintlify rejette les connexions par mot de passe, lien magique et Google OAuth.
1. Accédez à la page [Identity & access](https://app.mintlify.com/settings/organization/sso) de votre dashboard.
2. Vérifiez que le SSO fonctionne de bout en bout. Dans une fenêtre de navigation privée, connectez-vous à votre dashboard Mintlify depuis le catalogue d'applications de votre fournisseur d'identité (initié par l'IdP) et depuis la [page de connexion Mintlify](https://app.mintlify.com/login) en utilisant une adresse e-mail sur un domaine vérifié (initié par le SP). Les deux flux doivent effectuer une redirection via votre fournisseur d'identité et vous amener au dashboard.
@@ -235,15 +235,9 @@ Pour les fournisseurs autres que Microsoft Entra ou Okta SAML, [contactez-nous](
## Définir les e-mails de redirection
@@ -32,12 +27,11 @@ Lorsque vous activez la redirection et que l'assistant détecte une question cor
Le même formulaire de contact est disponible dans le [widget de l'assistant](/fr/assistant/widget) intégré sur d'autres sites.
-Si vous préférez rediriger les questions de support vers vos canaux existants, désactivez **Afficher le formulaire de contact** dans la section Gestion des réponses. Lorsque le formulaire de contact est désactivé, l'assistant redirige les utilisateurs vers votre adresse e-mail de support en texte brut au lieu d'afficher le formulaire dans le chat. Les questions commerciales continuent d'utiliser le formulaire dans le chat lorsqu'un e-mail commercial est configuré. Ce paramètre est activé par défaut.
+
-
-
+Lorsque vous désactivez le formulaire de contact, l'assistant redirige les utilisateurs vers votre adresse e-mail de support en texte brut au lieu d'afficher le formulaire dans le chat. Les questions commerciales continuent d'utiliser le formulaire dans le chat lorsque vous configurez un e-mail commercial.
+
## Rediriger vers un lien d'assistance
@@ -60,11 +54,6 @@ Dans la section Gestion des réponses, configurez les domaines que l'assistant p
- Les domaines doivent être accessibles publiquement.
- L'assistant ne peut pas effectuer de recherches sur les domaines nécessitant JavaScript pour se charger.
-
-
-
-
-
Pour un contrôle plus précis sur ce que l'assistant peut rechercher, utilisez la syntaxe de filtrage.
- **Filtrage au niveau du domaine**
@@ -99,7 +88,7 @@ Dans la section **Bot Protection**, activez le captcha invisible pour protéger
Pour activer la protection contre les bots :
-1. Accédez à la page [Paramètres de l'assistant](https://dashboard.mintlify.com/products/assistant/settings) dans votre tableau de bord.
+1. Accédez à la page [Paramètres de l'assistant](https://app.mintlify.com/products/assistant/settings) dans votre tableau de bord.
2. Dans la section **Bot Protection**, activez **Invisible Captcha**.
Les modifications prennent jusqu'à 10 minutes pour se propager.
@@ -142,4 +131,4 @@ Dans la section **Spending controls** de votre tableau de bord, configurez des a
### Volumes de crédits plus élevés
-Si 10 000 crédits par mois ne suffisent pas, [contactez l'équipe commerciale](mailto:sales@mintlify.com) au sujet d'un plan Enterprise avec des forfaits de crédits personnalisés.
+Pour les forfaits de plus de 10 000 crédits par mois, [contactez l'équipe commerciale](mailto:sales@mintlify.com) pour discuter de forfaits de crédits personnalisés.
diff --git a/fr/assistant/index.mdx b/fr/assistant/index.mdx
index 710455bf45..bb360c5c00 100644
--- a/fr/assistant/index.mdx
+++ b/fr/assistant/index.mdx
@@ -38,7 +38,7 @@ Par défaut, l'assistant n'indexe pas les pages masquées. Pour inclure les page
L'assistant répond uniquement aux questions en se basant sur les informations de votre documentation. S'il ne trouve pas d'informations pertinentes après avoir effectué une recherche, il répond qu'il ne dispose pas de suffisamment d'informations pour répondre.
-Vous pouvez [définir un e-mail de redirection](/fr/assistant/configure#set-deflection-email) pour que l'assistant fournisse votre e-mail de support aux utilisateurs dont il ne peut pas répondre aux questions. Cela offre aux utilisateurs une solution de recours, même si la documentation ne traite pas leur question spécifique.
+Vous pouvez [définir un e-mail de redirection](/fr/assistant/configure#set-deflection-emails) pour que l'assistant fournisse votre e-mail de support aux utilisateurs dont il ne peut pas répondre aux questions. Cela offre aux utilisateurs une solution de recours, même si la documentation ne traite pas leur question spécifique.
-
-
-
Pour un contrôle plus précis sur ce que l'assistant peut rechercher, utilisez la syntaxe de filtrage.
- **Filtrage au niveau du domaine**
@@ -99,7 +88,7 @@ Dans la section **Bot Protection**, activez le captcha invisible pour protéger
Pour activer la protection contre les bots :
-1. Accédez à la page [Paramètres de l'assistant](https://dashboard.mintlify.com/products/assistant/settings) dans votre tableau de bord.
+1. Accédez à la page [Paramètres de l'assistant](https://app.mintlify.com/products/assistant/settings) dans votre tableau de bord.
2. Dans la section **Bot Protection**, activez **Invisible Captcha**.
Les modifications prennent jusqu'à 10 minutes pour se propager.
@@ -142,4 +131,4 @@ Dans la section **Spending controls** de votre tableau de bord, configurez des a
### Volumes de crédits plus élevés
## Statistiques de l'assistant
diff --git a/fr/assistant/use.mdx b/fr/assistant/use.mdx
index 1ffd97f036..cf9cf37e3d 100644
--- a/fr/assistant/use.mdx
+++ b/fr/assistant/use.mdx
@@ -93,11 +93,6 @@ https://yourdocs.mintlify.site/quickstart?assistant=How%20do%20I%20get%20started
Surlignez du texte sur une page et cliquez sur le bouton contextuel **Add to assistant** pour ouvrir le panneau de chat de l'assistant et ajouter le texte surligné comme contexte. Vous pouvez ajouter plusieurs extraits de texte ou blocs de code au contexte de l'assistant.
-
-
-
-
-
-
-
-
Nous nous efforçons de répondre à tous les messages dans un délai de 24 heures, mais des retards peuvent survenir en période de forte activité.
@@ -33,4 +29,4 @@ Envoyez‑nous un message depuis votre [Dashboard](https://dashboard.mintlify.co
## Contact par e‑mail
-Si vous ne pouvez pas accéder à votre Dashboard, veuillez nous écrire à support@mintlify.com. Veuillez inclure l'URL de votre [Dashboard](https://dashboard.mintlify.com/) avec votre organisation et déploiement dans votre e‑mail afin que nous puissions vous aider plus rapidement. Par exemple, `dashboard.mintlify.com/your-org/your-deployment`.
\ No newline at end of file
+Si vous ne pouvez pas accéder à votre Dashboard, veuillez nous écrire à support@mintlify.com. Veuillez inclure l'URL de votre [Dashboard](https://app.mintlify.com/) avec votre organisation et déploiement dans votre e‑mail afin que nous puissions vous aider plus rapidement. Par exemple, `app.mintlify.com/your-org/your-deployment`.
\ No newline at end of file
diff --git a/fr/dashboard/sso.mdx b/fr/dashboard/sso.mdx
index f35c99941f..d10746d71c 100644
--- a/fr/dashboard/sso.mdx
+++ b/fr/dashboard/sso.mdx
@@ -32,7 +32,7 @@ Les administrateurs Enterprise peuvent configurer l'authentification unique (SSO
* **Audience URI** : l'URI que vous avez copiée depuis votre dashboard Mintlify
* **Name ID Format** : `EmailAddress`
- 4. Ajoutez ces déclarations d'attribut :
+ 3. Ajoutez ces déclarations d'attribut :
| Name | Name format | Value |
| ---- | ----------- | ----- |
@@ -127,7 +127,7 @@ Pour supprimer un domaine, cliquez sur le bouton
-
-
-
## Blocs de code
@@ -124,11 +119,6 @@ Limites :
- Taille maximale du fichier : 5 Mo par pièce jointe
- Nombre maximal de pièces jointes par message : 10
-
-
-
-
-
## Dépannage
diff --git a/fr/assistant/widget.mdx b/fr/assistant/widget.mdx
index ea29f8c68e..4044e7727d 100644
--- a/fr/assistant/widget.mdx
+++ b/fr/assistant/widget.mdx
@@ -16,7 +16,7 @@ L'[assistant](/fr/assistant) répond aux questions sur votre site Mintlify. Pour
Ajoutez le widget à n'importe quel site web ou application web à l'aide d'un script hébergé. Le widget possède son propre déclencheur et s'affiche dans un Shadow DOM fermé, ce qui empêche les styles de votre application d'affecter le widget.
-La seule option de navigateur requise est l'ID public du widget. Gérez l'état d'activation, les origines autorisées, les pièces jointes, la protection contre les bots et le [formulaire de contact de déflection](/fr/assistant/configure#set-deflection-email) dans votre tableau de bord. Définissez les questions d'introduction spécifiques à l'intégration et une adresse e-mail d'assistance dans la configuration du navigateur.
+La seule option de navigateur requise est l'ID public du widget. Gérez l'état d'activation, les origines autorisées, les pièces jointes, la protection contre les bots et le [formulaire de contact de déflection](/fr/assistant/configure#set-deflection-emails) dans votre tableau de bord. Définissez les questions d'introduction spécifiques à l'intégration et une adresse e-mail d'assistance dans la configuration du navigateur.
## Prérequis
diff --git a/fr/automations/manage.mdx b/fr/automations/manage.mdx
index b4845ecdc4..93bb7c30d7 100644
--- a/fr/automations/manage.mdx
+++ b/fr/automations/manage.mdx
@@ -14,20 +14,12 @@ import GitlabAutomationSetup from '/snippets/fr/gitlab-automation-setup.mdx';
- Pour GitHub : la [GitHub App Mintlify](/fr/deploy/github) installée sur chaque dépôt que vous prévoyez d'utiliser dans l'automatisation
- Pour GitLab : un compte GitLab connecté (voir [Configuration GitLab](#gitlab-setup) ci-dessous)
-
- Vous pouvez également créer, lister et supprimer des automatisations depuis le terminal avec [`mint automations`](/fr/cli/commands#mint-automations). La CLI est utile pour les scripts et la CI. Le dashboard est le moyen le plus simple de configurer et de surveiller les exécutions d'automatisations.
-
-
-
-
Si l'automatisation peut s'exécuter avec les paramètres par défaut, elle s'active immédiatement. Sinon, la page de configuration de l'automatisation s'ouvre pour vous permettre de remplir les configurations requises.
3. Si la page de configuration s'ouvre, remplissez les champs requis et cliquez sur **Save**.
@@ -48,8 +40,8 @@ Chaque automatisation possède un déclencheur par défaut qui contrôle son mom
- **Mise à jour de contenu** : s'exécute chaque fois que vous poussez du contenu vers le dépôt de votre projet, y compris les fusions de pull requests et les pushes directs.
- **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. Vous devez spécifier au moins un dépôt source. Cliquez sur **Add repo** pour déclencher l'automatisation sur des pull requests provenant de plusieurs dépôts. Pour chaque dépôt, vous pouvez éventuellement définir **Exclude author** pour ignorer les pull requests d'un auteur spécifique, et **Listening to changes in** pour ne déclencher que sur les pull requests dont les modifications se trouvent sous un chemin spécifique.
-- **Calendrier personnalisé** : s'exécute selon un calendrier récurrent que vous définissez. Choisissez un préréglage (**Daily**, **Every Monday**, **Every Friday** ou **Twice weekly**) et une heure de début, ou sélectionnez **Custom cron** et saisissez une expression cron standard à 5 champs (`minute heure jour mois jour_de_la_semaine`). Les valeurs cron sont stockées en UTC ; le dashboard convertit les heures des préréglages depuis et vers votre fuseau horaire local. Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée.
-- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés. Pour les déclencheurs Slack, choisissez un ou plusieurs canaux auxquels l'[application Mintlify pour Slack](/fr/agent/slack) a été ajoutée.
+- **Calendrier personnalisé** : s'exécute selon un calendrier récurrent que vous définissez. Choisissez un préréglage (**Daily**, **Every Monday**, **Every Friday** ou **Twice weekly**) et une heure de début, ou sélectionnez **Custom cron** et saisissez une expression cron standard à 5 champs (`minute heure jour mois jour_de_la_semaine`). Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée.
+- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés. Pour les déclencheurs Slack, choisissez un ou plusieurs canaux auxquels l'[application Mintlify pour Slack](/fr/agent/slack) a été ajoutée.
- **Webhook** : s'exécute lorsqu'une requête `POST` authentifiée atteint le point de terminaison webhook de l'automatisation. Disponible uniquement pour les automatisations personnalisées. Enregistrez d'abord l'automatisation. La carte du déclencheur affiche alors l'URL du webhook et une action **Copy auth header** pour l'en-tête `Authorization: Bearer `. Fournissez une clé d'API d'organisation non expirée avec accès en écriture depuis la page [API keys](https://app.mintlify.com/settings/organization/api-keys). Utilisez-le pour déclencher une exécution depuis un pipeline CI/CD, un script de publication ou un outil interne. Consultez [Déclencher un webhook d'automatisation](/fr/api/automations/webhook) pour le point de terminaison et les limites de débit.
+ `mint format` réécrit les fichiers sur place. Committez ou stashez vos modifications avant de l'exécuter afin de pouvoir examiner le diff.
+
+
Formate chaque fichier `.mdx` du répertoire courant selon le style canonique de Mintlify. La commande analyse chaque fichier avec le même parseur MDX que celui utilisé par l'éditeur web, puis le réécrit sur place si la sortie canonique diffère.
```bash
@@ -672,9 +667,9 @@ mint format
Exécutez la commande depuis la racine de votre projet de documentation. Elle parcourt tous les sous-répertoires, en ignorant les chemins correspondant à `.gitignore` et à toute règle d'exclusion Mintlify. Les fichiers qui correspondent déjà à la sortie canonique restent inchangés.
-
- `mint format` réécrit les fichiers sur place. Committez ou stashez vos modifications avant de l'exécuter afin de pouvoir examiner le diff.
-
+
+ L'exécution de `mint format` peut entraîner de nombreuses modifications selon la taille de votre projet. Pour éviter les conflits de fusion et l'introduction de modifications dans d'autres travaux en cours, commencez par résoudre toutes les branches importantes en attente. Créez ensuite une nouvelle branche pour les modifications de formatage et exécutez `mint format` sur cette branche.
+
Une fois terminé, la commande affiche le nombre de fichiers MDX reformatés et le nombre de fichiers dont l'analyse a échoué. Si un fichier échoue, la commande se termine avec le code `1` et affiche le chemin du fichier ainsi que l'erreur, ce qui vous permet de l'exécuter en CI pour imposer un formatage cohérent. Consultez [Installer en CI](/fr/cli/install#install-in-ci) pour un exemple de pipeline.
diff --git a/fr/cli/preview.mdx b/fr/cli/preview.mdx
index 827cdd65df..8ae9508c28 100644
--- a/fr/cli/preview.mdx
+++ b/fr/cli/preview.mdx
@@ -49,7 +49,7 @@ Vous devez authentifier la CLI avec votre compte Mintlify pour activer la recher
mint login
```
-Après vous être authentifié avec la commande `mint login`, la CLI stocke vos identifiants dans `~/.config/mintlify/config.json` afin que vous restiez connecté entre les sessions. La CLI vous invite également à sélectionner un projet par défaut, que des commandes comme `mint automations` utilisent.
+Après vous être authentifié avec la commande `mint login`, la CLI stocke vos identifiants dans `~/.config/mintlify/config.json` afin que vous restiez connecté entre les sessions. La CLI vous invite également à sélectionner un projet par défaut.
Une fois connecté, exécutez `mint dev` pour démarrer la prévisualisation locale avec la recherche et l'assistant activés. L'assistant utilise le même contenu indexé que votre site de documentation déployé.
diff --git a/fr/contact-support.mdx b/fr/contact-support.mdx
index 6ab6735633..2dcbbba0f7 100644
--- a/fr/contact-support.mdx
+++ b/fr/contact-support.mdx
@@ -19,11 +19,7 @@ Consultez notre chaîne [YouTube](https://www.youtube.com/@GetMintlify/videos) p
## Assistance via messagerie
-Envoyez‑nous un message depuis votre [Dashboard](https://dashboard.mintlify.com/). Cliquez sur le bouton d’assistance
## Activer une automatisation
1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur le bouton bascule à côté d'une automatisation pour l'activer.
-
-
-
-
Si l'automatisation peut s'exécuter avec les paramètres par défaut, elle s'active immédiatement. Sinon, la page de configuration de l'automatisation s'ouvre pour vous permettre de remplir les configurations requises.
3. Si la page de configuration s'ouvre, remplissez les champs requis et cliquez sur **Save**.
@@ -48,8 +40,8 @@ Chaque automatisation possède un déclencheur par défaut qui contrôle son mom
- **Mise à jour de contenu** : s'exécute chaque fois que vous poussez du contenu vers le dépôt de votre projet, y compris les fusions de pull requests et les pushes directs.
- **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. Vous devez spécifier au moins un dépôt source. Cliquez sur **Add repo** pour déclencher l'automatisation sur des pull requests provenant de plusieurs dépôts. Pour chaque dépôt, vous pouvez éventuellement définir **Exclude author** pour ignorer les pull requests d'un auteur spécifique, et **Listening to changes in** pour ne déclencher que sur les pull requests dont les modifications se trouvent sous un chemin spécifique.
-- **Calendrier personnalisé** : s'exécute selon un calendrier récurrent que vous définissez. Choisissez un préréglage (**Daily**, **Every Monday**, **Every Friday** ou **Twice weekly**) et une heure de début, ou sélectionnez **Custom cron** et saisissez une expression cron standard à 5 champs (`minute heure jour mois jour_de_la_semaine`). Les valeurs cron sont stockées en UTC ; le dashboard convertit les heures des préréglages depuis et vers votre fuseau horaire local. Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée.
-- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés. Pour les déclencheurs Slack, choisissez un ou plusieurs canaux auxquels l'[application Mintlify pour Slack](/fr/agent/slack) a été ajoutée.
+- **Calendrier personnalisé** : s'exécute selon un calendrier récurrent que vous définissez. Choisissez un préréglage (**Daily**, **Every Monday**, **Every Friday** ou **Twice weekly**) et une heure de début, ou sélectionnez **Custom cron** et saisissez une expression cron standard à 5 champs (`minute heure jour mois jour_de_la_semaine`). Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée.
+- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés. Pour les déclencheurs Slack, choisissez un ou plusieurs canaux auxquels l'[application Mintlify pour Slack](/fr/agent/slack) a été ajoutée.
- **Webhook** : s'exécute lorsqu'une requête `POST` authentifiée atteint le point de terminaison webhook de l'automatisation. Disponible uniquement pour les automatisations personnalisées. Enregistrez d'abord l'automatisation. La carte du déclencheur affiche alors l'URL du webhook et une action **Copy auth header** pour l'en-tête `Authorization: Bearer
@@ -61,7 +53,7 @@ Pour les automatisations avec un déclencheur **Modification de code** sur GitHu
- **Listening to changes in** : ajoutez les chemins que la pull request doit modifier pour que l'automatisation s'exécute. Les chemins peuvent être des fichiers, des dossiers ou des motifs glob (par exemple, `docs/**/*.mdx`). Les suggestions proviennent des fichiers suivis du dépôt ; vous pouvez également saisir un chemin personnalisé.
- **Excluding PRs from** : ajoutez les noms d'utilisateur GitHub ou les comptes de bot dont les pull requests ne doivent pas déclencher l'automatisation. Utile pour ignorer les fusions provenant de comptes d'automatisation. Les suggestions proviennent des contributeurs récents ; vous pouvez également saisir un nom d'utilisateur personnalisé.
-Chaque dépôt prend en charge jusqu'à 20 chemins et 20 auteurs exclus. Changer le dépôt d'une carte efface ses filtres. Les dépôts sources GitLab ne prennent pas en charge les filtres par dépôt et continuent d'utiliser un sélecteur de dépôt unique.
+Chaque dépôt prend en charge jusqu'à 20 chemins et 20 auteurs exclus. Changer le dépôt d'une automatisation efface ses filtres.
[value]
| Clé | Description | Utilisé par |
| --- | --- | --- |
-| `subdomain` | Sous-domaine par défaut de la documentation. | `mint dev`, `mint automations`, `mint analytics`, `mint add-domain`, `mint score` |
+| `subdomain` | Sous-domaine par défaut de la documentation. | `mint dev`, `mint analytics`, `mint add-domain`, `mint score` |
| `dateFrom` | Date de début par défaut pour les requêtes d'analytics. | `mint analytics` |
| `dateTo` | Date de fin par défaut pour les requêtes d'analytics. | `mint analytics` |
@@ -444,7 +442,7 @@ Vérifier les liens internes cassés dans votre documentation.
mint broken-links [flags]
```
-La commande exclut les fichiers correspondant aux motifs [.mintignore](/fr/organize/mintignore). Les liens pointant vers des fichiers ignorés sont signalés comme cassés.
+La commande analyse les liens des fichiers `.mdx` et `.md` et exclut les fichiers correspondant aux motifs [.mintignore](/fr/organize/mintignore). Les liens contenus dans les fichiers de spécification OpenAPI (`.yaml`, `.yml`, `.json`) ne sont pas vérifiés. Les liens pointant vers des fichiers ignorés sont signalés comme cassés.
| Flag | Description |
| --- | --- |
@@ -464,7 +462,7 @@ mint broken-links --files introduction.mdx
mint broken-links --files "guides/**/*.mdx"
# Passer plusieurs chemins
-mint broken-links --files introduction.mdx --files "guides/**/*.mdx"
+mint broken-links --files introduction.mdx "guides/**/*.mdx"
```
---
@@ -539,13 +537,6 @@ mint test
Seules les pages présentes dans la navigation de votre `docs.json` apparaissent pour la sélection.
-
-
-
-
+
### Mode de mise à jour
@@ -152,14 +144,12 @@ Lorsque vous réactivez une automatisation planifiée ou modifiez son calendrier
## Supprimer une automatisation
-Vous pouvez supprimer les automatisations personnalisées depuis le dashboard. Les automatisations prédéfinies ne peuvent pas être supprimées depuis le dashboard. Désactivez-les à la place, ou utilisez la CLI pour les supprimer.
+La suppression est définitive et ne peut pas être annulée.
1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur le bouton
## Exécuter une automatisation manuellement
@@ -218,13 +208,15 @@ Chaque résultat affiche l'un des statuts suivants :
Vous pouvez agir sur les résultats directement depuis la liste. Pour les exécutions en attente de relecture, cliquez sur **Accept** pour fusionner les modifications ou sur **Preview** pour ouvrir le [preview deployment](/fr/deploy/preview-deployments) de la branche de l'exécution. Pour les résultats en échec, cliquez sur **Re-trigger** pour relancer l'exécution.
-Le bouton **Preview** n'apparaît que lorsqu'un preview deployment est lié à l'exécution. Les preview deployments expirent après une période d'inactivité ; une fois expirés, le bouton est désactivé.
+Le bouton **Preview** n'apparaît que lorsqu'un preview deployment est lié à l'exécution. Les preview deployments expirent après une période d'inactivité ; une fois expirés, le bouton affiche **Preview expired** et ne fonctionne plus.
### Résoudre les conflits de fusion
-Si la pull request d'une exécution entre en conflit avec votre branche de déploiement, cliquer sur **Accept** ouvre une boîte de dialogue proposant de résoudre les conflits pour vous. Cliquez sur **Resolve and merge** pour que l'agent fusionne les derniers changements de la branche de déploiement dans la branche de la pull request, résolve les conflits et fusionne automatiquement la pull request. L'exécution s'affiche comme **Running** pendant que l'agent travaille, puis passe à **Accepted** une fois la pull request fusionnée. Si l'agent ne peut pas résoudre les conflits, résolvez-les manuellement dans votre dépôt, puis cliquez à nouveau sur **Accept**.
+Si la pull request d'une exécution entre en conflit avec votre branche de déploiement, l'agent vous invite à résoudre les conflits lorsque vous cliquez sur **Accept** pour une exécution d'automatisation.
+
+Cliquez sur **Resolve and merge** pour que l'agent fusionne les derniers changements de la branche de déploiement dans la branche de la pull request, résolve les conflits et fusionne automatiquement la pull request. Si l'agent ne peut pas résoudre les conflits, résolvez-les manuellement dans votre dépôt, puis cliquez sur **Accept**.
Pour voir le prompt d'une exécution, les fichiers qu'elle a lus ou modifiés, et toute pull request, cliquez sur le menu d'actions
### Options
@@ -428,7 +426,7 @@ mint config
-
-
### Revenir à une exécution précédente
@@ -664,6 +655,10 @@ Le score global utilise une notation pondérée, de sorte que les vérifications
## `mint format`
-
+Envoyez‑nous un message depuis votre [Dashboard](https://app.mintlify.com/). Cliquez sur
-
+Installez la GitHub App de Mintlify depuis la page [Git settings](https://app.mintlify.com/settings/project/git-settings) de votre Dashboard. Lorsque GitHub vous demande à quels référentiels accorder l’accès, choisissez **Only select repositories** et sélectionnez votre référentiel de documentation.
## Autorisations
@@ -100,7 +92,7 @@ L’app n’accède qu’aux référentiels auxquels vous lui avez explicitement
## Gérer l’accès aux référentiels
-Lors de l’installation de la GitHub App, vous pouvez accorder l’accès à l’ensemble de vos référentiels ou uniquement à certains d’entre eux. Nous recommandons de n’accorder l’accès qu’à votre référentiel de documentation ainsi qu’aux référentiels que vous souhaitez utiliser comme contexte pour l’agent ou les workflows. Vous pouvez modifier cette sélection à tout moment dans vos [paramètres de l’application GitHub](https://github.com/apps/mintlify/installations/new).
+Lors de l’installation de la GitHub App, vous pouvez accorder l’accès à l’ensemble de vos référentiels ou uniquement à certains d’entre eux. N’accordez l’accès qu’à votre référentiel de documentation ainsi qu’aux référentiels que vous souhaitez utiliser comme contexte pour l’agent ou les workflows. Vous pouvez modifier cette sélection à tout moment dans vos [paramètres de l’application GitHub](https://github.com/apps/mintlify/installations/new).
## Configurer la source de la documentation
@@ -130,7 +122,7 @@ Si vos pushes vers votre référentiel ne déclenchent pas de déploiements, vé
Vérifiez que la GitHub App est installée sur le bon référentiel.
- 1. Allez dans les [paramètres de la GitHub App](https://dashboard.mintlify.com/settings/organization/github-app) dans votre Dashboard.
+ 1. Accédez à la page [Git settings](https://app.mintlify.com/settings/project/git-settings) de votre Dashboard.
1. Vérifiez que votre référentiel figure dans la liste des installations actives de l'app.
@@ -154,37 +146,6 @@ Si vous rencontrez des problèmes avec l’application GitHub, réinitialiser la
1. Dans votre tableau de bord Mintlify, allez dans [Git Settings](https://app.mintlify.com/settings/project/git-settings) et installez la GitHub App.
- 2. Autorisez votre compte dans la section [My Profile](https://dashboard.mintlify.com/settings/account) de votre tableau de bord.
+ 2. Autorisez votre compte dans la section [My Profile](https://app.mintlify.com/settings/account) de votre tableau de bord.
-
-
-
-Les fonctionnalités de feedback « suggestions d’édition » et « signalement de problèmes » ne sont disponibles que pour les référentiels GitHub publics. Si ces options sont indisponibles dans votre Tableau de bord Mintlify, vérifiez la visibilité de votre référentiel.
-
-Si votre référentiel est public et que vous ne pouvez pas activer les options de suggestions d’édition ou de signalement de problèmes dans votre Tableau de bord Mintlify, revalidez vos paramètres Git.
-
-
-
- Accédez aux [paramètres Git](https://app.mintlify.com/settings/project/git-settings) dans votre Tableau de bord Mintlify.
-
-
- Cliquez sur la coche verte dans le coin du cadre des paramètres Git pour revalider les paramètres de votre référentiel. Cela force une mise à jour de vos paramètres afin de refléter si votre référentiel est public ou privé.
-
-
-
-
-
-
-
-
\ No newline at end of file
diff --git a/fr/deploy/gitlab.mdx b/fr/deploy/gitlab.mdx
index 481b27e7a6..e506dc8137 100644
--- a/fr/deploy/gitlab.mdx
+++ b/fr/deploy/gitlab.mdx
@@ -34,9 +34,6 @@ Lorsque vous ouvrez [Git Settings](https://app.mintlify.com/settings/project/git
Dans votre projet GitLab, accédez à **Settings** > **General** et repérez votre **Project ID**.
-
-
-
Accédez à **Settings** > **Access Tokens** et sélectionnez **Add new token**.
@@ -52,10 +49,6 @@ Lorsque vous ouvrez [Git Settings](https://app.mintlify.com/settings/project/git
Si les Project Access Tokens ne sont pas disponibles, vous pouvez utiliser un Personal Access Token. Notez que les Personal Access Tokens expirent et doivent être renouvelés.
-
-
-
-
De retour dans l'assistant de configuration, remplissez les champs suivants :
@@ -79,7 +72,9 @@ Lorsque vous ouvrez [Git Settings](https://app.mintlify.com/settings/project/git
Pour modifier les paramètres de votre connexion GitLab après la configuration initiale, accédez à [Git Settings](https://app.mintlify.com/settings/project/git-settings) et mettez à jour votre ID de projet, jeton d'accès, branche ou URL d'instance directement.
-## Revalider les paramètres Git
+
- Cliquez sur le badge vert **Active** dans le coin du cadre des paramètres GitLab pour revalider votre source Git. Un toast de succès confirme la fin de la revalidation, et un toast d'erreur apparaît si votre configuration nécessite une vérification.
+ Cliquez sur le badge vert **Active** dans le coin du cadre des paramètres GitLab pour revalider votre source Git.
@@ -102,9 +97,6 @@ Les webhooks notifient Mintlify lorsque vous poussez des modifications afin que
1. Dans GitLab, accédez à **Settings** > **Webhooks**.
2. Cliquez sur **Add new webhook**.
-
-
-
Nommez le webhook **Mintlify**.
@@ -113,10 +105,6 @@ Les webhooks notifient Mintlify lorsque vous poussez des modifications afin que
Dans votre Tableau de bord Mintlify, cliquez sur **Show webhook token**. Copiez le jeton du webhook.
-
-
-
-
Dans GitLab, collez le jeton du webhook depuis votre Tableau de bord Mintlify dans le champ **Secret token**.
@@ -135,17 +123,9 @@ Les webhooks notifient Mintlify lorsque vous poussez des modifications afin que
- **Events** : **Push events** (All branches) et **Merge requests events**
Ajoutez le webhook.
-
-
-
-
Après avoir créé le webhook, cliquez sur le menu déroulant **Test**. Cliquez sur **Push events** pour envoyer un payload d'exemple. Si le test renvoie `Hook executed successfully: HTTP 200`, vous avez correctement configuré le webhook.
-
-
-
-
diff --git a/fr/deploy/multi-repo.mdx b/fr/deploy/multi-repo.mdx
index 1e74878c40..87d620999f 100644
--- a/fr/deploy/multi-repo.mdx
+++ b/fr/deploy/multi-repo.mdx
@@ -60,11 +60,6 @@ Un référentiel sert de **source de base** pour le déploiement. Son `docs.json
Accédez aux [paramètres Git](https://app.mintlify.com/settings/project/git-settings) dans votre tableau de bord.
-
-
-
-
-
@@ -211,7 +206,7 @@ Utilisez `sourceRef` pour placer la navigation d'un autre référentiel à un em
- Le référentiel référencé doit être configuré comme source dans le même déploiement multi-référentiels.
- Les valeurs de `sourceRef` doivent inclure au moins deux segments de chemin, comme `owner/repo`. Les chemins de montage et les noms de référentiel seuls ne sont pas pris en charge.
-- Pour les référentiels GitLab dans des sous-groupes imbriqués, utilisez le chemin complet, comme `group/subgroup/repo`. Vous pouvez raccourcir la valeur aux deux derniers segments, comme `subgroup/repo`, sauf si deux sources partagent les mêmes segments finaux. Lorsque deux sources partagent les mêmes segments finaux, utilisez le chemin complet pour chacune.
+ - Pour les référentiels GitLab dans des sous-groupes imbriqués, utilisez le chemin complet, comme `group/subgroup/repo`. Vous pouvez raccourcir la valeur aux deux derniers segments, comme `subgroup/repo`, sauf si deux sources partagent les mêmes segments finaux. Lorsque deux sources partagent les mêmes segments finaux, utilisez le chemin complet pour chacune.
- La source référencée doit définir un schéma de navigation similaire à celui de la source principale. Par exemple, un `sourceRef` à l'intérieur de `anchors` exige que la source référencée définisse `navigation.anchors`.
- Les entrées `sourceRef` ne peuvent pas former de cycle. Une source ne peut pas se référencer elle-même, et deux sources ne peuvent pas se référencer mutuellement.
- `sourceRef` doit apparaître à l'intérieur d'un tableau de navigation. Il n'est pas valide au niveau supérieur de `navigation`.
diff --git a/fr/deploy/preview-deployments.mdx b/fr/deploy/preview-deployments.mdx
index cfb73a197c..545235c55b 100644
--- a/fr/deploy/preview-deployments.mdx
+++ b/fr/deploy/preview-deployments.mdx
@@ -67,15 +67,8 @@ Vous pouvez également créer des déploiements de prévisualisation de manière
Redéployez un aperçu pour actualiser le contenu ou réessayer après un déploiement ayant échoué.
1. Accédez à la page [Activity](https://app.mintlify.com/activity) de votre Dashboard.
-2. Cliquez sur l'onglet **Previews**.
-3. Cliquez sur l'aperçu que vous souhaitez redéployer.
-4. Cliquez sur **Redeploy**.
-
-
-
-
-
-
+2. Cliquez sur l'aperçu que vous souhaitez redéployer.
+3. Cliquez sur **Redeploy**.
-
-
-
-
-
-
-
+ ## Revalider les paramètres Git
+
Si votre déploiement affiche un comportement inattendu, comme des options de branche manquantes ou une configuration obsolète, vous pouvez forcer Mintlify à actualiser votre source Git.
@@ -88,7 +83,7 @@ Si votre déploiement affiche un comportement inattendu, comme des options de br
Accédez aux [Git Settings](https://app.mintlify.com/settings/project/git-settings) dans votre Tableau de bord.
-
-
-
-
-
-
-
-
-
-
-
+2. Cliquez sur l'aperçu que vous souhaitez redéployer.
+3. Cliquez sur **Redeploy**.
## Widget d’aperçu
@@ -116,10 +109,6 @@ Restreignez l'accès aux aperçus aux membres authentifiés de votre organisatio
1. Accédez à la section **Previews** de la page [Général](https://app.mintlify.com/settings/project/general) de votre Dashboard.
2. Activez ou désactivez l'interrupteur **Preview authentication** pour gérer l'authentification des prévisualisations.
-
-
-
-
-
-
### Protéger un aperçu individuel par mot de passe
@@ -132,10 +121,6 @@ Protégez par mot de passe un aperçu spécifique pour le partager avec des rév
3. Sélectionnez **Create custom preview**.
4. Entrez le nom de la branche à prévisualiser.
5. Activez **Make private** et saisissez un mot de passe. Les mots de passe doivent contenir au moins 8 caractères.
-
-
-
-
6. Sélectionnez **Create preview**.
@@ -89,16 +70,8 @@ Les Behaviors de votre sous-chemin doivent autoriser toutes les méthodes HTTP.
3. Créez une nouvelle Origin et ajoutez votre URL de staging comme « Origin domain ».
-
- 
-
-
Vous devriez maintenant avoir deux Origins : une avec `[SUBDOMAIN].mintlify.site` et une autre avec votre URL de staging.
-
- 
-
-
```js Format
@@ -52,10 +52,6 @@ Après le déploiement, ouvrez votre site dans une fenêtre privée ou de naviga
Ajoutez `.mintlify.site/` en tant que règle gérée.
-
-
-
-
Cela garantit que tous les contenus servis par Mintlify (y compris les images, les feuilles de style et autres ressources de documentation) sont considérés comme essentiels et se chargeront même lorsque Osano bloque du contenu tiers non catégorisé.
diff --git a/fr/optimize/feedback.mdx b/fr/optimize/feedback.mdx
index bfa0dab159..29f94007e1 100644
--- a/fr/optimize/feedback.mdx
+++ b/fr/optimize/feedback.mdx
@@ -1,5 +1,6 @@
---
title: "Recueillir les retours des utilisateurs et agents IA"
+sidebarTitle: "Retours"
description: "Activez les widgets de retour, notes de page, retours contextuels, réactions sur les extraits de code et retours des agents pour améliorer vos docs."
keywords: ["user feedback", "thumbs rating", "contextual", "satisfaction", "agents"]
boost: 3
@@ -9,7 +10,7 @@ boost: 3
Les retours nécessitent un [plan Pro ou Enterprise](https://mintlify.com/pricing?ref=feedback).
-La section Retours de la page [analytics](https://app.mintlify.com/analytics) affiche les votes quantitatifs pouce en haut et pouce en bas que vos pages reçoivent des utilisateurs, ainsi que tous les retours qualitatifs qu'ils fournissent. Utilisez ces informations pour évaluer la qualité de votre contenu et apporter des améliorations.
+La section Retours de la page [analytics](https://app.mintlify.com/analytics) affiche les votes quantitatifs pouce en haut et pouce en bas que vos pages reçoivent des utilisateurs, ainsi que tous les retours qualitatifs qu'ils fournissent. Un graphique à barres montre les retours dans le temps, et les vues situées en dessous listent les retours individuels. Utilisez ces informations pour évaluer la qualité de votre contenu et apporter des améliorations.
Examinez vos données de retour pour :
@@ -49,25 +50,11 @@ Pour collecter et consulter les retours des utilisateurs, vous devez les activer
* **Contextual feedback** : retour en texte libre sur le contenu d'une page. Vous pouvez également activer la collecte d'e-mails pour permettre aux utilisateurs de fournir leur adresse e-mail lors de l'envoi d'un retour.
* **Code snippet feedback** : retour spécifique sur les extraits de code.
-
-
-
-
-
-
-
-
6. Sélectionnez **Create preview**.
diff --git a/fr/deploy/route53-cloudfront.mdx b/fr/deploy/route53-cloudfront.mdx
index 23fcb2d3a6..1da1c9f4aa 100644
--- a/fr/deploy/route53-cloudfront.mdx
+++ b/fr/deploy/route53-cloudfront.mdx
@@ -45,23 +45,9 @@ Les Behaviors de votre sous-chemin doivent autoriser toutes les méthodes HTTP.
1. Accédez à [CloudFront](https://aws.amazon.com/cloudfront) dans la console AWS.
2. Sélectionnez **Create distribution**.
-
-
- 
-
-
3. Pour le domaine d’origine, saisissez `[SUBDOMAIN].mintlify.site`, où `[SUBDOMAIN]` est le sous-domaine propre à votre projet.
-
-
- 
-
-
4. Pour « Web Application Firewall (WAF) », activez les protections de sécurité.
-
- 
-
-
Les règles WAF peuvent bloquer les requêtes `POST` que Mintlify utilise pour les analytiques et d'autres fonctionnalités interactives. Si les analytiques n'apparaissent plus dans votre tableau de bord après avoir activé WAF, consultez les journaux WAF pour repérer les requêtes bloquées vers les chemins sous `/docs/_mintlify/`.
@@ -74,11 +60,6 @@ Les Behaviors de votre sous-chemin doivent autoriser toutes les méthodes HTTP.
1. Après avoir créé la distribution, accédez à l’onglet « Origins ».
-
-
- 
-
-
2. Trouvez votre URL d’environnement de staging qui reflète le domaine principal. Cela varie selon l’hébergeur de votre page d’accueil. Par exemple, l’URL de staging de Mintlify est [mintlify-landing-page.vercel.app](https://mintlify-landing-page.vercel.app).
## Définir les comportements
@@ -109,11 +82,6 @@ Les comportements dans CloudFront permettent de contrôler la logique des sous-c
- **Si un utilisateur arrive sur une autre page**, le diriger vers la page d’accueil actuelle.
1. Accédez à l’onglet « Behaviors » de votre distribution CloudFront.
-
-
- 
-
-
2. Cliquez sur le bouton **Create behavior** et créez les comportements suivants.
@@ -124,10 +92,6 @@ Créez des comportements pour les chemins de vérification de domaine Vercel ave
Pour la « Cache policy », sélectionnez **CachingDisabled** afin de garantir que ces requêtes de vérification passent sans mise en cache.
-
- 
-
-
Si `/.well-known/*` est trop générique, vous pouvez le restreindre à au moins 2 comportements pour Vercel :
- `/.well-known/vercel/*` - Requis pour la vérification de domaine Vercel
@@ -149,10 +113,6 @@ Créez un comportement avec un **Path pattern** défini sur le sous-chemin de vo
CloudFront n'autorise que les requêtes `GET` et `HEAD` par défaut. Si vous n'autorisez pas toutes les méthodes HTTP, CloudFront rejette les requêtes `POST` que Mintlify utilise pour les analytiques, et votre tableau de bord n'affichera aucune vue de page même si votre documentation se charge normalement.
-
- 
-
-
-
+
Une branche pointe vers un commit spécifique dans votre référentiel. Votre documentation en production est générée à partir d'une branche de déploiement. Vous pouvez avoir autant d'autres branches que vous voulez, contenant des modifications qui ne sont pas encore publiées dans votre documentation en production. Si vous voulez intégrer les modifications d'une branche dans votre documentation en production, vous pouvez fusionner la branche dans votre branche de déploiement via une pull request (demande de fusion).
Utilisez les branches pour travailler sur des modifications sans affecter votre documentation en production, expérimenter en toute sécurité de nouvelles fonctionnalités et obtenir des revues avant la publication.
-
+
Téléchargez une copie complète d'un référentiel sur votre ordinateur, incluant tous les fichiers et l'historique complet. Lorsque vous clonez, vous obtenez tout ce dont vous avez besoin pour travailler en local.
```bash
@@ -74,27 +74,27 @@ Si vous découvrez totalement Git et le contrôle de version, voici un parcours
```
-
+
Un instantané enregistré de vos modifications à un moment donné. Chaque commit inclut un message décrivant ce qui a changé et crée une trace permanente dans l'historique de votre projet.
-
+
Se produit lorsque deux personnes modifient différemment la même partie d'un fichier. Git vous demande de choisir manuellement quelle modification conserver ou de combiner les deux.
-
+
La branche principale de votre projet. Les modifications apportées à cette branche sont automatiquement publiées sur votre site de documentation. Souvent appelée `main`, mais vous pouvez définir n'importe quelle branche comme votre branche de déploiement.
-
+
Un diff (ou différence) montre les modifications entre deux versions d'un fichier. Lors de l'examen de pull requests (demandes de fusion), les diffs mettent en évidence ce qui est différent par rapport à la version d'origine du fichier.
-
+
Combinez les modifications d'une branche dans une autre. Généralement effectué via une pull request (demande de fusion) après revue pour intégrer un travail sur des fonctionnalités dans votre branche de déploiement.
-
+
Récupérez les dernières modifications depuis le référentiel distant vers votre copie locale. Vous permet de rester à jour avec le travail des autres.
```bash
@@ -102,11 +102,11 @@ Si vous découvrez totalement Git et le contrôle de version, voici un parcours
```
-
+
Un moyen de proposer la fusion des modifications d'une branche dans votre documentation en production. Permet la revue et la discussion avant que les modifications ne soient mises en ligne. Couramment appelée PR, et aussi appelée merge request dans GitLab.
-
+
Envoyez vos commits locaux vers le référentiel distant. Cela rend vos modifications disponibles pour les autres et peut déclencher des déploiements automatiques.
```bash
@@ -114,15 +114,15 @@ Si vous découvrez totalement Git et le contrôle de version, voici un parcours
```
-
+
Une version de votre référentiel hébergée sur un serveur. Votre référentiel local se connecte à un référentiel distant pour pousser et récupérer des modifications.
-
+
Le code source de votre documentation, avec tous les fichiers et leur historique, qui composent les pages de votre site de documentation. L'éditeur en ligne se connecte à votre référentiel de documentation pour accéder au contenu et le modifier.
-
+
Préparez des modifications spécifiques à inclure dans votre prochain commit. Le staging vous permet d'organiser les modifications en commits logiques.
```bash
diff --git a/fr/integrations/analytics/google-analytics.mdx b/fr/integrations/analytics/google-analytics.mdx
index 0c52d6802d..1a0585d568 100644
--- a/fr/integrations/analytics/google-analytics.mdx
+++ b/fr/integrations/analytics/google-analytics.mdx
@@ -20,8 +20,6 @@ Vous devez créer un flux Web pour obtenir l’ID de mesure à renseigner dans M
Cliquez sur l’icône d’engrenage en bas à gauche de l’interface Google Analytics, puis cliquez sur Data Streams.
-
-
Créez un flux Web et indiquez l’URL de votre site de documentation Mintlify comme URL du flux.
Votre ID de mesure ressemble à `G-XXXXXXX` et s’affiche sous Stream Details immédiatement après la création du flux Web.
diff --git a/fr/integrations/privacy/osano.mdx b/fr/integrations/privacy/osano.mdx
index 08aa7dcc75..ef51f87a6c 100644
--- a/fr/integrations/privacy/osano.mdx
+++ b/fr/integrations/privacy/osano.mdx
@@ -11,7 +11,7 @@ Ajoutez la gestion du consentement aux cookies [Osano](https://www.osano.com/)
## Configuration
-Créez un fichier `osano.js` n'importe où dans votre répertoire de contenu avec le contenu suivant. Mintlify inclut automatiquement tout fichier `.js` de votre répertoire de contenu sur chaque page.
+Créez un fichier `osano.js` dans votre répertoire de contenu avec le contenu suivant.
### Votre sous-chemin avec caractère générique
@@ -193,19 +153,10 @@ Créez un comportement avec un **Path pattern** de `/_mintlify/*` et des **Origi
Modifiez le comportement `Default (*)`.
-
- 
-
-
1. Modifiez le paramètre **Origin and origin groups** du comportement par défaut pour utiliser l’URL d’environnement de préproduction (dans notre cas `mintlify-landing-page.vercel.app`).
+2. Cliquez sur **Save changes**.
-
- 
-
-
-2. Cliquez sur **Enregistrer les modifications**.
-
-
+
- Si vous n’avez pas de compte Mintlify, inscrivez-vous sur [dashboard.mintlify.com/signup](https://dashboard.mintlify.com/signup).
+ Si vous n’avez pas de compte Mintlify, inscrivez-vous sur [app.mintlify.com/signup](https://app.mintlify.com/signup).
@@ -67,13 +67,7 @@ Ce guide vous accompagne pour configurer un projet Mintlify headless à partir d
1. Sur la page [Git settings](https://app.mintlify.com/settings/project/git-settings), sélectionnez le référentiel que vous avez créé à partir du template de démarrage.
2. Activez l’option **Set up as monorepo**.
3. Saisissez `/docs` comme chemin vers le répertoire contenant votre fichier `docs.json`.
- 4. Cliquez sur **Enregistrer les modifications**.
-
-
-
-
-
-
+ 4. Cliquez sur **Save changes**.
@@ -84,9 +78,9 @@ Ce guide vous accompagne pour configurer un projet Mintlify headless à partir d
PUBLIC_MINTLIFY_ASSISTANT_KEY=your-assistant-api-key
```
- Votre sous-domaine correspond au nom de domaine de votre projet. C’est la partie de l’URL de votre tableau de bord après le nom de l’organisation. Par exemple, si l’URL de votre tableau de bord est `https://dashboard.mintlify.com/org-name/domain-name`, votre sous-domaine est `domain-name`.
+ Votre sous-domaine correspond au nom de domaine de votre projet. C’est la partie de l’URL de votre tableau de bord après le nom de l’organisation. Par exemple, si l’URL de votre tableau de bord est `https://app.mintlify.com/org-name/domain-name`, votre sous-domaine est `domain-name`.
- Générez une clé d’API de l’Assistant sur la page [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de votre tableau de bord. La clé d’API de l’Assistant commence par `mint_dsc_`.
+ Générez une clé d’API de l’Assistant sur la page [API keys](https://app.mintlify.com/settings/organization/api-keys) de votre tableau de bord. La clé d’API de l’Assistant commence par `mint_dsc_`.
diff --git a/fr/guides/git-concepts.mdx b/fr/guides/git-concepts.mdx
index a1d0097817..2c9d9cb13a 100644
--- a/fr/guides/git-concepts.mdx
+++ b/fr/guides/git-concepts.mdx
@@ -60,13 +60,13 @@ Si vous découvrez totalement Git et le contrôle de version, voici un parcours
### Vérifiez que les comportements sont correctement configurés
@@ -226,10 +177,6 @@ Confirmez que chaque comportement pointe vers la bonne origine : l'URL en `.mint
Pour tester votre distribution, accédez à l’onglet « General » et ouvrez l’URL **Distribution domain name**.
-
- 
-
-
Toutes les pages devraient être acheminées vers votre page d’accueil principale. Lorsque vous ajoutez le sous-chemin de votre choix, par exemple `/docs`, l’URL devrait servir votre documentation Mintlify.
@@ -265,17 +212,7 @@ Commencez par ajouter votre domaine à la distribution CloudFront. Sans nom de d
1. Accédez à [Route 53](https://aws.amazon.com/route53) dans la console AWS.
2. Accédez à la « Hosted zone » de votre domaine principal.
3. Sélectionnez **Create record**.
-
-
- 
-
-
4. Activez `Alias`, puis, pour **Route traffic to**, choisissez l’option `Alias to CloudFront distribution`.
-
-
- 
-
-
5. Sélectionnez **Create records**.
diff --git a/fr/guides/custom-frontend.mdx b/fr/guides/custom-frontend.mdx
index 003398a003..f805d13e45 100644
--- a/fr/guides/custom-frontend.mdx
+++ b/fr/guides/custom-frontend.mdx
@@ -39,7 +39,7 @@ Ce guide vous accompagne pour configurer un projet Mintlify headless à partir d
## Prérequis
-* Un [compte Mintlify](https://dashboard.mintlify.com)
+* Un [compte Mintlify](https://app.mintlify.com)
* Un [compte GitHub](https://github.com)
* [Node.js](https://nodejs.org) v20.17.0 ou version ultérieure (versions LTS recommandées)
* Des connaissances de base en [Astro](https://docs.astro.build)
@@ -56,7 +56,7 @@ Ce guide vous accompagne pour configurer un projet Mintlify headless à partir d
-
-
-
+ 4. Cliquez sur **Save changes**.
-
-
-
-
-
-
## Gérer les retours
-Vous pouvez définir le statut d'un retour et ajouter des notes internes pour suivre votre travail de traitement des retours des utilisateurs. Pour analyser les retours en dehors du tableau de bord, [exportez-les au format CSV](/fr/analytics/export) depuis la page analytics.
+Vous pouvez définir le statut d'un retour et ajouter des notes internes pour suivre votre travail de traitement des retours des utilisateurs. Pour analyser les retours en dehors du tableau de bord, [exportez-les au format CSV](/fr/analytics/export).
### Modifier le statut d'un retour
diff --git a/fr/optimize/search.mdx b/fr/optimize/search.mdx
index 3f976c18d1..7aa3fe388b 100644
--- a/fr/optimize/search.mdx
+++ b/fr/optimize/search.mdx
@@ -116,19 +116,6 @@ Contrôlez le nombre de résultats que la barre de recherche renvoie par requêt
Accédez à la page de paramètres [Général](https://app.mintlify.com/settings/project/general) dans votre dashboard. Dans la section "Recherche", définissez **Results per query** sur la valeur souhaitée.
-
-
-
-
-
Des valeurs plus élevées font apparaître davantage de correspondances par requête, ce qui est utile pour les sites avec une couverture thématique large où les utilisateurs s'attendent à examiner de nombreux candidats. Des valeurs plus basses gardent le panneau de résultats compact et orientent les utilisateurs vers la correspondance la mieux classée.
-
-
-
Des valeurs plus élevées font apparaître davantage de correspondances par requête, ce qui est utile pour les sites avec une couverture thématique large où les utilisateurs s'attendent à examiner de nombreux candidats. Des valeurs plus basses gardent le panneau de résultats compact et orientent les utilisateurs vers la correspondance la mieux classée.
diff --git a/guides/custom-frontend.mdx b/guides/custom-frontend.mdx
index 2807445ddb..d19d2fea1e 100644
--- a/guides/custom-frontend.mdx
+++ b/guides/custom-frontend.mdx
@@ -64,19 +64,6 @@ This guide walks you through setting up a headless Mintlify project with the sta
2. Enable the **Set up as monorepo** toggle.
3. Enter `/docs` as the path to the directory containing your `docs.json` file.
4. Click **Save changes**.
-
-
-
-
-
diff --git a/images/agent/dashboard-dark.png b/images/agent/dashboard-dark.png
deleted file mode 100644
index d1aab61f86..0000000000
Binary files a/images/agent/dashboard-dark.png and /dev/null differ
diff --git a/images/agent/dashboard-light.png b/images/agent/dashboard-light.png
deleted file mode 100644
index d025c8d6e9..0000000000
Binary files a/images/agent/dashboard-light.png and /dev/null differ
diff --git a/images/agent/views-dark.png b/images/agent/views-dark.png
deleted file mode 100644
index f88bca7a28..0000000000
Binary files a/images/agent/views-dark.png and /dev/null differ
diff --git a/images/agent/views-light.png b/images/agent/views-light.png
deleted file mode 100644
index 76417b3d4d..0000000000
Binary files a/images/agent/views-light.png and /dev/null differ
diff --git a/images/analytics/export-to-csv-dark.png b/images/analytics/export-to-csv-dark.png
deleted file mode 100644
index 074ab6d17a..0000000000
Binary files a/images/analytics/export-to-csv-dark.png and /dev/null differ
diff --git a/images/analytics/export-to-csv-light.png b/images/analytics/export-to-csv-light.png
deleted file mode 100644
index b21383d41d..0000000000
Binary files a/images/analytics/export-to-csv-light.png and /dev/null differ
diff --git a/images/analytics/feedback-addons-dark.png b/images/analytics/feedback-addons-dark.png
deleted file mode 100644
index c03638e3fb..0000000000
Binary files a/images/analytics/feedback-addons-dark.png and /dev/null differ
diff --git a/images/analytics/feedback-addons-light.png b/images/analytics/feedback-addons-light.png
deleted file mode 100644
index fe3fc5ca8f..0000000000
Binary files a/images/analytics/feedback-addons-light.png and /dev/null differ
diff --git a/images/analytics/range-selector-dark.png b/images/analytics/range-selector-dark.png
deleted file mode 100644
index f0e686f494..0000000000
Binary files a/images/analytics/range-selector-dark.png and /dev/null differ
diff --git a/images/analytics/range-selector-light.png b/images/analytics/range-selector-light.png
deleted file mode 100644
index 8d1ee97fb2..0000000000
Binary files a/images/analytics/range-selector-light.png and /dev/null differ
diff --git a/images/anchors-autogeneration-anchors.png b/images/anchors-autogeneration-anchors.png
deleted file mode 100644
index a2a8e0828f..0000000000
Binary files a/images/anchors-autogeneration-anchors.png and /dev/null differ
diff --git a/images/assistant/connected-apps-dark.png b/images/assistant/connected-apps-dark.png
deleted file mode 100644
index ecccb47ceb..0000000000
Binary files a/images/assistant/connected-apps-dark.png and /dev/null differ
diff --git a/images/assistant/connected-apps-light.png b/images/assistant/connected-apps-light.png
deleted file mode 100644
index 8593f935ed..0000000000
Binary files a/images/assistant/connected-apps-light.png and /dev/null differ
diff --git a/images/assistant/deflection-dark.png b/images/assistant/deflection-dark.png
deleted file mode 100644
index dd6a2ff61b..0000000000
Binary files a/images/assistant/deflection-dark.png and /dev/null differ
diff --git a/images/assistant/deflection-light.png b/images/assistant/deflection-light.png
deleted file mode 100644
index 2c6dc44737..0000000000
Binary files a/images/assistant/deflection-light.png and /dev/null differ
diff --git a/images/assistant/discord-configure-dark.png b/images/assistant/discord-configure-dark.png
deleted file mode 100644
index 9ed4f1a28f..0000000000
Binary files a/images/assistant/discord-configure-dark.png and /dev/null differ
diff --git a/images/assistant/discord-configure-light.png b/images/assistant/discord-configure-light.png
deleted file mode 100644
index 4d417f97f4..0000000000
Binary files a/images/assistant/discord-configure-light.png and /dev/null differ
diff --git a/images/assistant/highlight-dark.png b/images/assistant/highlight-dark.png
deleted file mode 100644
index 37d61bd455..0000000000
Binary files a/images/assistant/highlight-dark.png and /dev/null differ
diff --git a/images/assistant/highlight-light.png b/images/assistant/highlight-light.png
deleted file mode 100644
index 3ad65840a5..0000000000
Binary files a/images/assistant/highlight-light.png and /dev/null differ
diff --git a/images/assistant/image-attach-dark.png b/images/assistant/image-attach-dark.png
deleted file mode 100644
index 66290fff85..0000000000
Binary files a/images/assistant/image-attach-dark.png and /dev/null differ
diff --git a/images/assistant/image-attach-light.png b/images/assistant/image-attach-light.png
deleted file mode 100644
index c8ba69d6e0..0000000000
Binary files a/images/assistant/image-attach-light.png and /dev/null differ
diff --git a/images/assistant/placement-dark.png b/images/assistant/placement-dark.png
deleted file mode 100644
index 02f6767093..0000000000
Binary files a/images/assistant/placement-dark.png and /dev/null differ
diff --git a/images/assistant/placement-light.png b/images/assistant/placement-light.png
deleted file mode 100644
index f899938b9f..0000000000
Binary files a/images/assistant/placement-light.png and /dev/null differ
diff --git a/images/assistant/search-domains-dark.png b/images/assistant/search-domains-dark.png
deleted file mode 100644
index 287c023c6f..0000000000
Binary files a/images/assistant/search-domains-dark.png and /dev/null differ
diff --git a/images/assistant/search-domains-light.png b/images/assistant/search-domains-light.png
deleted file mode 100644
index 5ac02f6a33..0000000000
Binary files a/images/assistant/search-domains-light.png and /dev/null differ
diff --git a/images/assistant/slack-configure-dark.png b/images/assistant/slack-configure-dark.png
deleted file mode 100644
index 9775093af4..0000000000
Binary files a/images/assistant/slack-configure-dark.png and /dev/null differ
diff --git a/images/assistant/slack-configure-light.png b/images/assistant/slack-configure-light.png
deleted file mode 100644
index 1cb2e4d7a0..0000000000
Binary files a/images/assistant/slack-configure-light.png and /dev/null differ
diff --git a/images/assistant/status-dark.png b/images/assistant/status-dark.png
deleted file mode 100644
index 43979b3ef3..0000000000
Binary files a/images/assistant/status-dark.png and /dev/null differ
diff --git a/images/assistant/status-light.png b/images/assistant/status-light.png
deleted file mode 100644
index 1a8dd29240..0000000000
Binary files a/images/assistant/status-light.png and /dev/null differ
diff --git a/images/autogeneration-with-tabs.png b/images/autogeneration-with-tabs.png
deleted file mode 100644
index 6f56988279..0000000000
Binary files a/images/autogeneration-with-tabs.png and /dev/null differ
diff --git a/images/changelog/landing-page.jpeg b/images/changelog/landing-page.jpeg
deleted file mode 100644
index 80af7a2823..0000000000
Binary files a/images/changelog/landing-page.jpeg and /dev/null differ
diff --git a/images/checks-passed.png b/images/checks-passed.png
deleted file mode 100644
index 3303c77364..0000000000
Binary files a/images/checks-passed.png and /dev/null differ
diff --git a/images/claude-mcp.png b/images/claude-mcp.png
deleted file mode 100644
index b8b6bf51e1..0000000000
Binary files a/images/claude-mcp.png and /dev/null differ
diff --git a/images/cli/mint-test-scope.png b/images/cli/mint-test-scope.png
deleted file mode 100644
index 506dd1c817..0000000000
Binary files a/images/cli/mint-test-scope.png and /dev/null differ
diff --git a/images/clone-repository.png b/images/clone-repository.png
deleted file mode 100644
index e2ac8e78b0..0000000000
Binary files a/images/clone-repository.png and /dev/null differ
diff --git a/images/cloudflare/custom-domain.png b/images/cloudflare/custom-domain.png
deleted file mode 100644
index f91b2bf821..0000000000
Binary files a/images/cloudflare/custom-domain.png and /dev/null differ
diff --git a/images/cloudflare/edit-code.png b/images/cloudflare/edit-code.png
deleted file mode 100644
index 672c132287..0000000000
Binary files a/images/cloudflare/edit-code.png and /dev/null differ
diff --git a/images/cloudflare/worker.png b/images/cloudflare/worker.png
deleted file mode 100644
index c1ebf35674..0000000000
Binary files a/images/cloudflare/worker.png and /dev/null differ
diff --git a/images/cloudfront/all-behaviors.png b/images/cloudfront/all-behaviors.png
deleted file mode 100644
index 762c11f876..0000000000
Binary files a/images/cloudfront/all-behaviors.png and /dev/null differ
diff --git a/images/cloudfront/behavior-1.png b/images/cloudfront/behavior-1.png
deleted file mode 100644
index 329b9dc91a..0000000000
Binary files a/images/cloudfront/behavior-1.png and /dev/null differ
diff --git a/images/cloudfront/behavior-2.png b/images/cloudfront/behavior-2.png
deleted file mode 100644
index 6bb2d49495..0000000000
Binary files a/images/cloudfront/behavior-2.png and /dev/null differ
diff --git a/images/cloudfront/behaviors.png b/images/cloudfront/behaviors.png
deleted file mode 100644
index a249722656..0000000000
Binary files a/images/cloudfront/behaviors.png and /dev/null differ
diff --git a/images/cloudfront/caching-policy.png b/images/cloudfront/caching-policy.png
deleted file mode 100644
index 7a054482a4..0000000000
Binary files a/images/cloudfront/caching-policy.png and /dev/null differ
diff --git a/images/cloudfront/create-distribution.png b/images/cloudfront/create-distribution.png
deleted file mode 100644
index cc4e4c7c69..0000000000
Binary files a/images/cloudfront/create-distribution.png and /dev/null differ
diff --git a/images/cloudfront/create-record-alias.png b/images/cloudfront/create-record-alias.png
deleted file mode 100644
index 99326de54c..0000000000
Binary files a/images/cloudfront/create-record-alias.png and /dev/null differ
diff --git a/images/cloudfront/default-behavior-1.png b/images/cloudfront/default-behavior-1.png
deleted file mode 100644
index 4f0b083911..0000000000
Binary files a/images/cloudfront/default-behavior-1.png and /dev/null differ
diff --git a/images/cloudfront/default-behavior-2.png b/images/cloudfront/default-behavior-2.png
deleted file mode 100644
index 909a683fe8..0000000000
Binary files a/images/cloudfront/default-behavior-2.png and /dev/null differ
diff --git a/images/cloudfront/default-origin.png b/images/cloudfront/default-origin.png
deleted file mode 100644
index 1079f68163..0000000000
Binary files a/images/cloudfront/default-origin.png and /dev/null differ
diff --git a/images/cloudfront/enable-security-protections.png b/images/cloudfront/enable-security-protections.png
deleted file mode 100644
index bf0a000071..0000000000
Binary files a/images/cloudfront/enable-security-protections.png and /dev/null differ
diff --git a/images/cloudfront/final-origins.png b/images/cloudfront/final-origins.png
deleted file mode 100644
index bbd89d2d6c..0000000000
Binary files a/images/cloudfront/final-origins.png and /dev/null differ
diff --git a/images/cloudfront/origin-name.png b/images/cloudfront/origin-name.png
deleted file mode 100644
index 8a4e9a2874..0000000000
Binary files a/images/cloudfront/origin-name.png and /dev/null differ
diff --git a/images/cloudfront/origin-request-policy.png b/images/cloudfront/origin-request-policy.png
deleted file mode 100644
index 85faf76f3c..0000000000
Binary files a/images/cloudfront/origin-request-policy.png and /dev/null differ
diff --git a/images/cloudfront/origins.png b/images/cloudfront/origins.png
deleted file mode 100644
index c2dc2ef92a..0000000000
Binary files a/images/cloudfront/origins.png and /dev/null differ
diff --git a/images/cloudfront/preview-distribution.png b/images/cloudfront/preview-distribution.png
deleted file mode 100644
index ca421efd62..0000000000
Binary files a/images/cloudfront/preview-distribution.png and /dev/null differ
diff --git a/images/cloudfront/route53-create-record.png b/images/cloudfront/route53-create-record.png
deleted file mode 100644
index 564668e095..0000000000
Binary files a/images/cloudfront/route53-create-record.png and /dev/null differ
diff --git a/images/cloudfront/well-known-policy.png b/images/cloudfront/well-known-policy.png
deleted file mode 100644
index 1aff4b52ad..0000000000
Binary files a/images/cloudfront/well-known-policy.png and /dev/null differ
diff --git a/images/contextual-menu/contextual-menu.png b/images/contextual-menu/contextual-menu.png
deleted file mode 100644
index a97d5664ad..0000000000
Binary files a/images/contextual-menu/contextual-menu.png and /dev/null differ
diff --git a/images/convert-oas-3.png b/images/convert-oas-3.png
deleted file mode 100644
index 0bbd2fd76d..0000000000
Binary files a/images/convert-oas-3.png and /dev/null differ
diff --git a/images/custom-domain.png b/images/custom-domain.png
deleted file mode 100644
index 5a62071adc..0000000000
Binary files a/images/custom-domain.png and /dev/null differ
diff --git a/images/deployments/add-repository-dark.png b/images/deployments/add-repository-dark.png
deleted file mode 100644
index 1ccd6974d7..0000000000
Binary files a/images/deployments/add-repository-dark.png and /dev/null differ
diff --git a/images/deployments/add-repository-light.png b/images/deployments/add-repository-light.png
deleted file mode 100644
index 6d65f04230..0000000000
Binary files a/images/deployments/add-repository-light.png and /dev/null differ
diff --git a/images/dropdowns-dark.png b/images/dropdowns-dark.png
deleted file mode 100644
index af74e63a52..0000000000
Binary files a/images/dropdowns-dark.png and /dev/null differ
diff --git a/images/dropdowns-light.png b/images/dropdowns-light.png
deleted file mode 100644
index 30a96b4075..0000000000
Binary files a/images/dropdowns-light.png and /dev/null differ
diff --git a/images/edit-online.png b/images/edit-online.png
deleted file mode 100644
index 1a8e9cf262..0000000000
Binary files a/images/edit-online.png and /dev/null differ
diff --git a/images/editor-gate.png b/images/editor-gate.png
deleted file mode 100644
index d5296301b6..0000000000
Binary files a/images/editor-gate.png and /dev/null differ
diff --git a/images/editor/add-existing-file-menu-dark.png b/images/editor/add-existing-file-menu-dark.png
deleted file mode 100644
index 1641415bf4..0000000000
Binary files a/images/editor/add-existing-file-menu-dark.png and /dev/null differ
diff --git a/images/editor/add-existing-file-menu-light.png b/images/editor/add-existing-file-menu-light.png
deleted file mode 100644
index 50ef521841..0000000000
Binary files a/images/editor/add-existing-file-menu-light.png and /dev/null differ
diff --git a/images/editor/assets-dark.png b/images/editor/assets-dark.png
deleted file mode 100644
index a989df32a5..0000000000
Binary files a/images/editor/assets-dark.png and /dev/null differ
diff --git a/images/editor/assets-light.png b/images/editor/assets-light.png
deleted file mode 100644
index afbcbcaf2d..0000000000
Binary files a/images/editor/assets-light.png and /dev/null differ
diff --git a/images/editor/block-actions-dark.png b/images/editor/block-actions-dark.png
deleted file mode 100644
index acdc83e1ad..0000000000
Binary files a/images/editor/block-actions-dark.png and /dev/null differ
diff --git a/images/editor/block-actions-light.png b/images/editor/block-actions-light.png
deleted file mode 100644
index 0f22dd4e08..0000000000
Binary files a/images/editor/block-actions-light.png and /dev/null differ
diff --git a/images/editor/configurations-dark.png b/images/editor/configurations-dark.png
deleted file mode 100644
index ca32529795..0000000000
Binary files a/images/editor/configurations-dark.png and /dev/null differ
diff --git a/images/editor/configurations-light.png b/images/editor/configurations-light.png
deleted file mode 100644
index db480fbc18..0000000000
Binary files a/images/editor/configurations-light.png and /dev/null differ
diff --git a/images/editor/delete-page-dark.png b/images/editor/delete-page-dark.png
deleted file mode 100644
index bbec02d6d1..0000000000
Binary files a/images/editor/delete-page-dark.png and /dev/null differ
diff --git a/images/editor/delete-page-light.png b/images/editor/delete-page-light.png
deleted file mode 100644
index 8d5d2b9c08..0000000000
Binary files a/images/editor/delete-page-light.png and /dev/null differ
diff --git a/images/editor/deployment-selector-dark.png b/images/editor/deployment-selector-dark.png
deleted file mode 100644
index 2d90e611aa..0000000000
Binary files a/images/editor/deployment-selector-dark.png and /dev/null differ
diff --git a/images/editor/deployment-selector-light.png b/images/editor/deployment-selector-light.png
deleted file mode 100644
index 9232b343d1..0000000000
Binary files a/images/editor/deployment-selector-light.png and /dev/null differ
diff --git a/images/editor/editor-dark.png b/images/editor/editor-dark.png
deleted file mode 100644
index 76fa43fce8..0000000000
Binary files a/images/editor/editor-dark.png and /dev/null differ
diff --git a/images/editor/editor-light.png b/images/editor/editor-light.png
deleted file mode 100644
index a490b8f735..0000000000
Binary files a/images/editor/editor-light.png and /dev/null differ
diff --git a/images/editor/mode-toggle-dark.png b/images/editor/mode-toggle-dark.png
deleted file mode 100644
index 7901985097..0000000000
Binary files a/images/editor/mode-toggle-dark.png and /dev/null differ
diff --git a/images/editor/mode-toggle-light.png b/images/editor/mode-toggle-light.png
deleted file mode 100644
index a9248c55c0..0000000000
Binary files a/images/editor/mode-toggle-light.png and /dev/null differ
diff --git a/images/editor/navigation-dark.png b/images/editor/navigation-dark.png
deleted file mode 100644
index 6215f92dac..0000000000
Binary files a/images/editor/navigation-dark.png and /dev/null differ
diff --git a/images/editor/navigation-light.png b/images/editor/navigation-light.png
deleted file mode 100644
index c93fae7c98..0000000000
Binary files a/images/editor/navigation-light.png and /dev/null differ
diff --git a/images/editor/page-settings-dark.png b/images/editor/page-settings-dark.png
deleted file mode 100644
index de1b88002d..0000000000
Binary files a/images/editor/page-settings-dark.png and /dev/null differ
diff --git a/images/editor/page-settings-light.png b/images/editor/page-settings-light.png
deleted file mode 100644
index 18c2a4d6e5..0000000000
Binary files a/images/editor/page-settings-light.png and /dev/null differ
diff --git a/images/editor/redirects-dark.png b/images/editor/redirects-dark.png
deleted file mode 100644
index 077c8bf106..0000000000
Binary files a/images/editor/redirects-dark.png and /dev/null differ
diff --git a/images/editor/redirects-light.png b/images/editor/redirects-light.png
deleted file mode 100644
index 294a6e9ea3..0000000000
Binary files a/images/editor/redirects-light.png and /dev/null differ
diff --git a/images/editor/reply-dark.png b/images/editor/reply-dark.png
deleted file mode 100644
index b070952652..0000000000
Binary files a/images/editor/reply-dark.png and /dev/null differ
diff --git a/images/editor/reply-light.png b/images/editor/reply-light.png
deleted file mode 100644
index 8d8cc16cc0..0000000000
Binary files a/images/editor/reply-light.png and /dev/null differ
diff --git a/images/editor/resolve-dark.png b/images/editor/resolve-dark.png
deleted file mode 100644
index 764aa05f9e..0000000000
Binary files a/images/editor/resolve-dark.png and /dev/null differ
diff --git a/images/editor/resolve-light.png b/images/editor/resolve-light.png
deleted file mode 100644
index 02a95b9984..0000000000
Binary files a/images/editor/resolve-light.png and /dev/null differ
diff --git a/images/editor/share-preview-dark.png b/images/editor/share-preview-dark.png
deleted file mode 100644
index 155b13c3be..0000000000
Binary files a/images/editor/share-preview-dark.png and /dev/null differ
diff --git a/images/editor/share-preview-light.png b/images/editor/share-preview-light.png
deleted file mode 100644
index 76e24bd038..0000000000
Binary files a/images/editor/share-preview-light.png and /dev/null differ
diff --git a/images/editor/suggesting-dark.png b/images/editor/suggesting-dark.png
deleted file mode 100644
index a40c6c3789..0000000000
Binary files a/images/editor/suggesting-dark.png and /dev/null differ
diff --git a/images/editor/suggesting-light.png b/images/editor/suggesting-light.png
deleted file mode 100644
index 2fea05224b..0000000000
Binary files a/images/editor/suggesting-light.png and /dev/null differ
diff --git a/images/editor/toolbar-branch-dark.png b/images/editor/toolbar-branch-dark.png
deleted file mode 100644
index 22b01ed6ca..0000000000
Binary files a/images/editor/toolbar-branch-dark.png and /dev/null differ
diff --git a/images/editor/toolbar-branch-light.png b/images/editor/toolbar-branch-light.png
deleted file mode 100644
index 358958f95d..0000000000
Binary files a/images/editor/toolbar-branch-light.png and /dev/null differ
diff --git a/images/editor/toolbar-dark.png b/images/editor/toolbar-dark.png
deleted file mode 100644
index fd4926e56e..0000000000
Binary files a/images/editor/toolbar-dark.png and /dev/null differ
diff --git a/images/editor/toolbar-light.png b/images/editor/toolbar-light.png
deleted file mode 100644
index 7d228419e5..0000000000
Binary files a/images/editor/toolbar-light.png and /dev/null differ
diff --git a/images/elevenlabs-mdx-autogeneration-example.png b/images/elevenlabs-mdx-autogeneration-example.png
deleted file mode 100644
index 1f5f95f7bf..0000000000
Binary files a/images/elevenlabs-mdx-autogeneration-example.png and /dev/null differ
diff --git a/images/external-api-key.png b/images/external-api-key.png
deleted file mode 100644
index dcb96a1367..0000000000
Binary files a/images/external-api-key.png and /dev/null differ
diff --git a/images/ga4-web-streams.png b/images/ga4-web-streams.png
deleted file mode 100644
index d3225b0325..0000000000
Binary files a/images/ga4-web-streams.png and /dev/null differ
diff --git a/images/generate-discovery-api-key.png b/images/generate-discovery-api-key.png
deleted file mode 100644
index 37cf7ac84c..0000000000
Binary files a/images/generate-discovery-api-key.png and /dev/null differ
diff --git a/images/github-bot-verification.png b/images/github-bot-verification.png
deleted file mode 100644
index 88f2853705..0000000000
Binary files a/images/github-bot-verification.png and /dev/null differ
diff --git a/images/github/app-repos-dark.png b/images/github/app-repos-dark.png
deleted file mode 100644
index 517e108a2f..0000000000
Binary files a/images/github/app-repos-dark.png and /dev/null differ
diff --git a/images/github/app-repos-light.png b/images/github/app-repos-light.png
deleted file mode 100644
index 1a13088ceb..0000000000
Binary files a/images/github/app-repos-light.png and /dev/null differ
diff --git a/images/github/revalidate-settings-dark.png b/images/github/revalidate-settings-dark.png
deleted file mode 100644
index 1cc5899673..0000000000
Binary files a/images/github/revalidate-settings-dark.png and /dev/null differ
diff --git a/images/github/revalidate-settings-light.png b/images/github/revalidate-settings-light.png
deleted file mode 100644
index 863dd4a938..0000000000
Binary files a/images/github/revalidate-settings-light.png and /dev/null differ
diff --git a/images/github/select-repos.png b/images/github/select-repos.png
deleted file mode 100644
index f6571027d5..0000000000
Binary files a/images/github/select-repos.png and /dev/null differ
diff --git a/images/gitlab/gitlab-project-access-token.png b/images/gitlab/gitlab-project-access-token.png
deleted file mode 100644
index 74f5607780..0000000000
Binary files a/images/gitlab/gitlab-project-access-token.png and /dev/null differ
diff --git a/images/gitlab/gitlab-project-id.png b/images/gitlab/gitlab-project-id.png
deleted file mode 100644
index b657039391..0000000000
Binary files a/images/gitlab/gitlab-project-id.png and /dev/null differ
diff --git a/images/gitlab/gitlab-project-webtoken-test.png b/images/gitlab/gitlab-project-webtoken-test.png
deleted file mode 100644
index 07b20a87f1..0000000000
Binary files a/images/gitlab/gitlab-project-webtoken-test.png and /dev/null differ
diff --git a/images/gitlab/gitlab-project-webtoken.png b/images/gitlab/gitlab-project-webtoken.png
deleted file mode 100644
index 4846e57742..0000000000
Binary files a/images/gitlab/gitlab-project-webtoken.png and /dev/null differ
diff --git a/images/gitlab/gitlab-webhook.png b/images/gitlab/gitlab-webhook.png
deleted file mode 100644
index 730c45a661..0000000000
Binary files a/images/gitlab/gitlab-webhook.png and /dev/null differ
diff --git a/images/gitlab/show-webtoken-dark.png b/images/gitlab/show-webtoken-dark.png
deleted file mode 100644
index 99ad5b8ae5..0000000000
Binary files a/images/gitlab/show-webtoken-dark.png and /dev/null differ
diff --git a/images/gitlab/show-webtoken-light.png b/images/gitlab/show-webtoken-light.png
deleted file mode 100644
index f0b041c1f4..0000000000
Binary files a/images/gitlab/show-webtoken-light.png and /dev/null differ
diff --git a/images/gsuite-add-custom-saml-app.png b/images/gsuite-add-custom-saml-app.png
deleted file mode 100644
index bd2cd1dcde..0000000000
Binary files a/images/gsuite-add-custom-saml-app.png and /dev/null differ
diff --git a/images/gsuite-saml-metadata.png b/images/gsuite-saml-metadata.png
deleted file mode 100644
index f13749eefe..0000000000
Binary files a/images/gsuite-saml-metadata.png and /dev/null differ
diff --git a/images/gsuite-sp-details.png b/images/gsuite-sp-details.png
deleted file mode 100644
index 8239300dbb..0000000000
Binary files a/images/gsuite-sp-details.png and /dev/null differ
diff --git a/images/guides/astro/repo-settings-dark.png b/images/guides/astro/repo-settings-dark.png
deleted file mode 100644
index 4067693cc1..0000000000
Binary files a/images/guides/astro/repo-settings-dark.png and /dev/null differ
diff --git a/images/guides/astro/repo-settings-light.png b/images/guides/astro/repo-settings-light.png
deleted file mode 100644
index 9c69bd3da2..0000000000
Binary files a/images/guides/astro/repo-settings-light.png and /dev/null differ
diff --git a/images/guides/n8n/create-agent-job-node.png b/images/guides/n8n/create-agent-job-node.png
deleted file mode 100644
index 988fcf9ebe..0000000000
Binary files a/images/guides/n8n/create-agent-job-node.png and /dev/null differ
diff --git a/images/guides/n8n/filter-merged-PRs-node.png b/images/guides/n8n/filter-merged-PRs-node.png
deleted file mode 100644
index 2c521d4e7f..0000000000
Binary files a/images/guides/n8n/filter-merged-PRs-node.png and /dev/null differ
diff --git a/images/guides/n8n/webhook-node.png b/images/guides/n8n/webhook-node.png
deleted file mode 100644
index 536a9766e8..0000000000
Binary files a/images/guides/n8n/webhook-node.png and /dev/null differ
diff --git a/images/guides/n8n/workflow.png b/images/guides/n8n/workflow.png
deleted file mode 100644
index f9fe446c0e..0000000000
Binary files a/images/guides/n8n/workflow.png and /dev/null differ
diff --git a/images/homepage/ai-native.png b/images/homepage/ai-native.png
deleted file mode 100644
index 35884d26f4..0000000000
Binary files a/images/homepage/ai-native.png and /dev/null differ
diff --git a/images/homepage/custom-domain.png b/images/homepage/custom-domain.png
deleted file mode 100644
index e0c348e22e..0000000000
Binary files a/images/homepage/custom-domain.png and /dev/null differ
diff --git a/images/homepage/themes.png b/images/homepage/themes.png
deleted file mode 100644
index e636836f1f..0000000000
Binary files a/images/homepage/themes.png and /dev/null differ
diff --git a/images/integrations/clarity.png b/images/integrations/clarity.png
deleted file mode 100644
index 235ba45239..0000000000
Binary files a/images/integrations/clarity.png and /dev/null differ
diff --git a/images/integrations/osano-managed-rule.png b/images/integrations/osano-managed-rule.png
deleted file mode 100644
index 8bd805b663..0000000000
Binary files a/images/integrations/osano-managed-rule.png and /dev/null differ
diff --git a/images/manual-update.png b/images/manual-update.png
deleted file mode 100644
index 6eedbdfa67..0000000000
Binary files a/images/manual-update.png and /dev/null differ
diff --git a/images/mcp-auth-token.png b/images/mcp-auth-token.png
deleted file mode 100644
index 4c7282cd20..0000000000
Binary files a/images/mcp-auth-token.png and /dev/null differ
diff --git a/images/mcp-dash.png b/images/mcp-dash.png
deleted file mode 100644
index 771a166408..0000000000
Binary files a/images/mcp-dash.png and /dev/null differ
diff --git a/images/mcp-with-claude.png b/images/mcp-with-claude.png
deleted file mode 100644
index 6b3f62764d..0000000000
Binary files a/images/mcp-with-claude.png and /dev/null differ
diff --git a/images/mcp/mcp-server-page-dark.png b/images/mcp/mcp-server-page-dark.png
deleted file mode 100644
index 3baa28764c..0000000000
Binary files a/images/mcp/mcp-server-page-dark.png and /dev/null differ
diff --git a/images/mcp/mcp-server-page-light.png b/images/mcp/mcp-server-page-light.png
deleted file mode 100644
index 65313e97bc..0000000000
Binary files a/images/mcp/mcp-server-page-light.png and /dev/null differ
diff --git a/images/mcp/mcp-terminal-completed.png b/images/mcp/mcp-terminal-completed.png
deleted file mode 100644
index 39f53fbc98..0000000000
Binary files a/images/mcp/mcp-terminal-completed.png and /dev/null differ
diff --git a/images/mcp/mcp-terminal.png b/images/mcp/mcp-terminal.png
deleted file mode 100644
index ee19971d5d..0000000000
Binary files a/images/mcp/mcp-terminal.png and /dev/null differ
diff --git a/images/monorepo.png b/images/monorepo.png
deleted file mode 100644
index 41aaf77531..0000000000
Binary files a/images/monorepo.png and /dev/null differ
diff --git a/images/page-context-menu.png b/images/page-context-menu.png
deleted file mode 100644
index edf37ada53..0000000000
Binary files a/images/page-context-menu.png and /dev/null differ
diff --git a/images/previews/preview-auth-dark.png b/images/previews/preview-auth-dark.png
deleted file mode 100644
index e93923c890..0000000000
Binary files a/images/previews/preview-auth-dark.png and /dev/null differ
diff --git a/images/previews/preview-auth-light.png b/images/previews/preview-auth-light.png
deleted file mode 100644
index af8db5570e..0000000000
Binary files a/images/previews/preview-auth-light.png and /dev/null differ
diff --git a/images/previews/private-preview-dark.png b/images/previews/private-preview-dark.png
deleted file mode 100644
index c72134fc53..0000000000
Binary files a/images/previews/private-preview-dark.png and /dev/null differ
diff --git a/images/previews/private-preview-light.png b/images/previews/private-preview-light.png
deleted file mode 100644
index 43fe7b4a19..0000000000
Binary files a/images/previews/private-preview-light.png and /dev/null differ
diff --git a/images/previews/redeploy-preview-dark.png b/images/previews/redeploy-preview-dark.png
deleted file mode 100644
index 1061b0d2ef..0000000000
Binary files a/images/previews/redeploy-preview-dark.png and /dev/null differ
diff --git a/images/previews/redeploy-preview-light.png b/images/previews/redeploy-preview-light.png
deleted file mode 100644
index 5bfb0c5932..0000000000
Binary files a/images/previews/redeploy-preview-light.png and /dev/null differ
diff --git a/images/quickstart/custom-domain-dark.png b/images/quickstart/custom-domain-dark.png
deleted file mode 100644
index 56ae8ebbc1..0000000000
Binary files a/images/quickstart/custom-domain-dark.png and /dev/null differ
diff --git a/images/quickstart/custom-domain-light.png b/images/quickstart/custom-domain-light.png
deleted file mode 100644
index 325eeb6f8e..0000000000
Binary files a/images/quickstart/custom-domain-light.png and /dev/null differ
diff --git a/images/quickstart/github-app-installation-dark.png b/images/quickstart/github-app-installation-dark.png
deleted file mode 100644
index 95ee2903f5..0000000000
Binary files a/images/quickstart/github-app-installation-dark.png and /dev/null differ
diff --git a/images/quickstart/github-app-installation-light.png b/images/quickstart/github-app-installation-light.png
deleted file mode 100644
index 43a92e2303..0000000000
Binary files a/images/quickstart/github-app-installation-light.png and /dev/null differ
diff --git a/images/quickstart/mintlify-dev-dark.png b/images/quickstart/mintlify-dev-dark.png
deleted file mode 100644
index f6a9f44796..0000000000
Binary files a/images/quickstart/mintlify-dev-dark.png and /dev/null differ
diff --git a/images/quickstart/mintlify-dev-light.png b/images/quickstart/mintlify-dev-light.png
deleted file mode 100644
index 51e43dd0f8..0000000000
Binary files a/images/quickstart/mintlify-dev-light.png and /dev/null differ
diff --git a/images/quickstart/web-editor-dark.png b/images/quickstart/web-editor-dark.png
deleted file mode 100644
index fa4946f98a..0000000000
Binary files a/images/quickstart/web-editor-dark.png and /dev/null differ
diff --git a/images/quickstart/web-editor-editing-dark.png b/images/quickstart/web-editor-editing-dark.png
deleted file mode 100644
index fecc3a121a..0000000000
Binary files a/images/quickstart/web-editor-editing-dark.png and /dev/null differ
diff --git a/images/quickstart/web-editor-editing-light.png b/images/quickstart/web-editor-editing-light.png
deleted file mode 100644
index 19e2ec4565..0000000000
Binary files a/images/quickstart/web-editor-editing-light.png and /dev/null differ
diff --git a/images/quickstart/web-editor-light.png b/images/quickstart/web-editor-light.png
deleted file mode 100644
index c19e9f9685..0000000000
Binary files a/images/quickstart/web-editor-light.png and /dev/null differ
diff --git a/images/repository-url.png b/images/repository-url.png
deleted file mode 100644
index 7a616e55e2..0000000000
Binary files a/images/repository-url.png and /dev/null differ
diff --git a/images/search-settings-dark.png b/images/search-settings-dark.png
deleted file mode 100644
index 21444c06a8..0000000000
Binary files a/images/search-settings-dark.png and /dev/null differ
diff --git a/images/search-settings-light.png b/images/search-settings-light.png
deleted file mode 100644
index 34380a67d3..0000000000
Binary files a/images/search-settings-light.png and /dev/null differ
diff --git a/images/speakeasy-1.webp b/images/speakeasy-1.webp
deleted file mode 100644
index 9ecc9851a3..0000000000
Binary files a/images/speakeasy-1.webp and /dev/null differ
diff --git a/images/speakeasy-2.webp b/images/speakeasy-2.webp
deleted file mode 100644
index 078810bfbe..0000000000
Binary files a/images/speakeasy-2.webp and /dev/null differ
diff --git a/images/speakeasy-3.webp b/images/speakeasy-3.webp
deleted file mode 100644
index bcc1522970..0000000000
Binary files a/images/speakeasy-3.webp and /dev/null differ
diff --git a/images/speakeasy/copy-combined-spec-url.png b/images/speakeasy/copy-combined-spec-url.png
deleted file mode 100644
index 4efae51d01..0000000000
Binary files a/images/speakeasy/copy-combined-spec-url.png and /dev/null differ
diff --git a/images/speakeasy/mintlify-with-speakeasy-openapi.png b/images/speakeasy/mintlify-with-speakeasy-openapi.png
deleted file mode 100644
index c11eed939c..0000000000
Binary files a/images/speakeasy/mintlify-with-speakeasy-openapi.png and /dev/null differ
diff --git a/images/starter-template.png b/images/starter-template.png
deleted file mode 100644
index 398f87f98b..0000000000
Binary files a/images/starter-template.png and /dev/null differ
diff --git a/images/suggestions/count-dark.png b/images/suggestions/count-dark.png
deleted file mode 100644
index 73f11fe97b..0000000000
Binary files a/images/suggestions/count-dark.png and /dev/null differ
diff --git a/images/suggestions/count-light.png b/images/suggestions/count-light.png
deleted file mode 100644
index c8463eac1b..0000000000
Binary files a/images/suggestions/count-light.png and /dev/null differ
diff --git a/images/support-button.png b/images/support-button.png
deleted file mode 100644
index 97bcdc5c17..0000000000
Binary files a/images/support-button.png and /dev/null differ
diff --git a/images/support-panel-dark.png b/images/support-panel-dark.png
deleted file mode 100644
index 643d6f1320..0000000000
Binary files a/images/support-panel-dark.png and /dev/null differ
diff --git a/images/support-panel-light.png b/images/support-panel-light.png
deleted file mode 100644
index b1402df3b5..0000000000
Binary files a/images/support-panel-light.png and /dev/null differ
diff --git a/images/svg-jsx.png b/images/svg-jsx.png
deleted file mode 100644
index 91c4e7784a..0000000000
Binary files a/images/svg-jsx.png and /dev/null differ
diff --git a/images/tabs-dark.png b/images/tabs-dark.png
deleted file mode 100644
index ff35590e8e..0000000000
Binary files a/images/tabs-dark.png and /dev/null differ
diff --git a/images/tabs-light.png b/images/tabs-light.png
deleted file mode 100644
index 3df14d0ed0..0000000000
Binary files a/images/tabs-light.png and /dev/null differ
diff --git a/images/tiles/accordion-dark.svg b/images/tiles/accordion-dark.svg
deleted file mode 100644
index dbcdf5af56..0000000000
--- a/images/tiles/accordion-dark.svg
+++ /dev/null
@@ -1,24 +0,0 @@
-
diff --git a/images/tiles/accordion-light.svg b/images/tiles/accordion-light.svg
deleted file mode 100644
index fa608eeb96..0000000000
--- a/images/tiles/accordion-light.svg
+++ /dev/null
@@ -1,24 +0,0 @@
-
diff --git a/images/topbar-cta-get-started.png b/images/topbar-cta-get-started.png
deleted file mode 100644
index 7e792c4c17..0000000000
Binary files a/images/topbar-cta-get-started.png and /dev/null differ
diff --git a/images/topbar-cta-github.png b/images/topbar-cta-github.png
deleted file mode 100644
index 5d7c919150..0000000000
Binary files a/images/topbar-cta-github.png and /dev/null differ
diff --git a/images/topbar-links.png b/images/topbar-links.png
deleted file mode 100644
index d2f60ed558..0000000000
Binary files a/images/topbar-links.png and /dev/null differ
diff --git a/images/translations/translations-dashboard-dark.png b/images/translations/translations-dashboard-dark.png
deleted file mode 100644
index c6a168d04a..0000000000
Binary files a/images/translations/translations-dashboard-dark.png and /dev/null differ
diff --git a/images/translations/translations-dashboard-light.png b/images/translations/translations-dashboard-light.png
deleted file mode 100644
index b53a1d3429..0000000000
Binary files a/images/translations/translations-dashboard-light.png and /dev/null differ
diff --git a/images/video.mp4 b/images/video.mp4
deleted file mode 100644
index 5bab54a1a0..0000000000
Binary files a/images/video.mp4 and /dev/null differ
diff --git a/images/workflows/automations-dashboard-dark.png b/images/workflows/automations-dashboard-dark.png
deleted file mode 100644
index d50e54ac55..0000000000
Binary files a/images/workflows/automations-dashboard-dark.png and /dev/null differ
diff --git a/images/workflows/automations-dashboard-light.png b/images/workflows/automations-dashboard-light.png
deleted file mode 100644
index d64b4ca1f9..0000000000
Binary files a/images/workflows/automations-dashboard-light.png and /dev/null differ
diff --git a/images/workflows/workflow-settings-dark.png b/images/workflows/workflow-settings-dark.png
deleted file mode 100644
index 74e00f1dfa..0000000000
Binary files a/images/workflows/workflow-settings-dark.png and /dev/null differ
diff --git a/images/workflows/workflow-settings-light.png b/images/workflows/workflow-settings-light.png
deleted file mode 100644
index 41f3c25cac..0000000000
Binary files a/images/workflows/workflow-settings-light.png and /dev/null differ
diff --git a/integrations/analytics/google-analytics.mdx b/integrations/analytics/google-analytics.mdx
index 5d88771ac9..6911c2a835 100644
--- a/integrations/analytics/google-analytics.mdx
+++ b/integrations/analytics/google-analytics.mdx
@@ -16,8 +16,6 @@ You need to create a web stream to get the Measurement ID to put into Mintlify.
Click the cog at the bottom left of the Google Analytics screen. Then click Data Streams.
-
-
Create a Web Stream and put the URL of your Mintlify docs site as the stream URL.
Your Measurement ID looks like `G-XXXXXXX` and appears under Stream Details immediately after you create the Web Stream.
diff --git a/integrations/privacy/osano.mdx b/integrations/privacy/osano.mdx
index 89c1d158c0..46e97623d7 100644
--- a/integrations/privacy/osano.mdx
+++ b/integrations/privacy/osano.mdx
@@ -50,10 +50,6 @@ After you deploy, open your site in a private or incognito window and confirm th
Add `.mintlify.site/` as a managed rule.
-
-
-
-
This ensures that all Mintlify-served assets, including images, stylesheets, and other documentation resources, remain essential and load even when Osano blocks uncategorized third-party content.
diff --git a/optimize/feedback.mdx b/optimize/feedback.mdx
index 8d870b21cb..63c6e50109 100644
--- a/optimize/feedback.mdx
+++ b/optimize/feedback.mdx
@@ -48,20 +48,6 @@ To collect and view feedback from users, you must enable feedback from the [Add-
* **Contextual feedback**: Free-form feedback about the content of a page. Optionally, enable email collection to allow users to provide their email address when submitting feedback.
* **Code snippet feedback**: Feedback specifically on code snippets.
-
-
-
-
-
-
## Manage feedback
You can set the status of a piece of feedback and add internal notes to track your work resolving user feedback. To analyze feedback outside the dashboard, [export it to CSV](/analytics/export).
diff --git a/optimize/search.mdx b/optimize/search.mdx
index 89aff36c3d..553d7a6799 100644
--- a/optimize/search.mdx
+++ b/optimize/search.mdx
@@ -102,19 +102,6 @@ Control how many results the search bar returns per query from your dashboard. T
Navigate to the [General](https://app.mintlify.com/settings/project/general) settings page in your dashboard. In the "Search" section, set **Results per query** to your desired value.
-
-
-
-
-
Higher values surface more matches per query, which is useful for sites with broad topic coverage where users expect to scan many candidates. Lower values keep the results panel compact and push users toward the top-ranked match.
## Result snippets
diff --git a/zh/ai/contextual-menu.mdx b/zh/ai/contextual-menu.mdx
index 1922ddab32..ad30eb50d1 100644
--- a/zh/ai/contextual-menu.mdx
+++ b/zh/ai/contextual-menu.mdx
@@ -24,6 +24,7 @@ import IconsRequired from "/snippets/zh/icons-required.mdx";
| **复制页面** | `copy` | 将当前页面复制为 Markdown，以便作为 context 粘贴到 AI 工具中 |
| **以 Markdown 查看** | `view` | 以 Markdown 打开当前页面 |
| **询问助手** | `assistant` | 使用当前页面作为 context 打开 [assistant](/zh/assistant/index) |
+| **下载 PDF** | `download-pdf` | 将当前页面下载为 PDF。适用于 [Enterprise 套餐](https://mintlify.com/pricing)。 |
| **在 ChatGPT 中打开** | `chatgpt` | 使用当前页面作为 context 创建一个 ChatGPT 对话 |
| **在 Claude 中打开** | `claude` | 使用当前页面作为 context 创建一个 Claude 对话 |
| **在 Perplexity 中打开** | `perplexity` | 使用当前页面作为 context 创建一个 Perplexity 对话 |
@@ -36,14 +37,10 @@ import IconsRequired from "/snippets/zh/icons-required.mdx";
| **连接到 Cursor** | `cursor` | 在 Cursor 中安装你托管的 MCP 服务器 |
| **连接到 VS Code** | `vscode` | 在 VS Code 中安装你托管的 MCP 服务器 |
| **连接到 Devin** | `devin-mcp` | 在 Devin 中安装你托管的 MCP 服务器 |
-| **下载 PDF** | `download-pdf` | 将当前页面下载为 PDF |
+| **下载 API 规范** | `download-spec` | 下载你的部署的 OpenAPI 规范。如果有多个规范，则以 zip 压缩包形式下载。仅在 API 参考页面上显示。 |
| **自定义选项** | Object | 向上下文菜单添加自定义选项 |
-
-
-
-
-
-
-
-
-
-
-
-
-
## Manage feedback
You can set the status of a piece of feedback and add internal notes to track your work resolving user feedback. To analyze feedback outside the dashboard, [export it to CSV](/analytics/export).
diff --git a/optimize/search.mdx b/optimize/search.mdx
index 89aff36c3d..553d7a6799 100644
--- a/optimize/search.mdx
+++ b/optimize/search.mdx
@@ -102,19 +102,6 @@ Control how many results the search bar returns per query from your dashboard. T
Navigate to the [General](https://app.mintlify.com/settings/project/general) settings page in your dashboard. In the "Search" section, set **Results per query** to your desired value.
-
-
-
-
-
Higher values surface more matches per query, which is useful for sites with broad topic coverage where users expect to scan many candidates. Lower values keep the results panel compact and push users toward the top-ranked match.
## Result snippets
diff --git a/zh/ai/contextual-menu.mdx b/zh/ai/contextual-menu.mdx
index 1922ddab32..ad30eb50d1 100644
--- a/zh/ai/contextual-menu.mdx
+++ b/zh/ai/contextual-menu.mdx
@@ -24,6 +24,7 @@ import IconsRequired from "/snippets/zh/icons-required.mdx";
| **复制页面** | `copy` | 将当前页面复制为 Markdown，以便作为 context 粘贴到 AI 工具中 |
| **以 Markdown 查看** | `view` | 以 Markdown 打开当前页面 |
| **询问助手** | `assistant` | 使用当前页面作为 context 打开 [assistant](/zh/assistant/index) |
+| **下载 PDF** | `download-pdf` | 将当前页面下载为 PDF。适用于 [Enterprise 套餐](https://mintlify.com/pricing)。 |
| **在 ChatGPT 中打开** | `chatgpt` | 使用当前页面作为 context 创建一个 ChatGPT 对话 |
| **在 Claude 中打开** | `claude` | 使用当前页面作为 context 创建一个 Claude 对话 |
| **在 Perplexity 中打开** | `perplexity` | 使用当前页面作为 context 创建一个 Perplexity 对话 |
@@ -36,14 +37,10 @@ import IconsRequired from "/snippets/zh/icons-required.mdx";
| **连接到 Cursor** | `cursor` | 在 Cursor 中安装你托管的 MCP 服务器 |
| **连接到 VS Code** | `vscode` | 在 VS Code 中安装你托管的 MCP 服务器 |
| **连接到 Devin** | `devin-mcp` | 在 Devin 中安装你托管的 MCP 服务器 |
-| **下载 PDF** | `download-pdf` | 将当前页面下载为 PDF |
+| **下载 API 规范** | `download-spec` | 下载你的部署的 OpenAPI 规范。如果有多个规范，则以 zip 压缩包形式下载。仅在 API 参考页面上显示。 |
| **自定义选项** | Object | 向上下文菜单添加自定义选项 |
-
-
-
-
-
+
@@ -51,25 +48,26 @@ import IconsRequired from "/snippets/zh/icons-required.mdx";
```json
{
- "contextual": {
- "options": [
- "copy",
- "view",
- "assistant",
- "chatgpt",
- "claude",
- "perplexity",
+ "contextual": {
+ "options": [
+ "copy",
+ "view",
+ "assistant",
+ "chatgpt",
+ "claude",
+ "perplexity",
"grok",
- "aistudio",
- "devin",
- "devin-desktop",
+ "aistudio",
+ "devin",
+ "devin-desktop",
"mcp",
"cursor",
"vscode",
"devin-mcp",
+ "download-spec",
"download-pdf"
]
- }
+ }
}
```
@@ -93,7 +91,7 @@ import IconsRequired from "/snippets/zh/icons-required.mdx";
| `header` | 在页面顶部的上下文菜单中显示选项 (默认) |
| `toc` | 在目录侧边栏中显示选项 |
-
+
## 添加自定义选项
@@ -178,7 +176,7 @@ contextual:
---
```
-`docs.json` 中相同的字段和校验规则同样适用，包括[自定义选项](#adding-custom-options)以及 `display` 设置。如果页面级的覆盖配置无效，Mintlify 将回退到全局的 `contextual` 配置。
+`docs.json` 中相同的字段和校验规则同样适用，包括[自定义选项](#add-custom-options)以及 `display` 设置。如果页面级的覆盖配置无效，Mintlify 将回退到全局的 `contextual` 配置。
### 自定义选项示例
diff --git a/zh/analytics/export.mdx b/zh/analytics/export.mdx
index e4e6671f14..1ad4e9771b 100644
--- a/zh/analytics/export.mdx
+++ b/zh/analytics/export.mdx
@@ -15,20 +15,6 @@ keywords: ["analytics", "export", "CSV", "traffic export", "assistant export"]
2. 选择要导出的类别:流量、引荐、助手对话、搜索或反馈。
3. 等待 Mintlify 通过电子邮件向您发送下载链接。
-
-
-
-
-
-
-
-
-
+在分析视图中使用范围选择器调整所显示数据的时间段。选择一个预设范围(例如 **Last 7 days** 或 **All time**),或在日历上选择自定义范围。导出也会使用所选的时间范围。
diff --git a/zh/api-playground/troubleshooting.mdx b/zh/api-playground/troubleshooting.mdx
index a043c20736..43e0dc56cd 100644
--- a/zh/api-playground/troubleshooting.mdx
+++ b/zh/api-playground/troubleshooting.mdx
@@ -23,11 +23,7 @@ boost: 3
如果下方出现的文本框带有绿色边框，说明你的文档已通过校验。
这是 Mintlify 用于校验 OpenAPI 文档的同一套校验包，因此如果你的文档在这里通过校验，很大概率问题出在其他地方。
- 此外，Mintlify 不支持 OpenAPI 2.0。如果你的文档使用该版本规范，可能会遇到此问题。你可以在 [editor.swagger.io](https://editor.swagger.io/) 上转换文档 (Edit > Convert to OpenAPI 3) ：
-
-
- 
-
+ 此外，Mintlify 不支持 OpenAPI 2.0。如果你的文档使用该版本规范，可能会遇到此问题。你可以在 [editor.swagger.io](https://editor.swagger.io/) 上转换文档 (Edit > Convert to OpenAPI 3)。
diff --git a/zh/api/automations/trigger.mdx b/zh/api/automations/trigger.mdx
index c0b00ce49d..04f02bbdb8 100644
--- a/zh/api/automations/trigger.mdx
+++ b/zh/api/automations/trigger.mdx
@@ -16,12 +16,6 @@ keywords: ["automation", "workflow", "trigger", "webhook", "schedule", "CI"]
- **发布事件**：在你打出发布标签时运行 **Draft changelog** 自动化，使变更日志与发布同时起草。
- **自定义工具**：从内部工具、Slack 命令或已有的计划任务中触发自动化。
-
-
-
-
-
-
-
-
-
## 解读流量导出数据
diff --git a/zh/analytics/index.mdx b/zh/analytics/index.mdx
index 103632ef79..6cff20c861 100644
--- a/zh/analytics/index.mdx
+++ b/zh/analytics/index.mdx
@@ -17,7 +17,7 @@ dashboard 中的[分析](https://app.mintlify.com/analytics)页面展示了访
分析数据通常会在交互发生后几分钟内出现。最近发生的事件可能不会立即显示。
-
+
-在分析视图中使用范围选择器调整所显示数据的时间段。导出也会使用所选的时间范围。
-
-
-
## 选择分析视图
@@ -47,26 +47,12 @@ dashboard 中的[分析](https://app.mintlify.com/analytics)页面展示了访
## 按时间段筛选
-
-
-
+在分析视图中使用范围选择器调整所显示数据的时间段。选择一个预设范围(例如 **Last 7 days** 或 **All time**),或在日历上选择自定义范围。导出也会使用所选的时间范围。
## 按页面或路径筛选
-使用 **Filter** 菜单可将仪表板范围限定为单个页面或路径。当您选择一个路径时,分析页面会显示该路径下每个路径的数据。例如,如果您筛选到 `docs/authentication`,分析页面会显示 `docs/authentication/*` 路径下每个页面的数据。Assistant 和 Search 视图始终显示站点范围的数据。
+使用 **Filter** 菜单可将仪表板范围限定为单个页面或路径。当您选择一个路径时,分析页面会显示该路径下每个页面的数据。例如,如果您筛选到 `docs/authentication`,分析页面会显示 `docs/authentication/*` 路径下每个页面的数据。Assistant 和 Search 视图始终显示站点范围的数据。
在 Traffic 视图中,按页面筛选会将热门页面排名的起点更改为所选页面,并沿排名向下延续,而不是仅显示该页面。
diff --git a/zh/api-playground/adding-sdk-examples.mdx b/zh/api-playground/adding-sdk-examples.mdx
index dc75d5420d..dc6a282d12 100644
--- a/zh/api-playground/adding-sdk-examples.mdx
+++ b/zh/api-playground/adding-sdk-examples.mdx
@@ -74,10 +74,6 @@ paths:
在注册表条目的页面中，复制提供的公开 URL。
-
-
-
-
- ## 查找自动化 ID
-
-
-在终端中运行 [`mint automations list`](/zh/cli/commands#mint-automations-list)，并从输出中复制自动化 ID。
-
## 示例
diff --git a/zh/assistant/configure.mdx b/zh/assistant/configure.mdx
index 5096beb571..2a556fd175 100644
--- a/zh/assistant/configure.mdx
+++ b/zh/assistant/configure.mdx
@@ -4,20 +4,15 @@ description: "在 Mintlify 仪表盘中配置 AI 助手：启用或停用助手
keywords: ["assistant", "设置", "转接", "机器人防护", "计费"]
---
-在仪表盘的 [Assistant](https://dashboard.mintlify.com/products/assistant) 页面配置 AI 助手。在[用量](https://dashboard.mintlify.com/settings/organization/usage)页面管理计费和用量。
+在仪表盘的 [Assistant](https://app.mintlify.com/products/assistant) 页面配置 AI 助手。在[用量](https://app.mintlify.com/settings/organization/usage)页面管理计费和用量。
## 启用或禁用 AI 助手
-切换状态以在你的文档站点上启用或禁用 AI 助手。
+在仪表盘的 [Assistant](https://app.mintlify.com/products/assistant) 页面，点击状态开关，即可为你的站点启用或禁用 AI 助手。
-
-
-
-
-
-
+
+如果你希望将支持类问题引导至现有的支持渠道，请在“响应处理”部分关闭 **Contact form**。
-
-
-
-
+当联系表单关闭时，AI 助手会以纯文本形式将用户引导至你的支持邮箱地址，而不再显示聊天面板中的表单。当已配置销售邮箱时，销售类问题仍会使用聊天面板中的表单。
+
## 设置转接邮箱
@@ -32,12 +27,11 @@ keywords: ["assistant", "设置", "转接", "机器人防护", "计费"]
嵌入到其他站点的 [assistant widget](/zh/assistant/widget) 中也提供同一联系表单。
-如果你希望将支持类问题引导至现有的支持渠道，请在“响应处理”部分关闭 **显示联系表单**。当联系表单关闭时，AI 助手会以纯文本形式将用户引导至你的支持邮箱地址，而不再显示聊天面板中的表单。当已配置销售邮箱时，销售类问题仍会使用聊天面板中的表单。此设置默认开启。
+
-
-
+当联系表单关闭时，AI 助手会以纯文本形式将用户引导至你的支持邮箱地址，而不再显示聊天面板中的表单。当已配置销售邮箱时，销售类问题仍会使用聊天面板中的表单。
+
## 转接到支持链接
@@ -60,11 +54,6 @@ keywords: ["assistant", "设置", "转接", "机器人防护", "计费"]
- 域名必须是公开可访问的。
- AI 助手无法搜索需要 JavaScript 加载的域名。
-
-
-
-
-
要更精确地控制 AI 助手的搜索范围，请使用过滤语法。
- **域名级别过滤**
@@ -99,7 +88,7 @@ AI 助手可以根据用户正在查看的页面生成特定于页面的问题
要启用机器人防护：
-1. 在仪表盘中进入 [AI 助手设置](https://dashboard.mintlify.com/products/assistant/settings)页面。
+1. 在仪表盘中进入 [AI 助手设置](https://app.mintlify.com/products/assistant/settings)页面。
2. 在 **Bot Protection** 部分，开启 **Invisible Captcha**。
更改最多需要 10 分钟才能生效。
diff --git a/zh/assistant/index.mdx b/zh/assistant/index.mdx
index 6e8717a9f7..fdc7e4e93a 100644
--- a/zh/assistant/index.mdx
+++ b/zh/assistant/index.mdx
@@ -38,7 +38,7 @@ AI 助手索引你发布的文档和 API 规范，以准确回答问题。当你
AI 助手仅基于你文档中的信息回答问题。如果搜索后找不到相关信息，它会回复没有足够的信息来回答。
-你可以[设置转接邮箱](/zh/assistant/configure#set-deflection-email)，让 AI 助手在无法回答用户问题时提供你的支持邮箱。即使文档没有涵盖用户的特定问题，这也能为用户提供一条出路。
+你可以[设置转接邮箱](/zh/assistant/configure#set-deflection-emails)，让 AI 助手在无法回答用户问题时提供你的支持邮箱。即使文档没有涵盖用户的特定问题，这也能为用户提供一条出路。
-
-
-
要更精确地控制 AI 助手的搜索范围，请使用过滤语法。
- **域名级别过滤**
@@ -99,7 +88,7 @@ AI 助手可以根据用户正在查看的页面生成特定于页面的问题
要启用机器人防护：
-1. 在仪表盘中进入 [AI 助手设置](https://dashboard.mintlify.com/products/assistant/settings)页面。
+1. 在仪表盘中进入 [AI 助手设置](https://app.mintlify.com/products/assistant/settings)页面。
2. 在 **Bot Protection** 部分，开启 **Invisible Captcha**。
更改最多需要 10 分钟才能生效。
diff --git a/zh/assistant/index.mdx b/zh/assistant/index.mdx
index 6e8717a9f7..fdc7e4e93a 100644
--- a/zh/assistant/index.mdx
+++ b/zh/assistant/index.mdx
@@ -38,7 +38,7 @@ AI 助手索引你发布的文档和 API 规范，以准确回答问题。当你
AI 助手仅基于你文档中的信息回答问题。如果搜索后找不到相关信息，它会回复没有足够的信息来回答。
-你可以[设置转接邮箱](/zh/assistant/configure#set-deflection-email)，让 AI 助手在无法回答用户问题时提供你的支持邮箱。即使文档没有涵盖用户的特定问题，这也能为用户提供一条出路。
+你可以[设置转接邮箱](/zh/assistant/configure#set-deflection-emails)，让 AI 助手在无法回答用户问题时提供你的支持邮箱。即使文档没有涵盖用户的特定问题，这也能为用户提供一条出路。
## AI 助手数据洞察
diff --git a/zh/assistant/use.mdx b/zh/assistant/use.mdx
index 50f50cb234..a991472f88 100644
--- a/zh/assistant/use.mdx
+++ b/zh/assistant/use.mdx
@@ -93,11 +93,6 @@ https://yourdocs.mintlify.site/quickstart?assistant=How%20do%20I%20get%20started
在页面上选中文本，然后点击弹出的 **Add to assistant** 按钮，即可打开 AI 助手聊天面板并将选中的文本添加为上下文。你可以向 AI 助手的上下文中添加多个文本片段或代码块。
-
-
-
-
-
-
-
-
-
-
-
## 代码块
@@ -124,11 +119,6 @@ https://yourdocs.mintlify.site/quickstart?assistant=How%20do%20I%20get%20started
- 最大文件大小：每个附件 5 MB
- 每条消息最大附件数：10
-
-
-
-
-
## 故障排除
diff --git a/zh/assistant/widget.mdx b/zh/assistant/widget.mdx
index 04e74de3fa..a7d3c638b0 100644
--- a/zh/assistant/widget.mdx
+++ b/zh/assistant/widget.mdx
@@ -16,7 +16,7 @@ export const WidgetCodeBlock = ({ children, ...props }) => (
通过一段托管脚本,即可将小组件添加到任何网站或 Web 应用。小组件自带触发器,并在封闭的 Shadow DOM 内渲染,可防止你的应用样式影响小组件。
-浏览器端唯一必需的选项是公共小组件 ID。启用状态、允许的来源、附件、机器人防护以及[分流联系表单](/zh/assistant/configure#set-deflection-email)均可在仪表板中管理。可在浏览器配置中设置针对该嵌入的起始问题和支持邮箱。
+浏览器端唯一必需的选项是公共小组件 ID。启用状态、允许的来源、附件、机器人防护以及[分流联系表单](/zh/assistant/configure#set-deflection-emails)均可在仪表板中管理。可在浏览器配置中设置针对该嵌入的起始问题和支持邮箱。
## 前置条件
diff --git a/zh/automations/manage.mdx b/zh/automations/manage.mdx
index aab2211e3e..9ff088ed9f 100644
--- a/zh/automations/manage.mdx
+++ b/zh/automations/manage.mdx
@@ -14,20 +14,12 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx';
- 对于 GitHub：在你计划用于自动化的每个仓库上都安装 [Mintlify GitHub 应用](/zh/deploy/github)
- 对于 GitLab：已连接的 GitLab 账户（请参见下方[GitLab 设置](#gitlab-setup)）
-
- 你也可以通过 [`mint automations`](/zh/cli/commands#mint-automations) 在终端中创建、列出和删除自动化。CLI 适合用于脚本和 CI。控制台是配置和监控自动化运行最简单的方式。
-
-
-
-
如果自动化可以使用默认设置运行，它会立即激活。否则，该自动化的配置页面会打开，让你填写任何必需的配置。
3. 如果配置页面打开，请填写必填字段并点击 **Save**。
@@ -48,8 +40,8 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx';
- **内容更新（Content update）**：每当你向项目仓库推送内容时运行，包括 pull request 合并和直接推送。
- **代码变更（Code change）**：当已连接的源代码仓库中有 pull request 合并时运行。你必须至少指定一个源仓库。点击 **Add repo** 可让来自多个仓库的 pull request 触发该自动化。对于每个仓库，你可以选择设置 **Exclude author** 来忽略来自特定作者的 pull request，以及 **Listening to changes in** 仅在特定路径下有变更的 pull request 时触发。
-- **自定义计划（Custom schedule）**：按你定义的周期性计划运行。选择一个预设（**Daily**、**Every Monday**、**Every Friday** 或 **Twice weekly**）以及起始小时，或选择 **Custom cron** 并输入标准的 5 段式 cron 表达式（`minute hour day month weekday`）。cron 值以 UTC 存储；控制台会在你的本地时区与预设小时之间进行转换。自动化会在预定时间的 10 分钟内进入队列。
-- **集成（Integration）**：当已连接的共享集成中发生所选事件时运行，或当在所选 Slack 频道中发布新的顶层消息时运行。此选项适用于自定义自动化。请选择集成和事件，并填写出现的任何其他事件字段。对于 Slack 触发器，请选择一个或多个已添加 [Mintlify Slack 应用](/zh/agent/slack)的频道。
+- **自定义计划（Custom schedule）**：按你定义的周期性计划运行。选择一个预设（**Daily**、**Every Monday**、**Every Friday** 或 **Twice weekly**）以及起始小时，或选择 **Custom cron** 并输入标准的 5 段式 cron 表达式（`minute hour day month weekday`）。自动化会在预定时间的 10 分钟内进入队列。
+- **集成（Integration）**：当已连接的共享集成中发生所选事件时运行，或当在所选 Slack 频道中发布新消息时运行。此选项适用于自定义自动化。请选择集成和事件，并填写出现的任何其他事件字段。对于 Slack 触发器，请选择一个或多个已添加 [Mintlify Slack 应用](/zh/agent/slack)的频道。
- **Webhook**：当一个已认证的 `POST` 请求命中自动化的 webhook 端点时运行。仅适用于自定义自动化。先保存自动化。触发器卡片随后会显示 webhook URL 和用于 `Authorization: Bearer ` 请求头的 **Copy auth header** 操作。在 [API keys](https://app.mintlify.com/settings/organization/api-keys) 页面提供一个具有写入权限且未过期的组织 API 密钥。可用于从 CI/CD 流水线、发布脚本或内部工具触发运行。有关端点和速率限制，请参见[触发自动化 webhook](/zh/api/automations/webhook)。
1. 在 Google Workspace 中，前往 **Web and mobile apps**。
2. 在 **Add app** 下拉菜单中点击 **Add custom SAML app**。
-
- 
-
复制提供的 SSO URL、Entity ID 和 x509 证书，并发送给 Mintlify 团队。
-
- 
-
在 Service provider details 页面，输入以下内容：
@@ -253,10 +247,6 @@ Enterprise 管理员可以直接在 Mintlify dashboard 中为 Okta 或 Microsoft
* Name ID format：`EMAIL`
* Name ID：`Basic Information > Primary email`
-
- 
-
-
在下一页，输入以下属性声明：
| Google Directory Attribute | App Attribute |
diff --git a/zh/deploy/github.mdx b/zh/deploy/github.mdx
index 1ddde87120..332412f114 100644
--- a/zh/deploy/github.mdx
+++ b/zh/deploy/github.mdx
@@ -65,19 +65,7 @@ Mintlify 使用 GitHub 应用，将你的文档与 GitHub 存储库自动同步
你必须在存储库中拥有组织所有者或管理员权限才能安装该应用。如果你没有相应权限，需要由存储库所有者批准安装请求。
-通过你的[控制台](https://dashboard.mintlify.com/settings/organization/github-app)安装 Mintlify GitHub 应用。
-
-
- 我们建议只为你的文档存储库授予访问权限。
-
-
-
-
-
+在控制台的 [Git settings](https://app.mintlify.com/settings/project/git-settings) 页面安装 Mintlify GitHub 应用。当 GitHub 询问要授予哪些存储库的访问权限时，请选择 **Only select repositories**，然后选择你的文档存储库。
## 启用自动化
1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。
2. 点击自动化旁边的开关以启用它。
-
-
-
-
如果自动化可以使用默认设置运行，它会立即激活。否则，该自动化的配置页面会打开，让你填写任何必需的配置。
3. 如果配置页面打开，请填写必填字段并点击 **Save**。
@@ -48,8 +40,8 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx';
- **内容更新（Content update）**：每当你向项目仓库推送内容时运行，包括 pull request 合并和直接推送。
- **代码变更（Code change）**：当已连接的源代码仓库中有 pull request 合并时运行。你必须至少指定一个源仓库。点击 **Add repo** 可让来自多个仓库的 pull request 触发该自动化。对于每个仓库，你可以选择设置 **Exclude author** 来忽略来自特定作者的 pull request，以及 **Listening to changes in** 仅在特定路径下有变更的 pull request 时触发。
-- **自定义计划（Custom schedule）**：按你定义的周期性计划运行。选择一个预设（**Daily**、**Every Monday**、**Every Friday** 或 **Twice weekly**）以及起始小时，或选择 **Custom cron** 并输入标准的 5 段式 cron 表达式（`minute hour day month weekday`）。cron 值以 UTC 存储；控制台会在你的本地时区与预设小时之间进行转换。自动化会在预定时间的 10 分钟内进入队列。
-- **集成（Integration）**：当已连接的共享集成中发生所选事件时运行，或当在所选 Slack 频道中发布新的顶层消息时运行。此选项适用于自定义自动化。请选择集成和事件，并填写出现的任何其他事件字段。对于 Slack 触发器，请选择一个或多个已添加 [Mintlify Slack 应用](/zh/agent/slack)的频道。
+- **自定义计划（Custom schedule）**：按你定义的周期性计划运行。选择一个预设（**Daily**、**Every Monday**、**Every Friday** 或 **Twice weekly**）以及起始小时，或选择 **Custom cron** 并输入标准的 5 段式 cron 表达式（`minute hour day month weekday`）。自动化会在预定时间的 10 分钟内进入队列。
+- **集成（Integration）**：当已连接的共享集成中发生所选事件时运行，或当在所选 Slack 频道中发布新消息时运行。此选项适用于自定义自动化。请选择集成和事件，并填写出现的任何其他事件字段。对于 Slack 触发器，请选择一个或多个已添加 [Mintlify Slack 应用](/zh/agent/slack)的频道。
- **Webhook**：当一个已认证的 `POST` 请求命中自动化的 webhook 端点时运行。仅适用于自定义自动化。先保存自动化。触发器卡片随后会显示 webhook URL 和用于 `Authorization: Bearer
@@ -61,7 +53,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx';
- **Listening to changes in**：添加 pull request 必须涉及的路径，自动化才会运行。路径可以是文件、文件夹或 glob 模式（例如 `docs/**/*.mdx`）。建议来自仓库中被跟踪的文件；你也可以输入自定义路径。
- **Excluding PRs from**：添加不应触发自动化的 GitHub 用户名或机器人账户。适合跳过自动化账户的合并操作。建议来自近期的贡献者；你也可以输入自定义用户名。
-每个仓库最多支持 20 条路径和 20 个被排除的作者。在卡片上更换仓库会清除其过滤器。GitLab 源代码仓库不支持按仓库过滤，仍使用单一的仓库选择器。
+每个仓库最多支持 20 条路径和 20 个被排除的作者。更换自动化的仓库会清除其过滤器。
-组织管理员可以要求组织内的所有人都通过身份提供商登录。当 `Require SSO`（强制 SSO）开启时，Mintlify 会拒绝密码、magic link 和 Google OAuth 登录。
+要要求组织内的所有人都通过身份提供商登录，请开启 **Require SSO**。当 **Require SSO** 开启时，Mintlify 会拒绝密码、magic link 和 Google OAuth 登录。
1. 前往 dashboard 中的 [Identity & access](https://app.mintlify.com/settings/organization/sso) 页面。
2. 确认 SSO 已端到端正常工作。在无痕浏览器窗口中，分别从你的身份提供商的应用目录（IdP 发起）以及 [Mintlify 登录页面](https://app.mintlify.com/login)使用已验证域名下的邮箱（SP 发起）登录 Mintlify dashboard。两种流程都应通过你的身份提供商跳转，并最终进入 dashboard。
@@ -235,15 +235,9 @@ Enterprise 管理员可以直接在 Mintlify dashboard 中为 Okta 或 Microsoft
### 更新模式
@@ -93,7 +85,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx';
要为某个自动化启用集成，打开其配置页面，展开 **Advanced options**，然后在 **Integrations** 中选择你想使用的集成。
-如果选择 **集成（Integration）** 作为触发器，触发该自动化的集成会自动添加为工具。有关连接范围、支持的事件和权限，请参见[集成](/zh/automations/integrations)。
+如果为自定义自动化选择 **集成（Integration）** 作为触发器，触发该自动化的集成始终是该自动化的工具之一。有关连接范围、支持的事件和权限，请参见[集成](/zh/automations/integrations)。
-将 Mintlify 托管的 Index MCP 服务器安装到你的编程代理中。该服务器提供 `context` 工具，用于查询库、框架、SDK、API 和 CLI 工具。
+为你的编程代理安装 Mintlify 托管的 Index MCP 服务器，以搜索 Mintlify 站点上的所有内容。该服务器提供 `context` 工具，用于查询库、框架、SDK、API 和 CLI 工具。
Index MCP 服务器不同于[Mintlify Docs MCP 服务器](/zh/ai/model-context-protocol)，后者用于搜索你的文档站点。
@@ -53,9 +53,7 @@ Index MCP 服务器不同于[Mintlify Docs MCP 服务器](/zh/ai/model-context-p
mint index [options]
```
-该命令也可以使用 `mintlify index` 运行。
-
-
### Slack 通知
@@ -152,14 +144,12 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx';
## 删除自动化
-你可以在控制台中删除自定义自动化。预定义自动化无法从控制台删除。请改为禁用它们，或使用 CLI 来移除。
+删除操作是永久性的，无法撤销。
1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。
2. 点击自定义自动化卡片上的
## 手动运行自动化
@@ -218,13 +208,15 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx';
你可以直接在列表中对结果执行操作。对于等待审查的运行，点击 **Accept** 合并更改，或点击 **Preview** 打开该运行分支的 [preview deployment](/zh/deploy/preview-deployments)。对于失败的结果，点击 **Re-trigger** 重新开始运行。
-只有当运行关联了 preview deployment 时，才会显示 **Preview** 按钮。preview deployment 在闲置一段时间后会过期；过期后该按钮将被禁用。
+只有当运行关联了 preview deployment 时，才会显示 **Preview** 按钮。preview deployment 在闲置一段时间后会过期。过期后，该按钮会显示 **Preview expired** 且不再可用。
### 解决合并冲突
-如果某次运行的 pull request 与你的部署分支存在冲突，点击 **Accept** 会打开一个对话框，提供为你解决冲突的选项。点击 **Resolve and merge**，agent 会将部署分支的最新更改合并到 pull request 分支、解决冲突并自动合并该 pull request。agent 工作期间，运行显示为 **Running**；pull request 合并后变为 **Accepted**。如果 agent 无法解决冲突，请在你的仓库中手动解决冲突，然后再次点击 **Accept**。
+如果某次运行的 pull request 与你的部署分支存在冲突，当你点击该自动化运行的 **Accept** 时，agent 会提示你解决冲突。
+
+点击 **Resolve and merge**，agent 会将部署分支的最新更改合并到 pull request 分支、解决冲突并自动合并该 pull request。如果 agent 无法解决冲突，请在你的仓库中手动解决冲突，然后点击 **Accept**。
要查看某次运行的提示词、读取或更改的文件，以及任何 pull request，请点击该运行的
+
我们的目标是在 24 小时内回复所有消息，但在繁忙时段可能会有所延迟。
@@ -33,4 +29,4 @@ description: "联系 Mintlify 支持团队，获取文档站点的技术支持
## 通过电子邮件联系
-如果你无法访问控制台，请发送邮件至 support@mintlify.com。请在邮件中附上你的[控制台](https://dashboard.mintlify.com/) URL，包含你的组织和部署信息，以便我们更快地为你提供帮助。例如，`dashboard.mintlify.com/your-org/your-deployment`。
\ No newline at end of file
+如果你无法访问控制台，请发送邮件至 support@mintlify.com。请在邮件中附上你的[控制台](https://app.mintlify.com/) URL，包含你的组织和部署信息，以便我们更快地为你提供帮助。例如，`app.mintlify.com/your-org/your-deployment`。
\ No newline at end of file
diff --git a/zh/dashboard/sso.mdx b/zh/dashboard/sso.mdx
index 84ebd8f9a3..7b8f904318 100644
--- a/zh/dashboard/sso.mdx
+++ b/zh/dashboard/sso.mdx
@@ -32,7 +32,7 @@ Enterprise 管理员可以直接在 Mintlify dashboard 中为 Okta 或 Microsoft
* **Audience URI**：你从 Mintlify dashboard 复制的 URI
* **Name ID Format**：`EmailAddress`
- 4. 添加以下属性声明：
+ 3. 添加以下属性声明：
| Name | Name format | Value |
| ---- | ----------- | ----- |
@@ -127,7 +127,7 @@ Enterprise 管理员可以直接在 Mintlify dashboard 中为 Okta 或 Microsoft
## Require SSO（强制 SSO）
### 选项
@@ -71,11 +69,11 @@ mint index [options]
| `--project` | 在客户端支持时写入项目配置，而不是全局配置。 |
| `--yes`、`-y` | 跳过选择器并配置所有检测到的客户端。 |
-
+
+ `mint format` 会就地重写文件。运行前请先提交或暂存你的更改，以便审查 diff。
+
+
将当前目录中的每个 `.mdx` 文件格式化为 Mintlify 的规范样式。该命令使用与 Web 编辑器相同的 MDX 解析器解析每个文件，如果规范化输出与原文不同，则就地重写文件。
```bash
@@ -672,9 +667,9 @@ mint format
在文档项目的根目录中运行该命令。它会遍历所有子目录，跳过 `.gitignore` 匹配的路径和任何 Mintlify 忽略规则匹配的路径。已经与规范化输出一致的文件将保持不变。
-
- `mint format` 会就地重写文件。运行前请先提交或暂存你的更改，以便审查 diff。
-
+
+ 根据项目规模，运行 `mint format` 可能会产生大量更改。为避免合并冲突以及对其他进行中的工作引入更改，请先处理完所有重要的待合并分支，然后为格式化更改创建一个新分支，并在该分支上运行 `mint format`。
+
命令完成后，会打印重新格式化了多少个 MDX 文件以及有多少文件解析失败。如果有任何文件失败，命令将以退出码 `1` 结束，并打印文件路径和错误信息，这样你就可以在 CI 中运行它以强制执行一致的格式。示例流水线请参见 [在 CI 中安装](/zh/cli/install#install-in-ci)。
diff --git a/zh/cli/preview.mdx b/zh/cli/preview.mdx
index bd671033ab..babbef40d4 100644
--- a/zh/cli/preview.mdx
+++ b/zh/cli/preview.mdx
@@ -49,7 +49,7 @@ npx mint dev
mint login
```
-使用 `mint login` 命令完成身份验证后，CLI 会将你的凭据存储在 `~/.config/mintlify/config.json` 中，以便你在各会话之间保持登录状态。CLI 还会提示你选择一个默认项目，`mint automations` 等命令会使用该项目。
+使用 `mint login` 命令完成身份验证后，CLI 会将你的凭据存储在 `~/.config/mintlify/config.json` 中，以便你在各会话之间保持登录状态。CLI 还会提示你选择一个默认项目。
登录后，运行 `mint dev` 启动带有搜索和助手功能的本地预览。助手使用与已部署文档站点相同的索引内容。
diff --git a/zh/contact-support.mdx b/zh/contact-support.mdx
index d314b1198f..98e561cdeb 100644
--- a/zh/contact-support.mdx
+++ b/zh/contact-support.mdx
@@ -19,11 +19,7 @@ description: "联系 Mintlify 支持团队，获取文档站点的技术支持
## 消息支持
-从你的[控制台](https://dashboard.mintlify.com/)向我们发送消息。点击顶部栏中的
### 选择客户端
-不带客户端选项运行 `mint index`，即可检测已安装的客户端并打开交互式选择器。检测到的客户端默认处于选中状态。选择要配置的客户端，然后确认提示。
+不带客户端选项运行 `mint index`，即可检测已安装的客户端并打开交互式选择器。选择要配置的客户端，然后确认提示。
传入一个或多个客户端选项，可以在不打开选择器的情况下配置指定客户端：
@@ -91,7 +89,7 @@ mint index --claude --cursor
mint index --project --cursor --vscode
```
-
+ [value]
| 键 | 描述 | 使用者 |
| --- | --- | --- |
-| `subdomain` | 默认文档子域名。 | `mint dev`、`mint automations`、`mint analytics`、`mint add-domain`、`mint score` |
+| `subdomain` | 默认文档子域名。 | `mint dev`、`mint analytics`、`mint add-domain`、`mint score` |
| `dateFrom` | 分析查询的默认开始日期。 | `mint analytics` |
| `dateTo` | 分析查询的默认结束日期。 | `mint analytics` |
@@ -444,7 +442,7 @@ mint config [value]
mint broken-links [flags]
```
-该命令会排除匹配 [.mintignore](/zh/organize/mintignore) 模式的文件。指向被忽略文件的链接会被报告为断链。
+该命令会扫描 `.mdx` 和 `.md` 文件中的链接，并排除匹配 [.mintignore](/zh/organize/mintignore) 模式的文件。OpenAPI 规范文件（`.yaml`、`.yml`、`.json`）中的链接不会被检查。指向被忽略文件的链接会被报告为断链。
| 选项 | 描述 |
| --- | --- |
@@ -464,7 +462,7 @@ mint broken-links --files introduction.mdx
mint broken-links --files "guides/**/*.mdx"
# 传入多个路径
-mint broken-links --files introduction.mdx --files "guides/**/*.mdx"
+mint broken-links --files introduction.mdx "guides/**/*.mdx"
```
---
@@ -539,13 +537,6 @@ mint test
只有出现在 `docs.json` 导航中的页面才会显示以供选择。
-
-
-
-
+
### 配置和规则
@@ -428,7 +426,7 @@ mint config
-
-
### 回顾上一次运行
@@ -664,6 +655,10 @@ mint score docs.example.com
## `mint format`
-
+从你的[控制台](https://app.mintlify.com/)向我们发送消息。在设置菜单中点击
-
+在控制台的 [Git settings](https://app.mintlify.com/settings/project/git-settings) 页面安装 Mintlify GitHub 应用。当 GitHub 询问要授予哪些存储库的访问权限时，请选择 **Only select repositories**，然后选择你的文档存储库。
## 权限
@@ -104,7 +92,7 @@ Mintlify 使用 GitHub 应用，将你的文档与 GitHub 存储库自动同步
## 管理存储库访问
-安装 GitHub 应用时，你可以授予对所有或特定存储库的访问权限。我们建议仅为你的文档存储库，以及任何你希望作为智能助手上下文提供的存储库授予访问权限。你可以随时在 [GitHub 应用设置](https://github.com/apps/mintlify/installations/new) 中修改此选择。
+安装 GitHub 应用时，你可以授予对所有或特定存储库的访问权限。请仅为你的文档存储库，以及任何你希望作为 agent 或工作流上下文提供的存储库授予访问权限。你可以随时在 [GitHub 应用设置](https://github.com/apps/mintlify/installations/new) 中修改此选择。
## 配置文档来源
@@ -134,7 +122,7 @@ Mintlify 使用 GitHub 应用，将你的文档与 GitHub 存储库自动同步
检查是否已在正确的存储库中安装该应用。
- 1. 在控制台中前往 [GitHub 应用设置](https://dashboard.mintlify.com/settings/organization/github-app)。
+ 1. 在控制台中前往 [Git settings](https://app.mintlify.com/settings/project/git-settings) 页面。
1. 确认你的存储库出现在已启用的应用安装列表中。
@@ -158,36 +146,6 @@ Mintlify 使用 GitHub 应用，将你的文档与 GitHub 存储库自动同步
1. 在你的 Mintlify 控制台中，前往 [Git Settings](https://app.mintlify.com/settings/project/git-settings) 并安装 GitHub 应用。
- 2. 在控制台的 [My Profile](https://dashboard.mintlify.com/settings/account) 中授权你的账户。
+ 2. 在控制台的 [My Profile](https://app.mintlify.com/settings/account) 中授权你的账户。
-
-
-
-“编辑建议”和“提交问题”反馈功能仅适用于公开的 GitHub 存储库。如果这些选项在控制台中不可用，请检查你的存储库可见性。
-
-如果你的存储库为公开状态，并且你无法在控制台中启用“编辑建议”或“提交问题”选项，请重新验证你的 Git 设置。
-
-
-
- 前往控制台中的 [Git Settings](https://app.mintlify.com/settings/project/git-settings)。
-
-
- 点击 Git 设置卡片右上角的绿色勾选图标以重新验证存储库设置。此操作会强制更新设置，以准确反映你的存储库是公开还是私有。
-
-
-
-
-
-
-
\ No newline at end of file
diff --git a/zh/deploy/gitlab.mdx b/zh/deploy/gitlab.mdx
index 792d139f96..7ba445d452 100644
--- a/zh/deploy/gitlab.mdx
+++ b/zh/deploy/gitlab.mdx
@@ -22,14 +22,18 @@ Mintlify 使用访问令牌和 webhook 在 GitLab 与 Mintlify 之间进行身
- 如果你在入门引导过程中跳过了 Git 提供商连接，你的文档存储在 Mintlify 托管的存储库中。在继续之前，请下载你的内容作为备份。
+ 如果你已经有一个包含文档的 GitLab 存储库，可以跳过下载，直接点击 **Continue setup**。
+
+ 如果你的文档由 Mintlify 托管，请将其下载为 zip 文件。
+ * 在 GitLab 中创建一个新存储库。
+ * 解压 zip 文件内容。
+ * 将内容推送到你的存储库。
+
+ 点击 **Continue setup** 继续。
在你的 GitLab 项目中，依次进入 **Settings** > **General**，找到 **Project ID**。
-
-
-
前往 **Settings** > **Access Tokens**，选择 **Add new token**。
@@ -44,22 +48,16 @@ Mintlify 使用访问令牌和 webhook 在 GitLab 与 Mintlify 之间进行身
如果无法使用 Project Access Tokens，可改用 Personal Access Token。请注意，Personal Access Token 会过期，需要定期更新。
-
-
-
-
-
- 在 [Mintlify 控制台](https://app.mintlify.com/settings/project/git-settings) 中填写以下字段：
+ 回到设置向导，填写以下字段：
- - **Project ID**：你的 GitLab 项目 ID。
- - **Access Token**：你刚刚生成的访问令牌。
- - **Branch**：用于部署文档的分支。
- - **Subdirectory**（可选）：如果你使用的是 monorepo 且文档不在存储库根目录下，请输入文档目录的相对路径。
- - **Self-hosted instance URL**（可选）：如果你使用自托管的 GitLab 实例，请输入你的 GitLab 实例的主机 URL（例如 `https://gitlab.your-domain.com`）。你的实例必须可公开访问，以便 Mintlify 能够连接。
+ - **GitLab instance URL**：如果使用 `gitlab.com`，请留空；否则输入你的自托管实例 URL（例如 `https://gitlab.your-domain.com`）。你的实例必须可公开访问，以便 Mintlify 能够连接。
+ - **Project ID**：来自 GitLab 项目设置的项目 ID。
+ - **GitLab deployment token**：你生成的访问令牌。
+ - **Branch**：选择用于部署文档的分支。
- 点击 **Save Changes**。
+ 点击 **Connect**。
@@ -73,7 +71,9 @@ Mintlify 使用访问令牌和 webhook 在 GitLab 与 Mintlify 之间进行身
要在初始设置后修改你的 GitLab 连接设置，请前往 [Git Settings](https://app.mintlify.com/settings/project/git-settings) 直接更新项目 ID、访问令牌、分支或实例 URL。
-## 重新验证 Git 设置
+
- 点击 GitLab 设置卡片右上角的绿色 **Active** 徽章以重新验证你的 Git 源。重新验证完成后会显示成功提示，如果配置需要检查则会显示错误提示。
+ 点击 GitLab 设置卡片右上角的绿色 **Active** 徽章以重新验证你的 Git 源。
@@ -96,9 +96,6 @@ Webhook 会在你推送更改时通知 Mintlify，以便自动触发部署。
1. 在 GitLab 中，依次前往 **Settings** > **Webhooks**。
2. 点击 **Add new webhook**。
-
-
-
将该 webhook 命名为 **Mintlify**。
@@ -107,10 +104,6 @@ Webhook 会在你推送更改时通知 Mintlify，以便自动触发部署。
在 Mintlify 控制台中，点击 **Show webhook token**，然后复制该 webhook 令牌。
-
-
-
-
在 GitLab 中，将来自 Mintlify 控制台的 webhook 令牌粘贴到 **Secret token** 字段中。
@@ -129,17 +122,9 @@ Webhook 会在你推送更改时通知 Mintlify，以便自动触发部署。
- **Events**：**Push events**（All branches）和 **Merge requests events**
添加该 webhook。
-
-
-
-
创建 webhook 之后，点击 **Test** 下拉菜单。点击 **Push events** 以发送示例负载。如果测试返回 `Hook executed successfully: HTTP 200`，则说明你已正确配置 webhook。
-
-
-
-
diff --git a/zh/deploy/multi-repo.mdx b/zh/deploy/multi-repo.mdx
index 4c827fedbe..d659224711 100644
--- a/zh/deploy/multi-repo.mdx
+++ b/zh/deploy/multi-repo.mdx
@@ -60,11 +60,6 @@ docs.example.com/sdks
在仪表板中前往 [Git 设置](https://app.mintlify.com/settings/project/git-settings)。
-
-
-
-
-
@@ -211,7 +206,7 @@ Mintlify 会将每个源仓库的 `docs.json` 中定义的 [`variables`](/zh/org
- 被引用的仓库必须已配置为同一多仓库部署中的源。
- `sourceRef` 的值必须至少包含两个路径段，例如 `owner/repo`。不支持仅使用挂载路径或仓库名称。
-- 对于嵌套子组中的 GitLab 仓库，请使用完整路径，例如 `group/subgroup/repo`。你可以将值缩短为最后两个路径段，例如 `subgroup/repo`，除非两个源共享相同的末尾路径段。当两个源共享相同的末尾路径段时，请为每个源使用完整路径。
+ - 对于嵌套子组中的 GitLab 仓库，请使用完整路径，例如 `group/subgroup/repo`。你可以将值缩短为最后两个路径段，例如 `subgroup/repo`，除非两个源共享相同的末尾路径段。当两个源共享相同的末尾路径段时，请为每个源使用完整路径。
- 被引用的源必须定义与主源相似的导航结构。例如，在 `anchors` 中使用 `sourceRef` 时，被引用的源必须定义 `navigation.anchors`。
- `sourceRef` 条目不能形成循环。源不能引用自身，两个源也不能相互引用。
- `sourceRef` 必须出现在导航数组中。它在 `navigation` 的顶层无效。
diff --git a/zh/deploy/preview-deployments.mdx b/zh/deploy/preview-deployments.mdx
index 40a8f433fd..5e41cbce0f 100644
--- a/zh/deploy/preview-deployments.mdx
+++ b/zh/deploy/preview-deployments.mdx
@@ -67,15 +67,8 @@ keywords: ["preview URLs", "pull request previews", "branch previews", "staging
当需要刷新内容，或在部署失败后重试时，可重新部署预览。
1. 前往控制台中的 [Activity](https://app.mintlify.com/activity) 页面。
-2. 点击 **Previews** 标签页。
-3. 点击要重新部署的预览。
-4. 点击**重新部署**。
-
-
-
-
-
-
+2. 点击要重新部署的预览。
+3. 点击 **Redeploy**。
-
-
-
-
-
-
@@ -73,7 +71,9 @@ Mintlify 使用访问令牌和 webhook 在 GitLab 与 Mintlify 之间进行身
要在初始设置后修改你的 GitLab 连接设置，请前往 [Git Settings](https://app.mintlify.com/settings/project/git-settings) 直接更新项目 ID、访问令牌、分支或实例 URL。
-## 重新验证 Git 设置
+
+ ## 重新验证 Git 设置
+
如果你的部署出现异常情况（例如缺少分支选项或配置过时），可以强制 Mintlify 刷新你的 Git 源。
@@ -82,7 +82,7 @@ Mintlify 使用访问令牌和 webhook 在 GitLab 与 Mintlify 之间进行身
前往控制台中的 [Git Settings](https://app.mintlify.com/settings/project/git-settings)。
-
-
-
-
-
-
-
-
-
-
-
+2. 点击要重新部署的预览。
+3. 点击 **Redeploy**。
## 预览小部件
@@ -116,10 +109,6 @@ keywords: ["preview URLs", "pull request previews", "branch previews", "staging
1. 在控制台的 [常规](https://app.mintlify.com/settings/project/general) 页面，进入 **Previews** 部分。
2. 点击 **Preview authentication** 开关以启用或禁用预览认证。
-
-
-
-
-
-
### 为单个预览设置密码保护
@@ -132,10 +121,6 @@ keywords: ["preview URLs", "pull request previews", "branch previews", "staging
3. 选择 **Create custom preview**。
4. 输入要预览的 branch 名称。
5. 开启 **Make private** 并输入密码。密码必须至少为 8 个字符。
-
-
-
-
6. 选择 **Create preview**。
@@ -89,16 +70,8 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx";
3. 新建一个 Origin，并将你的预发布 URL 填入 “Origin domain”。
-
- 
-
-
你现在应当有两个 Origins：一个为 `[SUBDOMAIN].mintlify.site`，另一个为你的预发布 URL。
-
- 
-
-
```js Format
@@ -52,10 +52,6 @@ Mintlify 会将你内容目录中的任何 `.js` 文件包含到站点的每个
将 `.mintlify.site/` 添加为一条 managed rule。
-
-
-
-
这可确保所有由 Mintlify 提供的资产 (包括图片、样式表和其他文档资源) 被视为必要内容，即使 Osano 阻止未分类的第三方内容时也会加载。
diff --git a/zh/optimize/feedback.mdx b/zh/optimize/feedback.mdx
index c75f3d9ac0..be0757cde3 100644
--- a/zh/optimize/feedback.mdx
+++ b/zh/optimize/feedback.mdx
@@ -1,5 +1,6 @@
---
title: "收集来自用户和 AI 智能体的页面反馈"
+sidebarTitle: "反馈"
description: "启用反馈小部件、页面评分、上下文备注、代码片段反应以及智能体反馈，帮助你发现并修复文档中的问题。"
keywords: ["user feedback", "thumbs rating", "contextual", "satisfaction", "agents"]
boost: 3
@@ -9,7 +10,7 @@ boost: 3
反馈功能需要 [Pro 或 Enterprise 套餐](https://mintlify.com/pricing?ref=feedback)。
-[分析](https://app.mintlify.com/analytics)页面的反馈部分显示您的页面从用户那里收到的定量点赞与点踩投票,以及用户提供的任何定性反馈。使用这些信息来评估内容质量并进行改进。
+[分析](https://app.mintlify.com/analytics)页面的反馈部分显示您的页面从用户那里收到的定量点赞与点踩投票,以及用户提供的任何定性反馈。柱状图显示随时间变化的反馈，下方的视图列出具体的反馈条目。使用这些信息来评估内容质量并进行改进。
查看您的反馈数据可以:
@@ -49,20 +50,6 @@ boost: 3
* **Contextual feedback**:关于页面内容的自由格式反馈。可以选择启用电子邮件收集,允许用户在提交反馈时提供其电子邮件地址。
* **Code snippet feedback**:专门针对代码片段的反馈。
-
-
-
-
-
-
-
-
-
较高的值会在每次查询中呈现更多匹配，这对覆盖主题广泛、用户期望浏览许多候选项的站点很有用。较低的值会让结果面板保持紧凑，并促使用户关注排名最高的匹配项。
-
-
6. 选择 **Create preview**。
diff --git a/zh/deploy/route53-cloudfront.mdx b/zh/deploy/route53-cloudfront.mdx
index 914e03c432..bebc99dd8c 100644
--- a/zh/deploy/route53-cloudfront.mdx
+++ b/zh/deploy/route53-cloudfront.mdx
@@ -45,23 +45,9 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx";
1. 在 AWS 控制台中前往 [CloudFront](https://aws.amazon.com/cloudfront)。
2. 选择 **Create distribution**。
-
-
- 
-
-
3. 在 Origin domain 中输入 `[SUBDOMAIN].mintlify.site`，其中 `[SUBDOMAIN]` 是你项目的唯一子域。
-
-
- 
-
-
4. 在 “Web Application Firewall (WAF)” 中，启用安全防护。
-
- 
-
-
WAF 规则可能会阻止 Mintlify 用于分析和其他交互功能的 `POST` 请求。如果启用 WAF 后仪表板中不再显示分析数据，请检查 WAF 日志中是否有指向 `/docs/_mintlify/` 下路径的被阻止请求。
@@ -74,11 +60,6 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx";
1. 创建分发后，前往 “Origins” 标签页。
-
-
- 
-
-
2. 找到与你主域名对应的预发布环境 URL。具体取决于你的落地页托管服务。例如，Mintlify 的预发布 URL 是 [mintlify-landing-page.vercel.app](https://mintlify-landing-page.vercel.app)。
## 设置行为
@@ -109,11 +82,6 @@ CloudFront 中的行为用于控制子路径逻辑。总体而言，我们希望
- **如果用户访问其他任意页面**，跳转到当前登录页。
1. 打开 CloudFront 分配的 “Behaviors” 标签页。
-
-
- 
-
-
2. 点击 **Create behavior** 按钮，并创建以下行为。
@@ -124,10 +92,6 @@ CloudFront 中的行为用于控制子路径逻辑。总体而言，我们希望
在 "Cache policy" 中选择 **CachingDisabled**，以确保这些验证请求直通且不被缓存。
-
- 
-
-
如果 `.well-known/*` 过于宽泛，你至少可以为 Vercel 将其细化为 2 个行为：
- `/.well-known/vercel/*` - Vercel 域名验证所必需
@@ -149,10 +113,6 @@ CloudFront 中的行为用于控制子路径逻辑。总体而言，我们希望
CloudFront 默认只允许 `GET` 和 `HEAD` 请求。如果你不允许所有 HTTP 方法，CloudFront 会拒绝 Mintlify 用于分析的 `POST` 请求，即使你的文档可以正常加载，仪表板中也不会显示任何页面浏览量。
-
- 
-
-
-
+
分支指向存储库中的某个特定提交。你的线上文档是从部署用分支构建的。你可以创建任意数量的其他分支，这些分支上的更改尚未发布到线上文档。如果你想把某个分支的更改合并进线上文档，可以通过拉取请求 (PR；亦称“合并请求”/Merge Request) 将该分支合并到部署用分支。
使用分支可以在不影响线上文档的情况下进行修改、安全试验新功能，并在发布前获取评审。
-
+
将某个存储库的完整副本下载到你的电脑上，包括所有文件和完整历史。克隆后，你会获得在本地工作所需的一切。
```bash
@@ -74,27 +74,27 @@ Git 为管理文档提供了一些关键功能。
```
-
+
在特定时间点保存的更改快照。每个提交都包含一条描述更改内容的消息，并在项目历史中创建一条永久记录。
-
+
当两个人以不同方式修改了文件的同一部分时就会发生冲突。Git 会要求你手动选择保留哪一处修改，或者将两处修改合并。
-
+
你的项目的主分支。对该分支的更改会自动发布到你的文档站点。通常称为 `main`，但你可以将任意分支设为部署用分支。
-
+
Diff (差异) 用于显示文件两个版本之间的更改。在审查拉取请求时，Diff 会突出显示相较于文件原始版本有哪些不同。
-
+
将一个分支上的更改合并到另一个分支。通常会在评审之后，通过拉取请求将功能开发合并进部署用分支。
-
+
从远程存储库获取最新更改到你的本地副本，使你始终与他人的工作保持同步。
```bash
@@ -102,11 +102,11 @@ Git 为管理文档提供了一些关键功能。
```
-
+
一种提议将某个分支上的更改合并到线上文档的方式。它允许在更改上线之前进行评审和讨论。通常称为 PR，在 GitLab 中也称为 merge request (合并请求) 。
-
+
将你的本地提交发送到远程存储库。这样可以让其他人获取到你的更改，并且可能触发自动部署。
```bash
@@ -114,15 +114,15 @@ Git 为管理文档提供了一些关键功能。
```
-
+
托管在服务器上的存储库版本。本地存储库通过连接远程存储库来推送和拉取更改。
-
+
你的文档源代码，包括构成文档站点页面的所有文件及其历史。Web 编辑器会连接到你的文档存储库以访问和修改 `content`。
-
+
为下一次提交准备特定的更改。暂存可以帮助你将更改组织成逻辑清晰的多次提交。
```bash
diff --git a/zh/integrations/analytics/google-analytics.mdx b/zh/integrations/analytics/google-analytics.mdx
index ce81a91338..2166fd7515 100644
--- a/zh/integrations/analytics/google-analytics.mdx
+++ b/zh/integrations/analytics/google-analytics.mdx
@@ -20,8 +20,6 @@ keywords: ["GA4 integration", "measurement ID", "web stream", "Universal Analyti
点击 Google Analytics 界面左下角的齿轮图标，然后点击 Data Streams。
-
-
创建一个 Web 流，并将你的 Mintlify 文档站点的 URL 作为流的 URL。
你的 Measurement ID 类似于 `G-XXXXXXX`，创建 Web 流后会立即出现在 Stream Details 下方。
diff --git a/zh/integrations/privacy/osano.mdx b/zh/integrations/privacy/osano.mdx
index 03c938499b..3e3bf5019d 100644
--- a/zh/integrations/privacy/osano.mdx
+++ b/zh/integrations/privacy/osano.mdx
@@ -11,7 +11,7 @@ boost: 3
## 设置
-在你的内容目录中的任意位置创建一个名为 `osano.js` 的文件，并填入以下内容。Mintlify 会自动在每个页面上包含内容目录中的任何 `.js` 文件。
+在你的内容目录中创建一个名为 `osano.js` 的文件，并填入以下内容。
### 带通配符的子路径
@@ -193,19 +153,10 @@ CloudFront 中的行为用于控制子路径逻辑。总体而言，我们希望
编辑 `Default (*)` 行为。
-
- 
-
-
1. 将默认行为的 **Origin and origin groups** 更改为预发布环境的 URL（在我们的示例中为 `mintlify-landing-page.vercel.app`）。
+2. 点击 **Save changes**。
-
- 
-
-
-2. 选择 **保存更改**。
-
-
+
- 如果你还没有 Mintlify 账户，请前往 [dashboard.mintlify.com/signup](https://dashboard.mintlify.com/signup) 注册。
+ 如果你还没有 Mintlify 账户，请前往 [app.mintlify.com/signup](https://app.mintlify.com/signup) 注册。
-
+
在 Mintlify 控制台的 [Git settings](https://app.mintlify.com/settings/project/git-settings) 页面中，安装 [Mintlify GitHub 应用](/zh/deploy/github)。如果你已经安装了该应用，请先卸载再重新安装，以便为连接新存储库做好准备。
@@ -67,13 +67,7 @@ Mintlify 的无头模式让你在使用 Mintlify 管理内容的同时，掌控
1. 在 [Git settings](https://app.mintlify.com/settings/project/git-settings) 页面中，选择你通过 starter 模板创建的存储库。
2. 启用 **Set up as monorepo** 开关。
3. 将 `/docs` 填写为包含 `docs.json` 文件的目录路径。
- 4. 点击 **保存更改**。
-
-
-
-
-
-
+ 4. 点击 **Save changes**。
@@ -84,9 +78,9 @@ Mintlify 的无头模式让你在使用 Mintlify 管理内容的同时，掌控
PUBLIC_MINTLIFY_ASSISTANT_KEY=your-assistant-api-key
```
- 你的子域 (subdomain) 是项目的域名部分，即在控制台 URL 中组织名称之后的那一段。比如，如果你的控制台 URL 是 `https://dashboard.mintlify.com/org-name/domain-name`，那么你的子域就是 `domain-name`。
+ 你的子域 (subdomain) 是项目的域名部分，即在控制台 URL 中组织名称之后的那一段。比如，如果你的控制台 URL 是 `https://app.mintlify.com/org-name/domain-name`，那么你的子域就是 `domain-name`。
- 在控制台的 [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) 页面生成一个 AI 助手 API key。该 API key 以 `mint_dsc_` 开头。
+ 在控制台的 [API keys](https://app.mintlify.com/settings/organization/api-keys) 页面生成一个 AI 助手 API key。该 API key 以 `mint_dsc_` 开头。
diff --git a/zh/guides/git-concepts.mdx b/zh/guides/git-concepts.mdx
index 6f597e38a9..0f50c2a66a 100644
--- a/zh/guides/git-concepts.mdx
+++ b/zh/guides/git-concepts.mdx
@@ -60,13 +60,13 @@ Git 为管理文档提供了一些关键功能。
### 检查你是否已正确配置行为
@@ -226,10 +177,6 @@ CloudFront 中的行为用于控制子路径逻辑。总体而言，我们希望
若要测试你的分发，请进入 “General” 标签页并访问 **Distribution domain name** 的 URL。
-
- 
-
-
所有页面都应路由到你的主着陆页。当你在 URL 后追加你选择的子路径（例如 `/docs`）时，该 URL 应会提供你的 Mintlify 文档。
@@ -263,17 +210,7 @@ CloudFront 中的行为用于控制子路径逻辑。总体而言，我们希望
1. 在 AWS 控制台中进入 [Route53](https://aws.amazon.com/route53)。
2. 进入主域名的“Hosted zone”。
3. 选择 **Create record**。
-
-
- 
-
-
4. 打开 `Alias`，然后在 **Route traffic to** 中选择 `Alias to CloudFront distribution` 选项。
-
-
- 
-
-
5. 选择 **Create records**。
diff --git a/zh/guides/custom-frontend.mdx b/zh/guides/custom-frontend.mdx
index aa616ed93f..bf1e686936 100644
--- a/zh/guides/custom-frontend.mdx
+++ b/zh/guides/custom-frontend.mdx
@@ -39,7 +39,7 @@ Mintlify 的无头模式让你在使用 Mintlify 管理内容的同时，掌控
## 先决条件
-* 拥有一个 [Mintlify 账号](https://dashboard.mintlify.com)
+* 拥有一个 [Mintlify 账号](https://app.mintlify.com)
* 拥有一个 [GitHub 账号](https://github.com)
* 安装 [Node.js](https://nodejs.org) v20.17.0 或更高版本 (推荐使用 LTS 版本)
* 熟悉 [Astro](https://docs.astro.build)
@@ -56,10 +56,10 @@ Mintlify 的无头模式让你在使用 Mintlify 管理内容的同时，掌控
-
-
-
+ 4. 点击 **Save changes**。
-
-
-
-
-
-
## 管理反馈
diff --git a/zh/optimize/search.mdx b/zh/optimize/search.mdx
index 128a32e83c..90803ebdb1 100644
--- a/zh/optimize/search.mdx
+++ b/zh/optimize/search.mdx
@@ -116,19 +116,6 @@ searchable: false
在控制台中前往 [常规](https://app.mintlify.com/settings/project/general) 设置页面。在 "搜索" 部分，将 **Results per query** 设置为你想要的值。
-
-
-
-
-
较高的值会在每次查询中呈现更多匹配，这对覆盖主题广泛、用户期望浏览许多候选项的站点很有用。较低的值会让结果面板保持紧凑，并促使用户关注排名最高的匹配项。