diff --git a/es/agent/index.mdx b/es/agent/index.mdx index 6659b5066..6e17efa62 100644 --- a/es/agent/index.mdx +++ b/es/agent/index.mdx @@ -84,6 +84,6 @@ Luego añade el servidor MCP de Mintlify para acceder al dashboard y a otras her Obtén mejores resultados con prompts más específicos. - + Automatiza tareas recurrentes y el mantenimiento de la documentación mediante flujos de trabajo. \ No newline at end of file diff --git a/es/agent/use-cases.mdx b/es/agent/use-cases.mdx index 929bb6bd0..516a86932 100644 --- a/es/agent/use-cases.mdx +++ b/es/agent/use-cases.mdx @@ -84,7 +84,7 @@ Por ejemplo: `@mintlify Users are getting confused by step 3 in the setup guide. Crea flujos de trabajo para automatizar tareas recurrentes y tareas de mantenimiento reactivo, como redactar cambios o actualizar contenido cuando agregas nuevas funcionalidades a tu producto. -Consulta [Workflows](/es/agent/workflows) para obtener más información. +Consulta [Workflows](/workflows/index) para obtener más información.
## Automatiza con la API diff --git a/es/ai-native.mdx b/es/ai-native.mdx index 34abdfaf9..064986951 100644 --- a/es/ai-native.mdx +++ b/es/ai-native.mdx @@ -23,7 +23,7 @@ Además de leer páginas individuales, los usuarios pueden chatear con el [assis El [agente](/es/agent) te ayuda a redactar y mantener la documentación. Crea solicitudes de extracción con cambios propuestos basados en tus indicaciones, solicitudes de extracción y hilos de Slack. Añade el agente a tu espacio de trabajo de Slack para que cualquiera de tu equipo pueda ayudar a mantener la documentación conversando con él. O integra el agente en aplicaciones personalizadas a través de la [API](/es/api/agent/v2/create-agent-job). -Crea [flujos de trabajo](/es/agent/workflows) para ejecutar el agente según una programación o cuando se haga un push a un repositorio. Cada flujo de trabajo define una indicación para el agente y un desencadenador que indica cuándo debe ejecutarse. +Crea [flujos de trabajo](/workflows/index) para ejecutar el agente según una programación o cuando se haga un push a un repositorio. Cada flujo de trabajo define una indicación para el agente y un desencadenador que indica cuándo debe ejecutarse. Configura herramientas populares como [Cursor](/es/guides/cursor), [Claude Code](/es/guides/claude-code) y [Windsurf](/es/guides/windsurf) para que tomen como referencia el esquema de Mintlify, tu guía de estilo y las mejores prácticas. @@ -35,6 +35,16 @@ Tu sitio se optimiza automáticamente para herramientas de IA y motores de búsq Mintlify hospeda los archivos `llms.txt` y `skill.md` para tu documentación. Estos archivos estándar del sector ayudan a los LLMs a responder con eficiencia y relevancia a las consultas de los usuarios y proporcionan una lista de capacidades que los agentes pueden usar, de modo que los usuarios tengan más éxito con tu producto. + + Enseña a tus usuarios cómo instalar tu archivo `skill.md` para que obtengan mejores resultados al usar tu producto con herramientas de IA. Inserta un prompt de instalación directamente en tus docs con el [componente `Prompt`](/es/components/prompt): + + ```mdx + + npx skills add https://your-docs-domain.com + + ``` + + Tu sitio de documentación también ejecuta un servidor MCP (Model Context Protocol) que permite a los usuarios conectar tu documentación directamente con sus herramientas de IA para obtener información actualizada sobre tu producto, justo donde la necesitan. La búsqueda de texto completo y la comprensión semántica ayudan a los usuarios y a las herramientas de IA a encontrar información relevante rápidamente. La búsqueda comprende la intención del usuario en lugar de limitarse a coincidir palabras clave. Y si un usuario se encuentra con un error 404, tu sitio sugiere páginas relacionadas para ayudarle a encontrar lo que busca. No se requiere configuración. @@ -50,7 +60,7 @@ Selecciona cualquiera de las siguientes tarjetas para obtener más información. Configura el assistant para buscar en sitios externos o derivar a las personas a tu equipo de soporte si no puede responder sus preguntas. - + Recibe actualizaciones de la documentación automáticamente en un horario definido o cuando se produzca un evento de push. diff --git a/es/ai/contextual-menu.mdx b/es/ai/contextual-menu.mdx index c19137278..b7847da17 100644 --- a/es/ai/contextual-menu.mdx +++ b/es/ai/contextual-menu.mdx @@ -9,6 +9,10 @@ import IconsRequired from "/snippets/es/icons-required.mdx"; El menú contextual ofrece acceso rápido a contenido optimizado con IA e integraciones directas con herramientas de IA populares. Cuando los usuarios seleccionan el menú contextual en cualquier página, pueden copiar contenido como contexto para herramientas de IA o abrir conversaciones en ChatGPT, Claude, Perplexity, Google AI Studio, Grok, Devin, Windsurf o una herramienta personalizada de su elección, con su documentación ya cargada como contexto. + + Combina el menú contextual con tu archivo [`skill.md`](/es/ai/skillmd) alojado y tu [servidor MCP](/es/ai/model-context-protocol) para que los usuarios puedan instalar todas las capacidades de tu producto en sus herramientas de IA, no solo la página que están leyendo. + + diff --git a/es/ai/model-context-protocol.mdx b/es/ai/model-context-protocol.mdx index 7f0df2de7..5cdbb1b4b 100644 --- a/es/ai/model-context-protocol.mdx +++ b/es/ai/model-context-protocol.mdx @@ -1,5 +1,5 @@ --- -title: "Protocolo de Contexto del Modelo" +title: "Protocolo de Contexto del Modelo (MCP)" description: "Conecta tu documentación y endpoints de API a herramientas de IA como Claude y Cursor con un servidor de Protocolo de Contexto de Modelos (MCP) alojado." keywords: ["MCP", "Herramientas de IA", "Claude", "Cursor"] --- @@ -132,7 +132,7 @@ De forma predeterminada, tu servidor MCP solo está disponible para herramientas Las credenciales de cliente te permiten conectarte a tu servidor MCP autenticado de forma programática sin un inicio de sesión basado en el navegador. Usa las credenciales de cliente para integraciones del lado del servidor, pipelines de CI/CD, flujos de trabajo automatizados y cualquier entorno donde un usuario no pueda completar un flujo OAuth interactivo. -Las credenciales de cliente se autentican contra el endpoint `/authed/mcp` y devuelven el mismo contenido que un usuario autenticado con acceso a todas las páginas. +Las credenciales de cliente se autentican contra el endpoint `/authed/mcp` y devuelven todo el contenido de las páginas públicas y de las páginas autenticadas que no estén restringidas a grupos específicos. @@ -235,7 +235,9 @@ Para proteger la disponibilidad, Mintlify aplica límites de uso a los servidore Tu servidor MCP busca contenido que Mintlify indexa a partir de tu repositorio de documentación. La forma en que se procesan los archivos y se realiza la indexación de búsqueda determina qué contenido está disponible a través de tu servidor MCP. -En la documentación que requiere autenticación, tu servidor MCP solo indexa las páginas de [grupos de usuarios públicos](/es/deploy/authentication-setup#make-pages-public). En la documentación con autenticación parcial, tu servidor MCP indexa las páginas públicas para usuarios no autenticados y cualquier página incluida en grupos de usuarios públicos. +En la documentación que requiere autenticación, tu servidor MCP indexa las [páginas públicas](/es/deploy/authentication-setup#make-pages-public) y cualquier página a la que un usuario autenticado tenga permiso de acceso según sus [grupos de usuarios](/es/deploy/authentication-setup#restrict-pages-to-specific-user-groups). + +En la documentación con autenticación parcial, los usuarios no autenticados pueden buscar en las páginas públicas. Los usuarios autenticados pueden buscar en las páginas públicas y en cualquier página a la que tengan permiso de acceso según sus grupos de usuarios.
### Procesamiento de archivos con `.mintignore` diff --git a/es/assistant/index.mdx b/es/assistant/index.mdx index 6b49406cc..bfaed6c49 100644 --- a/es/assistant/index.mdx +++ b/es/assistant/index.mdx @@ -1,7 +1,7 @@ --- title: "Assistant" description: "Agrega un asistente de chat impulsado por IA a tu sitio de documentación que responde preguntas de los usuarios, cita fuentes y genera ejemplos de código bajo demanda." -keywords: ["chat", "RAG", "soporte al usuario", "multimodal"] +keywords: ["chat", "soporte al usuario", "multimodal"] boost: 3 --- @@ -15,7 +15,7 @@ boost: 3 El assistant responde preguntas sobre tu documentación mediante consultas en lenguaje natural. Los usuarios acceden al assistant en tu sitio de documentación, para que puedan encontrar respuestas rápidamente y tener éxito con tu producto incluso si no saben dónde buscar. -El assistant utiliza RAG agéntico (generación aumentada por recuperación) con llamadas a herramientas. Cuando los usuarios hacen preguntas, el assistant: +El assistant utiliza llamadas a herramientas para responder preguntas. Cuando los usuarios hacen preguntas, el assistant: * **Busca y recupera** contenido relevante de tu documentación para proporcionar respuestas precisas. * **Construye contexto** a partir de la página que el usuario está viendo cuando hace preguntas. diff --git a/es/changelog.mdx b/es/changelog.mdx index eeb368235..50f3b3f7f 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -103,7 +103,7 @@ noindex: true ## OAuth de GitLab para flujos de trabajo
- Los [flujos de trabajo](/es/agent/workflows) ahora soportan repositorios de GitLab a través de autenticación OAuth. Conecta tu cuenta de GitLab desde el dashboard para usar repositorios de GitLab como fuentes de documentación, repositorios de activación o repositorios de contexto en tus flujos de trabajo. El agente abre merge requests en GitLab de la misma manera que abre pull requests en GitHub. + Los [flujos de trabajo](/workflows) ahora soportan repositorios de GitLab a través de autenticación OAuth. Conecta tu cuenta de GitLab desde el dashboard para usar repositorios de GitLab como fuentes de documentación, repositorios de activación o repositorios de contexto en tus flujos de trabajo. El agente abre merge requests en GitLab de la misma manera que abre pull requests en GitHub.
## Mejoras @@ -189,7 +189,7 @@ noindex: true - Mejoras de UX del CLI: URLs de inicio de sesión en gris para mayor claridad, formato de logs estandarizado y `mint status` ahora muestra la versión del CLI. - Soporte de la extensión OpenAPI `x-group` para organizar endpoints de API en grupos personalizados. - Las líneas horizontales (`
`) ahora son compatibles con el contenido MDX. - - Los [flujos de trabajo](/es/agent/workflows) ahora aparecen en la bandeja de entrada del dashboard para un seguimiento más fácil. La lista de flujos de trabajo también muestra los nombres de los PR para una identificación más rápida. + - Los [flujos de trabajo](/workflows) ahora aparecen en la bandeja de entrada del dashboard para un seguimiento más fácil. La lista de flujos de trabajo también muestra los nombres de los PR para una identificación más rápida. - El comando `mint export` ahora incluye las páginas de referencia de API generadas a partir de especificaciones OpenAPI. - El menú de comandos de barra en el editor ha sido rediseñado con una mejor organización y descubrimiento. - Se mejoró la interfaz del flujo de publicación del editor y la interfaz de creación de páginas. @@ -239,7 +239,7 @@ noindex: true - Se rediseñó la página de configuración del editor con un diseño mejorado y soporte de autoguardado. - Las páginas generadas automáticamente a partir de especificaciones OpenAPI ahora aparecen en el editor web como entradas de solo lectura. - Soporte de video en la [vista previa en vivo](/es/editor/live-preview). Los archivos mp4, webm y mov incrustados ahora se renderizan correctamente durante el desarrollo local. - - Los [flujos de trabajo](/es/agent/workflows) ahora se pueden deshabilitar y volver a habilitar desde el dashboard. + - Los [flujos de trabajo](/workflows) ahora se pueden deshabilitar y volver a habilitar desde el dashboard. - Los análisis del asistente ahora muestran el uso desglosado por fuente (web vs API) en el dashboard. - La búsqueda MCP autenticada ahora filtra correctamente los resultados según los grupos de autenticación del usuario. - Las respuestas del agente de Slack ahora muestran resúmenes de llamadas a herramientas en lugar de llamadas a herramientas sin procesar para una información más clara de lo que el agente está haciendo. @@ -255,7 +255,7 @@ noindex: true - Se corrigió el desplazamiento del diseño causado por la barra de herramientas de selección de texto. - Se corrigió la detección visual de diferencias de badges e iconos en el editor. - Se corrigió que el título y la descripción de OpenAPI no se resolvían para páginas referenciadas por ruta de archivo. - - Se corrigió que el toggle de automerge de [flujos de trabajo](/es/agent/workflows) no se deshabilitaba correctamente cuando se desactivaba. + - Se corrigió que el toggle de automerge de [flujos de trabajo](/workflows) no se deshabilitaba correctamente cuando se desactivaba. - Se corrigió que el API playground incluía campos de objetos opcionales con hijos requeridos en los cuerpos de solicitud generados. - Se corrigió la activación por teclado de la casilla de verificación de selección en la tabla de análisis de feedback. @@ -407,13 +407,13 @@ Invita a múltiples miembros del equipo a tu organización a la vez desde el das ## Plantillas de workflows
-Crea [workflows](/es/agent/workflows) más rápido con plantillas predefinidas en el [dashboard](https://dashboard.mintlify.com/products/workflows). Elige entre plantillas para generación de changelogs, sincronización de documentación de API, borradores de documentación de funcionalidades, detección de enlaces rotos, auditorías de SEO y más. Las plantillas incluyen prompts optimizados y configuraciones de activación para ayudarte a comenzar rápidamente. +Crea [workflows](/workflows) más rápido con plantillas predefinidas en el [dashboard](https://dashboard.mintlify.com/products/workflows). Elige entre plantillas para generación de changelogs, sincronización de documentación de API, borradores de documentación de funcionalidades, detección de enlaces rotos, auditorías de SEO y más. Las plantillas incluyen prompts optimizados y configuraciones de activación para ayudarte a comenzar rápidamente.
## Comando CLI de workflows
-Crea archivos de [workflows](/es/agent/workflows) desde la línea de comandos con el comando CLI `mint workflow`. Los prompts interactivos te guían a través del nombre, el trigger, el contexto y las instrucciones. +Crea archivos de [workflows](/workflows) desde la línea de comandos con el comando CLI `mint workflow`. Los prompts interactivos te guían a través del nombre, el trigger, el contexto y las instrucciones.
## Agent API v2 @@ -502,7 +502,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a ## Flujos de trabajo - Automatiza tareas de documentación con [flujos de trabajo](/es/agent/workflows). Configura automatizaciones programadas o activadas por eventos que ejecutan el agente para actualizar tu documentación. + Automatiza tareas de documentación con [flujos de trabajo](/workflows). Configura automatizaciones programadas o activadas por eventos que ejecutan el agente para actualizar tu documentación. Los flujos de trabajo están en beta y actualmente están disponibles en los [planes Enterprise](https://mintlify.com/pricing). Próximamente también estarán disponibles en los planes Pro. diff --git a/es/cli/index.mdx b/es/cli/index.mdx index 4abc955b8..75678b077 100644 --- a/es/cli/index.mdx +++ b/es/cli/index.mdx @@ -53,6 +53,24 @@ Ejecuta `mint score` para evaluar qué tan bien pueden los agentes navegar por u Ejecuta `mint config` para establecer valores predeterminados persistentes como tu subdominio de documentación y rangos de fechas para comandos de analítica. + + ¿Trabajas en tus docs localmente con una herramienta de codificación con IA? Instala el [skill](/es/ai/skillmd) de Mintlify y el [servidor MCP](/es/ai/model-context-protocol) para que tu editor tenga el contexto que necesita para escribir contenido compatible con Mintlify. + + + +Install the Mintlify skill for context on project structure, components, and documentation best practices: + +npx skills add https://mintlify.com/docs + +Add the Mintlify Docs MCP server for documentation search: + +https://mintlify.com/docs/mcp + +Add the Mintlify MCP server for dashboard access and content management: + +https://mcp.mintlify.com + +
## Próximos pasos
diff --git a/es/cli/install.mdx b/es/cli/install.mdx index a8dfee56a..c2d168933 100644 --- a/es/cli/install.mdx +++ b/es/cli/install.mdx @@ -135,4 +135,17 @@ Para resaltado de sintaxis y formato de código en archivos MDX, recomendamos us **Solución**: Pide a tu administrador de TI que agregue `releases.mintlify.com` a la lista de permitidos de tu red. + + En versiones anteriores a `4.0.1125`, ejecutar `npx mint dev` u otros comandos desde un + repositorio de documentación podía hacer que la CLI se detectara incorrectamente como una + compilación de desarrollo local. Esto provocaba que la CLI apuntara a URLs de `localhost` en + lugar de a la API de producción de Mintlify, lo que generaba errores de conexión o + comportamientos inesperados. + + **Solución**: Actualiza a la última versión de la CLI: + + ```bash + npm i -g mint@latest + ``` + diff --git a/es/customize/custom-domain.mdx b/es/customize/custom-domain.mdx index 353440970..234548d15 100644 --- a/es/customize/custom-domain.mdx +++ b/es/customize/custom-domain.mdx @@ -44,9 +44,25 @@ CNAME | docs | cname.mintlify.builders - Si estás migrando un dominio existente y quieres cero tiempo de inactividad, agrega los registros `TXT` de verificación antes de actualizar tu `CNAME` y espera a que los certificados SSL/TLS estén pre-provisionados antes de hacer el cambio. Cambiar el `CNAME` antes de que se emitan los certificados provoca que las solicitudes HTTPS fallen hasta que se complete el aprovisionamiento. + No agregues ni cambies tu `CNAME` hasta que ambos registros `TXT` de verificación aparezcan como verificados en tu dashboard. Cada uno se muestra con una marca verde cuando el DNS es correcto. El dashboard verifica los registros `TXT` antes de que pueda completarse el aprovisionamiento del certificado. Cambiar el `CNAME` demasiado pronto suele romper HTTPS hasta que finaliza el aprovisionamiento. + + Si estás migrando un dominio existente y quieres cero tiempo de inactividad, publica primero los registros `TXT` de verificación y espera a que aparezcan como verificados y a que TLS se preaprovisione antes de apuntar el `CNAME` a Mintlify. +
+ ### Registros TXT de verificación +
+ +Después de agregar un dominio personalizado, el dashboard muestra dos registros `TXT` que debes añadir en tu proveedor de DNS: + +```text +TXT | _acme-challenge. | +TXT | _cf-custom-hostname. | +``` + +El registro `_acme-challenge` autoriza a Let's Encrypt a emitir un certificado TLS para tu dominio, y el registro `_cf-custom-hostname` verifica que controlas el dominio. + +El dashboard consulta el DNS en segundo plano y marca cada registro con una marca verde una vez que verifica el valor esperado. Después de guardar los registros en tu proveedor de DNS, espera un breve tiempo de propagación antes de que se actualicen los estados.
### Propagación de DNS @@ -54,13 +70,13 @@ CNAME | docs | cname.mintlify.builders Los cambios de DNS suelen tardar entre 1 y 24 horas en propagarse globalmente, aunque en algunos casos pueden tardar hasta 48 horas. Puedes verificar que la configuración de tu DNS sea correcta usando [DNSChecker](https://dnschecker.org). -Una vez que tus registros de DNS estén activos, tu documentación será accesible primero mediante HTTP. HTTPS estará disponible después de que Vercel aprovisione tu certificado TLS. +Una vez que tus registros de DNS estén activos, tu documentación será accesible primero mediante HTTP. HTTPS estará disponible después de que se aprovisione tu certificado TLS.
### Aprovisionamiento automático de TLS
-Una vez que tus registros de DNS se propaguen y se resuelvan correctamente, Vercel aprovisiona automáticamente un certificado SSL/TLS gratuito para tu domain usando Let's Encrypt. +Una vez que se hayan agregado tus registros `TXT` y tus registros de DNS se resuelvan correctamente, se genera automáticamente un certificado SSL/TLS gratuito para tu sitio usando Let's Encrypt. Esto normalmente se completa en unas pocas horas tras la propagación de DNS, aunque en casos poco frecuentes puede tardar hasta 24 horas. Los certificados se renuevan automáticamente antes de su caducidad. @@ -84,15 +100,9 @@ La ruta `/.well-known/acme-challenge` está reservada para la validación de cer ### Configuraciones específicas del proveedor
- - - Si Vercel es tu proveedor de domain, debes añadir un registro `TXT` de verificación. Esta información aparece en tu dashboard después de enviar tu domain personalizado y también se te envía por correo electrónico. - - - - Si Cloudflare es tu proveedor de DNS, debes habilitar el modo "Full (strict)" para la configuración de cifrado SSL/TLS. Además, desactiva "Always Use HTTPS" en la configuración de Edge Certificates. La redirección de HTTPS de Cloudflare impide que Let's Encrypt valide tu domain durante el aprovisionamiento del certificado. - - + + Si Cloudflare es tu proveedor de DNS, debes habilitar el modo "Full (strict)" para la configuración de cifrado SSL/TLS. Además, desactiva "Always Use HTTPS" en la configuración de Edge Certificates. La redirección de HTTPS de Cloudflare impide que Let's Encrypt valide tu domain durante el aprovisionamiento del certificado. +
## Establece una URL canónica diff --git a/es/guides/configure-automerge.mdx b/es/guides/configure-automerge.mdx index 4438cc26e..479ac84c2 100644 --- a/es/guides/configure-automerge.mdx +++ b/es/guides/configure-automerge.mdx @@ -5,7 +5,7 @@ description: "Configura flujos de trabajo de GitHub para fusionar automáticamen keywords: ["automerge", "ruleset", "protección de rama", "bypass"] --- -Agrega la aplicación GitHub de Mintlify a la lista de bypass de un ruleset para que la aplicación pueda crear y fusionar pull requests sin que los requisitos de revisión y verificaciones de estado la bloqueen. Esto te permite configurar [flujos de trabajo](/es/guides/automate-agent) para fusionar automáticamente los cambios a `main`. +Agrega la aplicación GitHub de Mintlify a la lista de bypass de un ruleset para que la aplicación pueda crear y fusionar pull requests sin que los requisitos de revisión y verificaciones de estado la bloqueen. Esto te permite configurar [flujos de trabajo](/workflows/index) para fusionar automáticamente los cambios a `main`. La aplicación GitHub de Mintlify debe tener permisos de bypass en **todos** los rulesets que apunten a tu rama de implementación, incluyendo los rulesets definidos a nivel de organización y a nivel de repositorio. Si algún ruleset no tiene la entrada de bypass, el flujo de trabajo crea un PR, pero no lo fusiona. diff --git a/es/guides/improving-docs.mdx b/es/guides/improving-docs.mdx index e5846eb2f..11a851241 100644 --- a/es/guides/improving-docs.mdx +++ b/es/guides/improving-docs.mdx @@ -123,7 +123,7 @@ Medir solo es útil si impulsa la acción. Algunos enfoques para decidir qué co - **Enfócate en los recorridos clave del usuario.** Identifica las tres a cinco tareas más críticas para el éxito de tu producto y asegúrate de que la documentación que respalda esas tareas sea excelente antes de preocuparte por el resto. - Usa [flujos de trabajo](/es/agent/workflows) para automatizar mejoras recurrentes, como abrir un pull request con correcciones sugeridas para páginas marcadas por puntuaciones de comentarios bajas. + Usa [flujos de trabajo](/workflows) para automatizar mejoras recurrentes, como abrir un pull request con correcciones sugeridas para páginas marcadas por puntuaciones de comentarios bajas.
diff --git a/es/guides/internationalization.mdx b/es/guides/internationalization.mdx index b4044785f..74a51e1b3 100644 --- a/es/guides/internationalization.mdx +++ b/es/guides/internationalization.mdx @@ -326,7 +326,7 @@ Mantén las traducciones precisas y sincronizadas con tu contenido original. ### Traducciones automatizadas
-Para soluciones de traducción automática, [ponte en contacto con el equipo de ventas de Mintlify](mailto:gtm@mintlify.com). +Para soluciones de traducción automática, [configura un workflow](/workflows) para ejecutar el agente de forma programada o en respuesta a cambios enviados al repositorio.
### Proveedores de traducción externos diff --git a/es/guides/maintenance.mdx b/es/guides/maintenance.mdx index 22d77e9ef..7051fb3a3 100644 --- a/es/guides/maintenance.mdx +++ b/es/guides/maintenance.mdx @@ -62,7 +62,7 @@ Rastrear manualmente las fechas de revisión en cientos de páginas no escala. A - Usa [verificaciones de CI](/es/deploy/ci) para aplicar requisitos de frontmatter y detectar enlaces rotos en cada pull request - Usa [workflows](/es/agent/workflows) para ejecutar verificaciones de mantenimiento automatizadas de forma programada: marcando contenido obsoleto, verificando metadatos faltantes o detectando páginas con puntuaciones de retroalimentación consistentemente bajas. + Usa [workflows](/workflows) para ejecutar verificaciones de mantenimiento automatizadas de forma programada: marcando contenido obsoleto, verificando metadatos faltantes o detectando páginas con puntuaciones de retroalimentación consistentemente bajas.
diff --git a/es/guides/navigation.mdx b/es/guides/navigation.mdx index cc1ea7163..944d40c8b 100644 --- a/es/guides/navigation.mdx +++ b/es/guides/navigation.mdx @@ -149,7 +149,7 @@ Una cadencia práctica: - **Revisa la estructura de nivel superior anualmente.** A medida que la documentación crece, lo que funcionaba con 20 páginas puede no funcionar con 200. - Usa [workflows](/es/agent/workflows) para automatizar verificaciones recurrentes como identificar páginas con puntuaciones de retroalimentación bajas o señalar elementos de navegación que rara vez reciben clics. + Usa [workflows](/workflows) para automatizar verificaciones recurrentes como identificar páginas con puntuaciones de retroalimentación bajas o señalar elementos de navegación que rara vez reciben clics. Para configurar la navegación en Mintlify—pestañas, grupos, anclas y orden de páginas—consulta la [referencia de navegación](/es/organize/navigation). diff --git a/es/guides/seo.mdx b/es/guides/seo.mdx index a93b11071..c294887ff 100644 --- a/es/guides/seo.mdx +++ b/es/guides/seo.mdx @@ -148,7 +148,7 @@ Un enfoque práctico: - Comprueba los enlaces rotos con `mint broken-links` antes de publicar - Usa [workflows](/es/agent/workflows) para automatizar tareas de mantenimiento SEO. + Usa [workflows](/workflows) para automatizar tareas de mantenimiento SEO. La documentación desactualizada crea un segundo problema más allá del SEO: si los usuarios encuentran tu página a través de búsqueda pero la información es incorrecta, pierden confianza en tu documentación. diff --git a/es/guides/style-and-tone.mdx b/es/guides/style-and-tone.mdx index 7fcc5180c..7f7180280 100644 --- a/es/guides/style-and-tone.mdx +++ b/es/guides/style-and-tone.mdx @@ -145,7 +145,7 @@ Los principios de escritura solo perduran si son parte de un flujo de trabajo re - **Guías de estilo existentes:** En lugar de escribir reglas desde cero, comienza con una guía establecida. La [Google Developer Documentation Style Guide](https://developers.google.com/style), la [Microsoft Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/) y la [Splunk Style Guide](https://docs.splunk.com/Documentation/StyleGuide/current/StyleGuide/Howtouse) son todas gratuitas y ampliamente utilizadas. - Usa un [workflow](/es/agent/workflows) para ejecutar una auditoría de estilo de forma programada o cada vez que se envíen cambios a tu repositorio de documentación. + Usa un [workflow](/workflows) para ejecutar una auditoría de estilo de forma programada o cada vez que se envíen cambios a tu repositorio de documentación.
diff --git a/es/optimize/feedback.mdx b/es/optimize/feedback.mdx index 64ff9048d..7a1b6f3ce 100644 --- a/es/optimize/feedback.mdx +++ b/es/optimize/feedback.mdx @@ -97,7 +97,7 @@ Utiliza el menú **Filters** para controlar qué comentarios se muestran. Quita Selecciona entre **Ratings by page**, **Detailed feedback** y **Code snippets** según la información que deseas analizar. - **Ratings by page**: Consulta qué páginas tienen más comentarios positivos y negativos. Usa estos datos cuantitativos para identificar las páginas que los usuarios consideran más y menos útiles. -- **Detailed feedback**: Revisa los comentarios abiertos que los usuarios dejan en las páginas para identificar mejoras específicas en páginas concretas. +- **Detailed feedback**: Revisa los comentarios abiertos que los usuarios dejan en las páginas para identificar mejoras específicas en páginas concretas. Detailed feedback solo muestra los comentarios que incluyen información adicional. Las respuestas que solo usan la valoración de pulgar arriba o pulgar abajo sin seleccionar una opción de comentario adicional no aparecen en la vista detallada. - **Code snippets**: Revisa los comentarios abiertos que los usuarios dejan sobre fragmentos de código para identificar mejoras específicas en bloques de código concretos.
diff --git a/es/organize/navigation.mdx b/es/organize/navigation.mdx index 38def1aff..fcc76e854 100644 --- a/es/organize/navigation.mdx +++ b/es/organize/navigation.mdx @@ -782,7 +782,7 @@ Actualmente ofrecemos compatibilidad con los siguientes idiomas para la localiza } ``` -Para traducciones automatizadas, [contacta con nuestro equipo de ventas](mailto:gtm@mintlify.com) para hablar sobre las soluciones disponibles. +Para traducciones automatizadas, [configura un workflow](/workflows) para ejecutar el agente de forma programada o en respuesta a cambios enviados al repositorio.
diff --git a/fr/agent/index.mdx b/fr/agent/index.mdx index a6b1e7021..284a1331b 100644 --- a/fr/agent/index.mdx +++ b/fr/agent/index.mdx @@ -84,6 +84,6 @@ Ajoutez ensuite le serveur MCP Mintlify pour accéder au dashboard et à d'autre Obtenez de meilleurs résultats grâce à des prompts ciblés. - + Automatisez les tâches récurrentes et la maintenance de la documentation à l'aide de workflows. \ No newline at end of file diff --git a/fr/agent/use-cases.mdx b/fr/agent/use-cases.mdx index a9aa30f76..c9802fa11 100644 --- a/fr/agent/use-cases.mdx +++ b/fr/agent/use-cases.mdx @@ -84,7 +84,7 @@ Par exemple : `@mintlify Users are getting confused by step 3 in the setup guid Créez des workflows pour automatiser les tâches récurrentes et les tâches de maintenance réactive, comme la rédaction de journaux des modifications ou la mise à jour du contenu lorsque vous ajoutez de nouvelles fonctionnalités à votre produit. -Consultez [Workflows](/fr/agent/workflows) pour plus d’informations. +Consultez [Workflows](/workflows/index) pour plus d’informations.
## Automatiser avec l'API diff --git a/fr/ai-native.mdx b/fr/ai-native.mdx index ceae6cf20..f949a6dd8 100644 --- a/fr/ai-native.mdx +++ b/fr/ai-native.mdx @@ -23,7 +23,7 @@ En plus de consulter des pages individuelles, les utilisateurs peuvent échanger L’[agent](/fr/agent) vous aide à rédiger et à maintenir votre documentation. Il crée des pull requests (demandes de fusion) avec des modifications proposées à partir de vos instructions, de pull requests et de fils Slack. Ajoutez l’agent à votre espace de travail Slack pour que chacun dans votre équipe puisse contribuer à la maintenance de votre documentation en discutant avec lui. Ou intégrez l’agent à des applications personnalisées via l’[API](/fr/api/agent/v2/create-agent-job). -Créez des [workflows](/fr/agent/workflows) pour exécuter l’agent selon une planification ou lors d’un `push` vers un référentiel. Chaque workflow définit une instruction (prompt) pour l’agent et un déclencheur indiquant quand l’exécuter. +Créez des [workflows](/workflows/index) pour exécuter l’agent selon une planification ou lors d’un `push` vers un référentiel. Chaque workflow définit une instruction (prompt) pour l’agent et un déclencheur indiquant quand l’exécuter. Configurez des outils populaires comme [Cursor](/fr/guides/cursor), [Claude Code](/fr/guides/claude-code) et [Windsurf](/fr/guides/windsurf) pour s’appuyer sur le schéma Mintlify, votre guide de style et les bonnes pratiques. @@ -35,6 +35,16 @@ Votre site est automatiquement optimisé pour les outils d’IA et les moteurs d Mintlify héberge les fichiers `llms.txt` et `skill.md` pour votre documentation. Ces fichiers, standard dans l’industrie, aident les LLM à répondre efficacement avec des informations pertinentes aux requêtes des utilisateurs et fournissent une liste de capacités que les agents peuvent utiliser, afin que les utilisateurs réussissent mieux avec votre produit. + + Apprenez à vos utilisateurs à installer votre fichier `skill.md` pour qu’ils obtiennent de meilleurs résultats lorsqu’ils utilisent votre produit avec des outils d’IA. Intégrez une invite d’installation directement dans votre documentation avec le [composant `Prompt`](/fr/components/prompt) : + + ```mdx + + npx skills add https://your-docs-domain.com + + ``` + + Votre site de documentation héberge également un serveur MCP qui permet aux utilisateurs de connecter votre documentation directement à leurs outils d’IA pour obtenir des informations à jour sur votre produit, là où ils en ont besoin. La recherche en texte intégral et la compréhension sémantique aident les utilisateurs et les outils d’IA à trouver rapidement des informations pertinentes. La recherche comprend l’intention de l’utilisateur plutôt que de simplement faire correspondre des mots-clés. Et si un utilisateur rencontre une erreur 404, votre site suggère des pages pertinentes pour l’aider à trouver ce qu’il recherche. Aucune configuration n’est requise. @@ -50,7 +60,7 @@ Sélectionnez l’une des cartes suivantes pour en savoir plus. Configurez l’Assistant pour rechercher sur des sites externes ou orienter les utilisateurs vers votre équipe d’assistance s’il ne peut pas répondre à leurs questions. - + Recevez automatiquement des mises à jour de la documentation selon une planification définie ou lorsqu’un événement de push se produit. diff --git a/fr/ai/contextual-menu.mdx b/fr/ai/contextual-menu.mdx index 3e485afc8..21f6bfb71 100644 --- a/fr/ai/contextual-menu.mdx +++ b/fr/ai/contextual-menu.mdx @@ -9,6 +9,10 @@ import IconsRequired from "/snippets/fr/icons-required.mdx"; Le menu contextuel offre un accès rapide à un objet optimisé par l’IA et à des intégrations directes avec des outils d’IA populaires. Lorsque les utilisateurs ouvrent le menu contextuel sur n’importe quelle page, ils peuvent copier l’objet comme context pour des outils d’IA ou lancer des conversations dans ChatGPT, Claude, Perplexity, Google AI Studio, Grok, Devin, Windsurf, ou un outil personnalisé de votre choix, avec votre documentation déjà chargée comme context. + + Associez le menu contextuel à votre fichier [`skill.md`](/fr/ai/skillmd) hébergé et à votre [serveur MCP](/fr/ai/model-context-protocol) afin que vos utilisateurs puissent installer dans leurs outils d’IA toutes les capacités de votre produit, et pas seulement la page qu’ils consultent. + + diff --git a/fr/ai/model-context-protocol.mdx b/fr/ai/model-context-protocol.mdx index d103ea3cc..1cda1bbb1 100644 --- a/fr/ai/model-context-protocol.mdx +++ b/fr/ai/model-context-protocol.mdx @@ -1,5 +1,5 @@ --- -title: "Model Context Protocol" +title: "Model Context Protocol (MCP)" description: "Connectez votre documentation et vos endpoints d'API aux outils d'IA comme Claude et Cursor avec un serveur Model Context Protocol (MCP) hébergé." keywords: ["MCP", "AI tools", "Claude", "Cursor"] --- @@ -132,7 +132,7 @@ Par défaut, votre serveur MCP est uniquement disponible pour les outils localho Les identifiants client vous permettent de vous connecter à votre serveur MCP authentifié de manière programmatique, sans connexion via un navigateur. Utilisez les identifiants client pour les intégrations côté serveur, les pipelines CI/CD, les workflows automatisés et tout environnement dans lequel un utilisateur ne peut pas effectuer un flux OAuth interactif. -Les identifiants client s'authentifient auprès de l'endpoint `/authed/mcp` et renvoient le même contenu qu'un utilisateur authentifié ayant accès à toutes les pages. +Les identifiants client s'authentifient auprès de l'endpoint `/authed/mcp` et renvoient l'ensemble du contenu des pages publiques et des pages authentifiées qui ne sont pas restreintes à des groupes spécifiques. @@ -235,7 +235,9 @@ Pour protéger la disponibilité, Mintlify applique des limites de débit aux se Votre serveur MCP recherche le contenu que Mintlify indexe à partir de votre référentiel de documentation. Le traitement des fichiers et l’indexation pour la recherche déterminent quel contenu est disponible via votre serveur MCP. -Pour la documentation nécessitant une authentification, votre serveur MCP indexe uniquement les pages des [groupes d’utilisateurs publics](/fr/deploy/authentication-setup#make-pages-public). Pour la documentation avec authentification partielle, votre serveur MCP indexe les pages publiques pour les utilisateurs non authentifiés ainsi que toutes les pages des groupes d’utilisateurs publics. +Pour la documentation nécessitant une authentification, votre serveur MCP indexe les [pages publiques](/fr/deploy/authentication-setup#make-pages-public) ainsi que toutes les pages auxquelles un utilisateur authentifié a l'autorisation d'accéder en fonction de ses [groupes d'utilisateurs](/fr/deploy/authentication-setup#restrict-pages-to-specific-user-groups). + +Pour la documentation avec authentification partielle, les utilisateurs non authentifiés peuvent rechercher dans les pages publiques. Les utilisateurs authentifiés peuvent rechercher dans les pages publiques ainsi que dans toutes les pages auxquelles ils ont l'autorisation d'accéder en fonction de leurs groupes d'utilisateurs.
### Traitement des fichiers avec `.mintignore` diff --git a/fr/assistant/index.mdx b/fr/assistant/index.mdx index 34f821c88..979494834 100644 --- a/fr/assistant/index.mdx +++ b/fr/assistant/index.mdx @@ -1,7 +1,7 @@ --- title: "Assistant" description: "Ajoutez un assistant de chat alimenté par l'IA à votre site de documentation qui répond aux questions des utilisateurs, cite les sources et génère des exemples de code à la demande." -keywords: ["chat", "RAG", "support utilisateur", "multimodal"] +keywords: ["chat", "support utilisateur", "multimodal"] boost: 3 --- @@ -15,7 +15,7 @@ boost: 3 L'assistant répond aux questions sur votre documentation par des requêtes en langage naturel. Les utilisateurs accèdent à l'assistant sur votre site de documentation, afin de trouver des réponses rapidement et d'utiliser votre produit avec succès même s'ils ne savent pas où chercher. -L'assistant utilise le RAG agentique (génération augmentée par la récupération) avec appel d'outils. Lorsque les utilisateurs posent des questions, l'assistant : +L'assistant utilise l'appel d'outils pour répondre aux questions. Lorsque les utilisateurs posent des questions, l'assistant : * **Recherche et récupère** le contenu pertinent de votre documentation pour fournir des réponses précises. * **Construit le contexte** à partir de la page que l'utilisateur consulte lorsqu'il pose des questions. diff --git a/fr/changelog.mdx b/fr/changelog.mdx index cf9ef9c10..af923b96c 100644 --- a/fr/changelog.mdx +++ b/fr/changelog.mdx @@ -103,7 +103,7 @@ noindex: true ## OAuth GitLab pour les workflows
- Les [workflows](/fr/agent/workflows) prennent désormais en charge les dépôts GitLab via l'authentification OAuth. Connectez votre compte GitLab depuis le tableau de bord pour utiliser les dépôts GitLab comme sources de documentation, dépôts déclencheurs ou dépôts de contexte dans vos workflows. L'agent ouvre des merge requests sur GitLab de la même manière qu'il ouvre des pull requests sur GitHub. + Les [workflows](/workflows) prennent désormais en charge les dépôts GitLab via l'authentification OAuth. Connectez votre compte GitLab depuis le tableau de bord pour utiliser les dépôts GitLab comme sources de documentation, dépôts déclencheurs ou dépôts de contexte dans vos workflows. L'agent ouvre des merge requests sur GitLab de la même manière qu'il ouvre des pull requests sur GitHub.
## Améliorations @@ -189,7 +189,7 @@ noindex: true - Améliorations UX du CLI : URLs de connexion grisées pour plus de clarté, formatage des logs standardisé, et `mint status` affiche désormais la version du CLI. - Support de l'extension OpenAPI `x-group` pour organiser les endpoints API en groupes personnalisés. - Les lignes horizontales (`
`) sont désormais prises en charge dans le contenu MDX. - - Les [workflows](/fr/agent/workflows) apparaissent désormais dans la boîte de réception du tableau de bord pour un suivi plus facile. La liste des workflows affiche également les noms des PR pour une identification plus rapide. + - Les [workflows](/workflows) apparaissent désormais dans la boîte de réception du tableau de bord pour un suivi plus facile. La liste des workflows affiche également les noms des PR pour une identification plus rapide. - La commande `mint export` inclut désormais les pages de référence API générées à partir des spécifications OpenAPI. - Le menu de commandes slash dans l'éditeur a été repensé avec une meilleure organisation et découvrabilité. - Amélioration de l'interface du flux de publication de l'éditeur et de l'interface de création de pages. @@ -239,7 +239,7 @@ noindex: true - Refonte de la page de paramètres de configuration de l'éditeur avec une mise en page améliorée et le support de la sauvegarde automatique. - Les pages générées automatiquement à partir des spécifications OpenAPI apparaissent désormais dans l'éditeur web comme des entrées en lecture seule. - Support vidéo dans l'[aperçu en direct](/fr/editor/live-preview). Les fichiers mp4, webm et mov intégrés s'affichent désormais correctement pendant le développement local. - - Les [workflows](/fr/agent/workflows) peuvent désormais être désactivés et réactivés depuis le tableau de bord. + - Les [workflows](/workflows) peuvent désormais être désactivés et réactivés depuis le tableau de bord. - Les analyses de l'assistant affichent désormais l'utilisation ventilée par source (web vs API) dans le tableau de bord. - La recherche MCP authentifiée filtre désormais correctement les résultats en fonction des groupes d'authentification de l'utilisateur. - Les réponses de l'agent Slack affichent désormais des résumés d'appels d'outils au lieu d'appels d'outils bruts pour une information plus claire sur ce que fait l'agent. @@ -255,7 +255,7 @@ noindex: true - Correction du décalage de mise en page causé par l'infobulle de sélection de texte. - Correction de la détection visuelle des différences de badges et d'icônes dans l'éditeur. - Correction du titre et de la description OpenAPI qui ne se résolvaient pas pour les pages référencées par chemin de fichier. - - Correction du toggle d'automerge des [workflows](/fr/agent/workflows) qui ne se désactivait pas correctement lorsqu'il était mis sur off. + - Correction du toggle d'automerge des [workflows](/workflows) qui ne se désactivait pas correctement lorsqu'il était mis sur off. - Correction du playground API incluant des champs d'objets optionnels avec des enfants requis dans les corps de requête générés. - Correction de l'activation clavier de la case à cocher de sélection dans le tableau d'analyse des retours. @@ -407,13 +407,13 @@ Invitez plusieurs membres de l'équipe dans votre organisation en une seule fois ## Modèles de workflows
-Créez des [workflows](/fr/agent/workflows) plus rapidement grâce aux modèles prédéfinis dans le [tableau de bord](https://dashboard.mintlify.com/products/workflows). Choisissez parmi des modèles pour la génération de changelogs, la synchronisation de documentation d'API, les ébauches de documentation de fonctionnalités, la détection de liens cassés, les audits SEO et plus encore. Les modèles incluent des prompts optimisés et des configurations de déclenchement pour vous aider à démarrer rapidement. +Créez des [workflows](/workflows) plus rapidement grâce aux modèles prédéfinis dans le [tableau de bord](https://dashboard.mintlify.com/products/workflows). Choisissez parmi des modèles pour la génération de changelogs, la synchronisation de documentation d'API, les ébauches de documentation de fonctionnalités, la détection de liens cassés, les audits SEO et plus encore. Les modèles incluent des prompts optimisés et des configurations de déclenchement pour vous aider à démarrer rapidement.
## Commande CLI de workflow
-Créez des fichiers de [workflows](/fr/agent/workflows) depuis la ligne de commande avec la commande CLI `mint workflow`. Des invites interactives vous guident à travers le nom, le déclencheur, le contexte et les instructions. +Créez des fichiers de [workflows](/workflows) depuis la ligne de commande avec la commande CLI `mint workflow`. Des invites interactives vous guident à travers le nom, le déclencheur, le contexte et les instructions.
## Agent API v2 @@ -502,7 +502,7 @@ Consultez les retours ventilés par pages individuelles dans votre tableau de bo ## Workflows - Automatisez les tâches de documentation avec les [workflows](/fr/agent/workflows). Configurez des automatisations planifiées ou déclenchées par des événements qui exécutent l’agent pour mettre à jour votre documentation. + Automatisez les tâches de documentation avec les [workflows](/workflows). Configurez des automatisations planifiées ou déclenchées par des événements qui exécutent l’agent pour mettre à jour votre documentation. Les workflows sont en bêta et actuellement disponibles sur les [offres Enterprise](https://mintlify.com/pricing). Bientôt disponibles sur les offres Pro. diff --git a/fr/cli/index.mdx b/fr/cli/index.mdx index f4b3a7630..8a842c1e6 100644 --- a/fr/cli/index.mdx +++ b/fr/cli/index.mdx @@ -53,6 +53,24 @@ Exécutez `mint score` pour évaluer dans quelle mesure les agents peuvent navig Exécutez `mint config` pour définir des valeurs par défaut persistantes comme votre sous-domaine de documentation et les plages de dates pour les commandes d'analytique. + + Vous travaillez sur votre documentation en local avec un outil de codage IA ? Installez le [skill](/fr/ai/skillmd) Mintlify et le [serveur MCP](/fr/ai/model-context-protocol) pour que votre éditeur dispose du contexte nécessaire pour rédiger du contenu adapté à Mintlify. + + + +Install the Mintlify skill for context on project structure, components, and documentation best practices: + +npx skills add https://mintlify.com/docs + +Add the Mintlify Docs MCP server for documentation search: + +https://mintlify.com/docs/mcp + +Add the Mintlify MCP server for dashboard access and content management: + +https://mcp.mintlify.com + +
## Prochaines étapes
diff --git a/fr/cli/install.mdx b/fr/cli/install.mdx index 40a8a6494..65f178d08 100644 --- a/fr/cli/install.mdx +++ b/fr/cli/install.mdx @@ -135,4 +135,17 @@ Pour la coloration syntaxique et le formatage du code dans les fichiers MDX, nou **Solution** : Demandez à votre administrateur informatique d'ajouter `releases.mintlify.com` à la liste d'autorisation de votre réseau. + + Dans les versions antérieures à `4.0.1125`, l'exécution de `npx mint dev` ou d'autres + commandes depuis un dépôt de documentation pouvait amener la CLI à se détecter + incorrectement comme une compilation de développement local. La CLI pointait alors vers + des URLs `localhost` au lieu de l'API de production Mintlify, ce qui entraînait des + erreurs de connexion ou un comportement inattendu. + + **Solution** : Mettez à jour vers la dernière version de la CLI : + + ```bash + npm i -g mint@latest + ``` + diff --git a/fr/customize/custom-domain.mdx b/fr/customize/custom-domain.mdx index f5d0c8217..20d416ded 100644 --- a/fr/customize/custom-domain.mdx +++ b/fr/customize/custom-domain.mdx @@ -44,9 +44,25 @@ CNAME | docs | cname.mintlify.builders - Si vous migrez un domaine existant et souhaitez aucun temps d'arrêt, ajoutez les enregistrements `TXT` de vérification avant de mettre à jour votre `CNAME`, puis attendez que les certificats SSL/TLS soient pré-provisionnés avant de basculer. Modifier le `CNAME` avant l'émission des certificats entraîne l'échec des requêtes HTTPS jusqu'à la fin du provisionnement. + N'ajoutez pas et ne modifiez pas votre `CNAME` tant que les deux enregistrements `TXT` de vérification n'apparaissent pas comme vérifiés dans votre dashboard. Chacun s'affiche avec une coche verte lorsque le DNS est correct. Le dashboard vérifie les enregistrements `TXT` avant que le provisionnement du certificat puisse aboutir. Modifier le `CNAME` trop tôt casse fréquemment le HTTPS jusqu'à la fin du provisionnement. + + Si vous migrez un domaine existant et souhaitez aucun temps d'arrêt, publiez d'abord les enregistrements `TXT` de vérification et attendez qu'ils apparaissent comme vérifiés et que TLS soit pré-provisionné avant de pointer le `CNAME` vers Mintlify. +
+ ### Enregistrements TXT de vérification +
+ +Après avoir ajouté un domaine personnalisé, le dashboard affiche deux enregistrements `TXT` que vous devez ajouter chez votre fournisseur DNS : + +```text +TXT | _acme-challenge. | +TXT | _cf-custom-hostname. | +``` + +L'enregistrement `_acme-challenge` autorise Let's Encrypt à émettre un certificat TLS pour votre domaine, et l'enregistrement `_cf-custom-hostname` vérifie que vous contrôlez le domaine. + +Le dashboard interroge le DNS en arrière-plan et marque chaque enregistrement d'une coche verte une fois qu'il vérifie la valeur attendue. Après avoir enregistré les enregistrements chez votre fournisseur DNS, prévoyez un court délai de propagation avant que les statuts ne soient mis à jour.
### Propagation du DNS @@ -54,13 +70,13 @@ CNAME | docs | cname.mintlify.builders Les modifications DNS se propagent généralement en 1 à 24 heures dans le monde entier, mais cela peut prendre jusqu’à 48 heures dans certains cas. Vous pouvez vérifier que votre DNS est correctement configuré avec [DNSChecker](https://dnschecker.org). -Une fois vos enregistrements DNS actifs, votre documentation est d’abord accessible en HTTP. Le HTTPS sera disponible après que Vercel aura provisionné votre certificat TLS. +Une fois vos enregistrements DNS actifs, votre documentation est d’abord accessible en HTTP. Le HTTPS sera disponible après le provisionnement de votre certificat TLS.
### Provisionnement automatique de TLS
-Une fois que vos enregistrements DNS ont propagé et se résolvent correctement, Vercel provisionne automatiquement un certificat SSL/TLS gratuit pour votre domaine avec Let's Encrypt. +Une fois vos enregistrements `TXT` ajoutés et vos enregistrements DNS résolus correctement, un certificat SSL/TLS gratuit est automatiquement généré pour votre site avec Let's Encrypt. Cette étape s’achève généralement dans les heures qui suivent la propagation DNS, bien que cela puisse prendre jusqu’à 24 heures dans de rares cas. Les certificats sont automatiquement renouvelés avant leur expiration. @@ -84,15 +100,9 @@ Le chemin `/.well-known/acme-challenge` est réservé à la validation de certif ### Paramètres spécifiques au fournisseur
- - - Si Vercel est votre fournisseur de domaine, vous devez ajouter un enregistrement `TXT` de vérification. Ces informations s’affichent dans votre Dashboard après l’envoi de votre domaine personnalisé et vous sont également envoyées par e‑mail. - - - - Si Cloudflare est votre fournisseur DNS, vous devez activer le mode « Full (strict) » pour le paramètre de chiffrement SSL/TLS. Désactivez également « Always Use HTTPS » dans vos paramètres Edge Certificates. La redirection HTTPS de Cloudflare empêche Let's Encrypt de valider votre domaine lors de la mise à disposition du certificat. - - + + Si Cloudflare est votre fournisseur DNS, vous devez activer le mode « Full (strict) » pour le paramètre de chiffrement SSL/TLS. Désactivez également « Always Use HTTPS » dans vos paramètres Edge Certificates. La redirection HTTPS de Cloudflare empêche Let's Encrypt de valider votre domaine lors de la mise à disposition du certificat. +
## Définir une URL canonique diff --git a/fr/guides/configure-automerge.mdx b/fr/guides/configure-automerge.mdx index 13cc89c9f..62a2d8b51 100644 --- a/fr/guides/configure-automerge.mdx +++ b/fr/guides/configure-automerge.mdx @@ -5,7 +5,7 @@ description: "Configurez des workflows GitHub pour fusionner automatiquement les keywords: ["automerge", "ruleset", "protection de branche", "bypass"] --- -Ajoutez l'application GitHub Mintlify à la liste de contournement d'un ensemble de règles pour que l'application puisse créer et fusionner des pull requests sans que les exigences de révision et de vérification de statut ne la bloquent. Cela vous permet de configurer des [workflows](/fr/guides/automate-agent) pour fusionner automatiquement les modifications dans `main`. +Ajoutez l'application GitHub Mintlify à la liste de contournement d'un ensemble de règles pour que l'application puisse créer et fusionner des pull requests sans que les exigences de révision et de vérification de statut ne la bloquent. Cela vous permet de configurer des [workflows](/workflows/index) pour fusionner automatiquement les modifications dans `main`. L'application GitHub Mintlify doit disposer de permissions de contournement sur **tous** les ensembles de règles ciblant votre branche de déploiement, y compris les ensembles de règles définis au niveau de l'organisation et au niveau du dépôt. Si un ensemble de règles ne contient pas l'entrée de contournement, le workflow crée une PR, mais ne la fusionne pas. diff --git a/fr/guides/improving-docs.mdx b/fr/guides/improving-docs.mdx index 40e154b22..df6fe7d5d 100644 --- a/fr/guides/improving-docs.mdx +++ b/fr/guides/improving-docs.mdx @@ -123,7 +123,7 @@ Mesurer n'est utile que si cela mène à l'action. Voici quelques approches pour - **Concentrez-vous sur les parcours utilisateurs clés.** Identifiez les trois à cinq tâches les plus critiques pour le succès de votre produit et assurez-vous que la documentation soutenant ces tâches est excellente avant de vous préoccuper du reste. - Utilisez les [workflows](/fr/agent/workflows) pour automatiser les améliorations récurrentes — comme ouvrir une pull request avec des corrections suggérées pour les pages signalées par de faibles scores de retours. + Utilisez les [workflows](/workflows) pour automatiser les améliorations récurrentes — comme ouvrir une pull request avec des corrections suggérées pour les pages signalées par de faibles scores de retours.
diff --git a/fr/guides/internationalization.mdx b/fr/guides/internationalization.mdx index 1f17f5f5a..65aafd5de 100644 --- a/fr/guides/internationalization.mdx +++ b/fr/guides/internationalization.mdx @@ -326,7 +326,7 @@ Veillez à ce que vos traductions restent exactes et synchronisées avec votre c ### Traductions automatisées
-Pour des solutions de traduction automatique, [contactez l'équipe commerciale de Mintlify](mailto:gtm@mintlify.com). +Pour des solutions de traduction automatique, [configurez un workflow](/workflows) pour exécuter l'agent selon un calendrier ou en réponse à des pushes vers le dépôt.
### Prestataires de traduction externes diff --git a/fr/guides/maintenance.mdx b/fr/guides/maintenance.mdx index dc65384db..5cb3d5af8 100644 --- a/fr/guides/maintenance.mdx +++ b/fr/guides/maintenance.mdx @@ -62,7 +62,7 @@ Suivre manuellement les dates de révision sur des centaines de pages n'est pas - Utilisez les [vérifications CI](/fr/deploy/ci) pour appliquer les exigences de frontmatter et détecter les liens cassés à chaque pull request - Utilisez les [workflows](/fr/agent/workflows) pour exécuter des vérifications de maintenance automatisées selon un calendrier — signalant le contenu obsolète, vérifiant les métadonnées manquantes ou détectant les pages avec des scores de retour constamment bas. + Utilisez les [workflows](/workflows) pour exécuter des vérifications de maintenance automatisées selon un calendrier — signalant le contenu obsolète, vérifiant les métadonnées manquantes ou détectant les pages avec des scores de retour constamment bas.
diff --git a/fr/guides/navigation.mdx b/fr/guides/navigation.mdx index d45f6359a..877dffcf4 100644 --- a/fr/guides/navigation.mdx +++ b/fr/guides/navigation.mdx @@ -149,7 +149,7 @@ Une cadence pratique : - **Réexaminez la structure de niveau supérieur annuellement.** À mesure que la documentation grandit, ce qui fonctionnait à 20 pages peut ne plus fonctionner à 200. - Utilisez les [workflows](/fr/agent/workflows) pour automatiser les vérifications récurrentes comme identifier les pages avec de faibles scores de retour ou signaler les éléments de navigation qui reçoivent rarement des clics. + Utilisez les [workflows](/workflows) pour automatiser les vérifications récurrentes comme identifier les pages avec de faibles scores de retour ou signaler les éléments de navigation qui reçoivent rarement des clics. Pour configurer la navigation dans Mintlify — onglets, groupes, ancres et ordre des pages — consultez la [référence de navigation](/fr/organize/navigation). diff --git a/fr/guides/seo.mdx b/fr/guides/seo.mdx index bf2ab2698..8885cf88d 100644 --- a/fr/guides/seo.mdx +++ b/fr/guides/seo.mdx @@ -148,7 +148,7 @@ Une approche pratique : - Vérifiez les liens cassés avec `mint broken-links` avant de publier - Utilisez les [workflows](/fr/agent/workflows) pour automatiser les tâches de maintenance SEO. + Utilisez les [workflows](/workflows) pour automatiser les tâches de maintenance SEO. Une documentation obsolète crée un second problème au-delà du SEO : si les utilisateurs trouvent votre page via la recherche mais que l'information est erronée, ils perdent confiance en votre documentation. diff --git a/fr/guides/style-and-tone.mdx b/fr/guides/style-and-tone.mdx index 1ea3a0a14..ba0eef8f5 100644 --- a/fr/guides/style-and-tone.mdx +++ b/fr/guides/style-and-tone.mdx @@ -145,7 +145,7 @@ Les principes de rédaction ne perdurent que s'ils font partie d'un flux de trav - **Guides de style existants :** Plutôt que d'écrire des règles à partir de zéro, commencez par un guide établi. Le [Google Developer Documentation Style Guide](https://developers.google.com/style), le [Microsoft Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/) et le [Splunk Style Guide](https://docs.splunk.com/Documentation/StyleGuide/current/StyleGuide/Howtouse) sont tous gratuits et largement utilisés. - Utilisez un [workflow](/fr/agent/workflows) pour exécuter un audit de style selon un calendrier ou chaque fois que des modifications sont poussées vers votre dépôt de documentation. + Utilisez un [workflow](/workflows) pour exécuter un audit de style selon un calendrier ou chaque fois que des modifications sont poussées vers votre dépôt de documentation.
diff --git a/fr/optimize/feedback.mdx b/fr/optimize/feedback.mdx index 9634f1b58..382acab47 100644 --- a/fr/optimize/feedback.mdx +++ b/fr/optimize/feedback.mdx @@ -98,7 +98,7 @@ Utilisez le menu **Filters** pour contrôler quels retours sont affichés. Déco Sélectionnez entre **Ratings by page**, **Detailed feedback** et **Code snippets** selon les informations que vous souhaitez analyser. - **Ratings by page** : consultez les pages qui reçoivent le plus de retours positifs et négatifs. Utilisez ces données quantitatives pour identifier les pages que les utilisateurs trouvent les plus et les moins utiles. -- **Detailed feedback** : examinez les retours ouverts que les utilisateurs laissent sur les pages pour identifier des améliorations ciblées sur des pages spécifiques. +- **Detailed feedback** : examinez les retours ouverts que les utilisateurs laissent sur les pages pour identifier des améliorations ciblées sur des pages spécifiques. Detailed feedback n'affiche que les retours comportant des informations supplémentaires. Les soumissions qui utilisent uniquement la note pouce levé ou pouce baissé sans sélectionner d'option de retour supplémentaire n'apparaissent pas dans la vue détaillée. - **Code snippets** : examinez les retours ouverts que les utilisateurs laissent sur les extraits de code pour identifier des améliorations ciblées sur des blocs de code spécifiques.
diff --git a/fr/organize/navigation.mdx b/fr/organize/navigation.mdx index 38353340f..200b46ee4 100644 --- a/fr/organize/navigation.mdx +++ b/fr/organize/navigation.mdx @@ -782,7 +782,7 @@ Nous prenons actuellement en charge les langues suivantes pour la localisation : } ``` -Pour les traductions automatisées, [contactez notre équipe commerciale](mailto:gtm@mintlify.com) afin d’étudier les solutions possibles. +Pour les traductions automatisées, [configurez un workflow](/workflows) pour exécuter l’agent selon un calendrier ou en réponse à des pushes vers le dépôt.
diff --git a/zh/agent/index.mdx b/zh/agent/index.mdx index e99450c9e..2ce38f3ba 100644 --- a/zh/agent/index.mdx +++ b/zh/agent/index.mdx @@ -84,6 +84,6 @@ npx skills add https://mintlify.com/docs 使用更聚焦的提示词以获得更好的效果。 - + 使用工作流自动化重复性任务和文档维护。 \ No newline at end of file diff --git a/zh/agent/use-cases.mdx b/zh/agent/use-cases.mdx index 6f01b4b7b..24f58cdbd 100644 --- a/zh/agent/use-cases.mdx +++ b/zh/agent/use-cases.mdx @@ -84,7 +84,7 @@ agent 可以协助完成多种文档相关任务。以下示例展示了几种 创建工作流，以自动化处理重复性任务和响应式维护任务，例如在你为你的产品添加新功能时撰写更新日志或更新内容。 -参见 [Workflows](/zh/agent/workflows) 了解更多信息。 +参见 [Workflows](/workflows/index) 了解更多信息。
## 使用 API 实现自动化 diff --git a/zh/ai-native.mdx b/zh/ai-native.mdx index 4fb25b21e..92981b4be 100644 --- a/zh/ai-native.mdx +++ b/zh/ai-native.mdx @@ -23,7 +23,7 @@ keywords: ["AI","assistant","agent","llms.txt","MCP","llms-full.txt"] [agent](/zh/agent) 可帮助你撰写和维护文档。它会基于你的提示、拉取请求 (PR；亦称“合并请求”/Merge Request) 以及 Slack 讨论串，创建包含建议更改的拉取请求。将 agent 添加到你的 Slack 工作区，你的团队成员即可通过与 agent 对话协同维护文档。你也可以通过 [API](/zh/api/agent/v2/create-agent-job) 将 agent 嵌入自定义应用。 -创建 [workflows](/zh/agent/workflows)，让 agent 按预设计划或在推送到存储库时运行。每个 workflow 都为 agent 定义提示词以及触发运行的条件。 +创建 [workflows](/workflows/index)，让 agent 按预设计划或在推送到存储库时运行。每个 workflow 都为 agent 定义提示词以及触发运行的条件。 配置常用工具 (如 [Cursor](/zh/guides/cursor)、[Claude Code](/zh/guides/claude-code) 和 [Windsurf](/zh/guides/windsurf)) ，以对齐 Mintlify 架构、你的风格指南和最佳实践。 @@ -35,6 +35,16 @@ keywords: ["AI","assistant","agent","llms.txt","MCP","llms-full.txt"] Mintlify 会为你的文档托管 `llms.txt` 和 `skill.md` 文件。这些行业标准文件帮助大语言模型在响应用户查询时高效返回相关信息，并为智能代理提供可用能力列表，从而让用户在使用你的产品时取得更好的效果。 + + 教用户如何安装你的 `skill.md` 文件，让他们在使用 AI 工具操作你的产品时获得更好的结果。使用 [`Prompt` 组件](/zh/components/prompt)将安装提示直接嵌入到你的文档中： + + ```mdx + + npx skills add https://your-docs-domain.com + + ``` + + 你的文档站点还会托管一个 MCP 服务器，使用户能够将你的文档直接连接到他们的 AI 工具，在他们需要的地方获取关于你产品的最新信息。 全文搜索和语义理解帮助用户和 AI 工具快速找到相关信息。搜索能够理解用户意图，而不仅仅是匹配关键词。如果用户遇到 404 错误，你的网站会推荐相关页面，帮助他们找到所需内容。无需任何配置。 @@ -50,7 +60,7 @@ Mintlify 会为你的文档托管 `llms.txt` 和 `skill.md` 文件。这些行 配置 AI 助手以搜索外部网站，或在其无法回答问题时将用户引导至你的支持团队。 - + 按计划或在发生 push 事件时自动获取文档更新。 diff --git a/zh/ai/contextual-menu.mdx b/zh/ai/contextual-menu.mdx index 5598b21f9..6fdc3e3ad 100644 --- a/zh/ai/contextual-menu.mdx +++ b/zh/ai/contextual-menu.mdx @@ -9,6 +9,10 @@ import IconsRequired from "/snippets/zh/icons-required.mdx"; 上下文菜单可快速访问经 AI 优化的内容，以及与主流 AI 工具的直接集成。用户在任意页面打开上下文菜单时，可以将内容复制为 AI 工具的 context，或在 ChatGPT、Claude、Perplexity、Google AI Studio、Grok、Devin、Windsurf，或你自定义的工具中直接开启对话，并自动加载你的文档作为 context。 + + 将上下文菜单与你托管的 [`skill.md`](/zh/ai/skillmd) 文件以及 [MCP 服务器](/zh/ai/model-context-protocol)结合使用，让用户能将你产品的全部能力安装到他们的 AI 工具中，而不只是他们正在阅读的那一页。 + + diff --git a/zh/ai/model-context-protocol.mdx b/zh/ai/model-context-protocol.mdx index 84dabef82..68aec4ab8 100644 --- a/zh/ai/model-context-protocol.mdx +++ b/zh/ai/model-context-protocol.mdx @@ -1,5 +1,5 @@ --- -title: "Model Context Protocol（模型上下文协议）" +title: "Model Context Protocol (MCP)（模型上下文协议）" description: "通过托管的模型上下文协议（MCP）服务器，将文档和 API 端点连接到 Claude、Cursor 等 AI 工具。" keywords: ["MCP", "AI 工具", "Claude", "Cursor"] --- @@ -132,7 +132,7 @@ Mintlify 会为你的文档生成一个 MCP 服务器，并将其托管在你的 客户端凭据允许你以编程方式连接到你的认证 MCP 服务器，无需基于浏览器的登录。客户端凭据适用于服务端集成、CI/CD 流水线、自动化工作流以及用户无法完成交互式 OAuth 流程的任何环境。 -客户端凭据通过 `/authed/mcp` 端点进行认证，并返回与拥有所有页面访问权限的已认证用户相同的内容。 +客户端凭据通过 `/authed/mcp` 端点进行认证，并返回所有公开页面以及未限制为特定用户组的认证页面的全部内容。 @@ -235,7 +235,9 @@ Mintlify 会为你的文档生成一个 MCP 服务器，并将其托管在你的 你的 MCP 服务器会搜索 Mintlify 从你的文档存储库中索引编入的内容。文件处理和搜索索引编入控制了通过你的 MCP 服务器可用的内容。 -对于需要身份验证的文档，你的 MCP 服务器只会索引编入[公开用户组](/zh/deploy/authentication-setup#make-pages-public)中的页面。对于采用部分身份验证的文档，你的 MCP 服务器会为未经身份验证的用户索引编入公开页面，以及公开用户组中的任何页面。 +对于需要身份验证的文档，你的 MCP 服务器会索引[公开页面](/zh/deploy/authentication-setup#make-pages-public)以及已认证用户根据其[用户组](/zh/deploy/authentication-setup#restrict-pages-to-specific-user-groups)有权访问的所有页面。 + +对于采用部分身份验证的文档，未认证用户可以搜索公开页面。已认证用户可以搜索公开页面以及他们根据其用户组有权访问的所有页面。
### 使用 `.mintignore` 进行文件处理 diff --git a/zh/assistant/index.mdx b/zh/assistant/index.mdx index 7e6eaccd7..00385cde5 100644 --- a/zh/assistant/index.mdx +++ b/zh/assistant/index.mdx @@ -1,7 +1,7 @@ --- title: "AI 助手" description: "为你的文档站点添加由 AI 驱动的聊天助手，回答用户问题、引用来源并按需生成代码示例。" -keywords: ["聊天", "RAG", "用户支持", "多模态"] +keywords: ["聊天", "用户支持", "多模态"] boost: 3 --- @@ -15,7 +15,7 @@ boost: 3 AI 助手通过自然语言查询回答有关你文档的问题。用户可以在你的文档站点上使用 AI 助手，快速找到答案，即使不知道在哪里查找也能成功使用你的产品。 -AI 助手使用带工具调用的 Agentic RAG（检索增强生成）。当用户提问时，AI 助手会： +AI 助手使用工具调用来回答问题。当用户提问时，AI 助手会： * **搜索并检索**文档中的相关内容，提供准确的答案。 * **构建上下文**，基于用户提问时正在查看的页面。 diff --git a/zh/changelog.mdx b/zh/changelog.mdx index b6e19fd23..5e45f9fb4 100644 --- a/zh/changelog.mdx +++ b/zh/changelog.mdx @@ -103,7 +103,7 @@ noindex: true ## 工作流的 GitLab OAuth
- [工作流](/zh/agent/workflows)现在通过 OAuth 身份验证支持 GitLab 仓库。从仪表板连接你的 GitLab 账户，以便在工作流中使用 GitLab 仓库作为文档源、触发仓库或上下文仓库。Agent 在 GitLab 上创建 merge request，就像在 GitHub 上创建 pull request 一样。 + [工作流](/workflows)现在通过 OAuth 身份验证支持 GitLab 仓库。从仪表板连接你的 GitLab 账户，以便在工作流中使用 GitLab 仓库作为文档源、触发仓库或上下文仓库。Agent 在 GitLab 上创建 merge request，就像在 GitHub 上创建 pull request 一样。
## 改进 @@ -189,7 +189,7 @@ noindex: true - CLI 用户体验改进：登录 URL 显示为灰色以提高清晰度、标准化日志格式，以及 `mint status` 现在显示 CLI 版本。 - 支持 OpenAPI `x-group` 扩展，用于将 API 端点组织到自定义分组中。 - MDX 内容现在支持水平分割线（`
`）。 - - [工作流](/zh/agent/workflows)现在会在仪表板收件箱中显示，便于跟踪。工作流列表还会显示 PR 名称以便快速识别。 + - [工作流](/workflows)现在会在仪表板收件箱中显示，便于跟踪。工作流列表还会显示 PR 名称以便快速识别。 - `mint export` 命令现在包含从 OpenAPI 规范生成的 API 参考页面。 - 编辑器中的斜杠命令菜单已重新设计，改进了组织和可发现性。 - 改进了编辑器发布流程和页面创建界面的 UI。 @@ -239,7 +239,7 @@ noindex: true - 重新设计了编辑器配置设置页面，改进了布局并支持自动保存。 - 从 OpenAPI 规范自动生成的页面现在以只读条目的形式显示在 Web 编辑器中。 - [实时预览](/zh/editor/live-preview)中的视频支持。嵌入的 mp4、webm 和 mov 文件现在在本地开发期间可以正确渲染。 - - [工作流](/zh/agent/workflows)现在可以从仪表板禁用和重新启用。 + - [工作流](/workflows)现在可以从仪表板禁用和重新启用。 - 助手分析现在在仪表板中显示按来源（Web 与 API）分类的使用情况。 - 经过身份验证的 MCP 搜索现在可以根据用户的身份验证组正确过滤结果。 - Slack agent 响应现在显示工具调用摘要，而不是原始工具调用，以更清晰地展示 agent 正在执行的操作。 @@ -255,7 +255,7 @@ noindex: true - 修复了文本选择工具提示导致的布局偏移。 - 修复了编辑器中 badge 和图标视觉差异检测的问题。 - 修复了通过文件路径引用的页面的 OpenAPI 标题和描述无法解析的问题。 - - 修复了[工作流](/zh/agent/workflows)自动合并开关在设置为关闭时无法正确禁用的问题。 + - 修复了[工作流](/workflows)自动合并开关在设置为关闭时无法正确禁用的问题。 - 修复了 API playground 在生成的请求体中包含带有必需子项的可选对象字段的问题。 - 修复了反馈分析表选择复选框的键盘激活问题。 @@ -407,13 +407,13 @@ noindex: true ## Workflow 模板
-使用 [dashboard](https://dashboard.mintlify.com/products/workflows) 中的预置模板更快地创建 [workflows](/zh/agent/workflows)。可选择的模板包括：changelog 生成、API 文档同步、功能文档草稿、断链检测、SEO 审计等。模板包含优化的 prompt 和触发器配置，帮助你快速上手。 +使用 [dashboard](https://dashboard.mintlify.com/products/workflows) 中的预置模板更快地创建 [workflows](/workflows)。可选择的模板包括：changelog 生成、API 文档同步、功能文档草稿、断链检测、SEO 审计等。模板包含优化的 prompt 和触发器配置，帮助你快速上手。
## Workflow CLI 命令
-使用 `mint workflow` CLI 命令从命令行创建 [workflows](/zh/agent/workflows) 文件。交互式提示将引导你完成名称、触发器、上下文和指令的配置。 +使用 `mint workflow` CLI 命令从命令行创建 [workflows](/workflows) 文件。交互式提示将引导你完成名称、触发器、上下文和指令的配置。
## Agent API v2 @@ -502,7 +502,7 @@ noindex: true ## Workflows - 使用[workflows](/zh/agent/workflows)自动化文档相关任务。你可以配置定时或事件触发的自动化流程，由 agent 运行以更新你的文档。 + 使用[workflows](/workflows)自动化文档相关任务。你可以配置定时或事件触发的自动化流程，由 agent 运行以更新你的文档。 Workflows 目前处于测试阶段，现已在 [Enterprise 套餐](https://mintlify.com/pricing) 中提供，很快也将支持 Pro 套餐。 diff --git a/zh/cli/index.mdx b/zh/cli/index.mdx index 2a73fcf43..ec4dc194a 100644 --- a/zh/cli/index.mdx +++ b/zh/cli/index.mdx @@ -53,6 +53,24 @@ CLI 在你的本地机器上运行，在需要实时数据时连接到你的 Min 运行 `mint config` 设置持久的默认值，如文档子域名和分析命令的日期范围。 + + 使用 AI 编程工具在本地开发文档？安装 Mintlify [skill](/zh/ai/skillmd) 和 [MCP 服务器](/zh/ai/model-context-protocol)，让你的编辑器具备编写符合 Mintlify 规范内容所需的上下文。 + + + +Install the Mintlify skill for context on project structure, components, and documentation best practices: + +npx skills add https://mintlify.com/docs + +Add the Mintlify Docs MCP server for documentation search: + +https://mintlify.com/docs/mcp + +Add the Mintlify MCP server for dashboard access and content management: + +https://mcp.mintlify.com + +
## 后续步骤
diff --git a/zh/cli/install.mdx b/zh/cli/install.mdx index d12766478..33d6870fc 100644 --- a/zh/cli/install.mdx +++ b/zh/cli/install.mdx @@ -135,4 +135,15 @@ mint update **解决方案**：请你的 IT 管理员将 `releases.mintlify.com` 添加到网络允许列表中。 + + 在 `4.0.1125` 之前的版本中，从文档仓库运行 `npx mint dev` 或其他命令时，CLI 可能会 + 将自身错误地识别为本地开发构建。这会导致 CLI 指向 `localhost` URL 而不是 Mintlify + 生产 API，从而引发连接错误或意外行为。 + + **解决方案**：更新到最新的 CLI 版本： + + ```bash + npm i -g mint@latest + ``` + diff --git a/zh/customize/custom-domain.mdx b/zh/customize/custom-domain.mdx index 08c252d34..3da364fd2 100644 --- a/zh/customize/custom-domain.mdx +++ b/zh/customize/custom-domain.mdx @@ -44,9 +44,25 @@ CNAME | docs | cname.mintlify.builders - 如果你正在迁移现有域名并希望实现零停机，请先添加验证用的 `TXT` 记录，再更新 `CNAME`，并等待 SSL/TLS 证书预配置完成后再进行切换。如果在证书签发之前就更改 `CNAME`，HTTPS 请求将会失败，直到证书配置完成。 + 在两条验证 `TXT` 记录都在你的 dashboard 中显示为已验证之前，请勿添加或更改 `CNAME`。当 DNS 配置正确时，每条记录都会显示绿色对勾。dashboard 会先验证 `TXT` 记录，证书才能完成签发。过早切换 `CNAME` 通常会导致 HTTPS 中断，直到签发完成。 + + 如果你正在迁移现有域名并希望实现零停机，请先发布验证 `TXT` 记录，待其显示为已验证且 TLS 完成预签发后，再将 `CNAME` 指向 Mintlify。 +
+ ### 验证 TXT 记录 +
+ +添加自定义域名后，dashboard 会显示两条 `TXT` 记录，你必须在你的 DNS 提供商处添加： + +```text +TXT | _acme-challenge.<你的域名> | +TXT | _cf-custom-hostname.<你的域名> | +``` + +`_acme-challenge` 记录授权 Let's Encrypt 为你的域名签发 TLS 证书，`_cf-custom-hostname` 记录用于验证你确实拥有该域名的控制权。 + +dashboard 会在后台轮询 DNS，并在验证到预期值后用绿色对勾标记每条记录。在 DNS 提供商处保存记录后，请等待短暂的传播时间，状态才会更新。
### DNS 传播 @@ -54,13 +70,13 @@ CNAME | docs | cname.mintlify.builders DNS 变更通常需要 1–24 小时在全球范围内生效，某些情况下可能长达 48 小时。你可以使用 [DNSChecker](https://dnschecker.org) 验证 DNS 是否配置正确。 -DNS 记录生效后，你的文档最初将通过 HTTP 提供访问。Vercel 配置好你的 TLS 证书后，HTTPS 将可用。 +DNS 记录生效后，你的文档最初将通过 HTTP 提供访问。TLS 证书签发完成后，HTTPS 将可用。
### 自动配置 TLS
-当你的 DNS（域名系统）记录完成传播并能正确解析后，Vercel 会使用 Let's Encrypt 为你的 domain 自动签发免费的 SSL/TLS 证书。 +在你添加 `TXT` 记录后，当 DNS（域名系统）记录能够正确解析时，系统会使用 Let's Encrypt 为你的站点自动签发免费的 SSL/TLS 证书。 通常在 DNS 传播后的数小时内即可完成，极少数情况下可能需要长达 24 小时。证书会在到期前自动续期。 @@ -84,15 +100,9 @@ DNS 记录生效后，你的文档最初将通过 HTTP 提供访问。Vercel 配 ### 特定服务商设置
- - - 如果 Vercel 是你的域名服务商，你需要添加一个用于验证的 `TXT` 记录。提交自定义域名后，这些信息会显示在你的控制台中，并通过电子邮件发送给你。 - - - - 如果 Cloudflare 是你的 DNS（域名系统）服务商，你需要在 SSL/TLS 加密设置中启用“Full (strict)”模式。此外，请在 Edge Certificates 设置中禁用“Always Use HTTPS”。Cloudflare 的 HTTPS 重定向会在证书配置期间阻止 Let's Encrypt 验证你的域名。 - - + + 如果 Cloudflare 是你的 DNS（域名系统）服务商，你需要在 SSL/TLS 加密设置中启用“Full (strict)”模式。此外，请在 Edge Certificates 设置中禁用“Always Use HTTPS”。Cloudflare 的 HTTPS 重定向会在证书配置期间阻止 Let's Encrypt 验证你的域名。 +
## 设置规范 URL diff --git a/zh/guides/configure-automerge.mdx b/zh/guides/configure-automerge.mdx index ea0319fc4..277b8217b 100644 --- a/zh/guides/configure-automerge.mdx +++ b/zh/guides/configure-automerge.mdx @@ -5,7 +5,7 @@ description: "通过将 Mintlify 机器人添加到仓库规则集的绕过列 keywords: ["automerge", "ruleset", "分支保护", "bypass"] --- -将 Mintlify GitHub 应用添加到规则集的绕过列表中，使该应用能够创建和合并 pull request 而审查和状态检查要求不会阻止它。这允许你配置[工作流程](/zh/guides/automate-agent)以自动将更改合并到 `main`。 +将 Mintlify GitHub 应用添加到规则集的绕过列表中，使该应用能够创建和合并 pull request 而审查和状态检查要求不会阻止它。这允许你配置[工作流程](/workflows/index)以自动将更改合并到 `main`。 Mintlify GitHub 应用必须对**所有**针对你部署分支的规则集都拥有绕过权限，包括在组织级和仓库级定义的规则集。如果任何规则集缺少绕过条目，工作流程会创建 PR，但不会将其合并。 diff --git a/zh/guides/improving-docs.mdx b/zh/guides/improving-docs.mdx index ef7e39755..d795747c3 100644 --- a/zh/guides/improving-docs.mdx +++ b/zh/guides/improving-docs.mdx @@ -123,7 +123,7 @@ Mintlify 的分析功能让你可以将反馈评分与流量数据一起查看 - **专注于关键用户旅程。** 确定对你产品成功最关键的三到五个任务，并确保支持这些任务的文档在你担心其他内容之前是出色的。 - 使用[工作流](/zh/agent/workflows)来自动化重复性改进——例如为被低反馈评分标记的页面打开包含建议修复的拉取请求。 + 使用[工作流](/workflows)来自动化重复性改进——例如为被低反馈评分标记的页面打开包含建议修复的拉取请求。
diff --git a/zh/guides/internationalization.mdx b/zh/guides/internationalization.mdx index a28393c6e..9837e6b9f 100644 --- a/zh/guides/internationalization.mdx +++ b/zh/guides/internationalization.mdx @@ -326,7 +326,7 @@ docs/ ### 自动化翻译
-如需自动化翻译解决方案，请[联系 Mintlify 销售团队](mailto:gtm@mintlify.com)。 +如需自动化翻译解决方案，[设置工作流](/workflows)，让代理按计划运行或在仓库推送时触发。
### 外部翻译服务商 diff --git a/zh/guides/maintenance.mdx b/zh/guides/maintenance.mdx index 6d9eae492..6de905cfc 100644 --- a/zh/guides/maintenance.mdx +++ b/zh/guides/maintenance.mdx @@ -62,7 +62,7 @@ keywords: ["文档维护", "保持文档更新", "内容生命周期", "过时 - 使用 [CI 检查](/zh/deploy/ci)在每个 pull request 中强制执行 frontmatter 要求并捕获损坏的链接 - 使用 [workflows](/zh/agent/workflows) 按计划运行自动化维护检查——标记过时内容、检查缺失的元数据，或发现反馈评分持续偏低的页面。 + 使用 [workflows](/workflows) 按计划运行自动化维护检查——标记过时内容、检查缺失的元数据，或发现反馈评分持续偏低的页面。
diff --git a/zh/guides/navigation.mdx b/zh/guides/navigation.mdx index b6697ead5..8404a9ed1 100644 --- a/zh/guides/navigation.mdx +++ b/zh/guides/navigation.mdx @@ -149,7 +149,7 @@ keywords: ["文档导航", "信息架构", "文档结构", "侧边栏导航", " - **每年重新审视顶级结构。** 随着文档的增长，在 20 个页面时有效的方式在 200 个页面时可能不再适用。 - 使用 [workflows](/zh/agent/workflows) 来自动化定期检查，例如识别反馈评分低的页面或标记很少被点击的导航项目。 + 使用 [workflows](/workflows) 来自动化定期检查，例如识别反馈评分低的页面或标记很少被点击的导航项目。 要在 Mintlify 中配置导航——选项卡、分组、锚点和页面排序——请参阅[导航参考](/zh/organize/navigation)。 diff --git a/zh/guides/seo.mdx b/zh/guides/seo.mdx index 99e064d2a..fe312571e 100644 --- a/zh/guides/seo.mdx +++ b/zh/guides/seo.mdx @@ -148,7 +148,7 @@ Mintlify 负责多项技术 SEO 基础工作： - 发布前使用 `mint broken-links` 检查损坏的链接 - 使用 [workflows](/zh/agent/workflows) 来自动化 SEO 维护任务。 + 使用 [workflows](/workflows) 来自动化 SEO 维护任务。 过时的文档会在 SEO 之外产生第二个问题：如果用户通过搜索找到你的页面但信息是错误的，他们会对你的文档失去信任。 diff --git a/zh/guides/style-and-tone.mdx b/zh/guides/style-and-tone.mdx index 9e41ab925..96108fb7f 100644 --- a/zh/guides/style-and-tone.mdx +++ b/zh/guides/style-and-tone.mdx @@ -145,7 +145,7 @@ keywords: ["技术写作", "文档风格指南", "写作规范", "语气与文 - **现有风格指南：** 与其从头编写规则，不如从已有的指南开始。[Google Developer Documentation Style Guide](https://developers.google.com/style)、[Microsoft Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/) 和 [Splunk Style Guide](https://docs.splunk.com/Documentation/StyleGuide/current/StyleGuide/Howtouse) 都是免费且广泛使用的。 - 使用 [workflow](/zh/agent/workflows) 按计划运行风格审核，或在每次向文档仓库推送更改时运行。 + 使用 [workflow](/workflows) 按计划运行风格审核，或在每次向文档仓库推送更改时运行。
diff --git a/zh/optimize/feedback.mdx b/zh/optimize/feedback.mdx index 829c789c0..26a86dbd2 100644 --- a/zh/optimize/feedback.mdx +++ b/zh/optimize/feedback.mdx @@ -98,7 +98,7 @@ boost: 3 根据你想分析的信息，在 **Ratings by page**、**Detailed feedback** 和 **Code snippets** 之间进行选择。 - **Ratings by page**：查看哪些页面获得了最多的正面和负面反馈。使用这些量化数据来识别用户认为最有用和最无用的页面。 -- **Detailed feedback**：查看用户在页面上留下的开放式反馈，以便针对特定页面进行有针对性的改进。 +- **Detailed feedback**：查看用户在页面上留下的开放式反馈，以便针对特定页面进行有针对性的改进。Detailed feedback 仅显示包含附加信息的反馈。仅使用赞或踩评分而未选择附加反馈选项的提交不会出现在详细视图中。 - **Code snippets**：查看用户在代码片段上留下的开放式反馈，以便针对特定代码块进行有针对性的改进。
diff --git a/zh/organize/navigation.mdx b/zh/organize/navigation.mdx index 964834785..e38d53fee 100644 --- a/zh/organize/navigation.mdx +++ b/zh/organize/navigation.mdx @@ -783,7 +783,7 @@ Mintlify 使用 `versions` 数组中的第一个版本作为默认版本。使 } ``` -如需自动翻译，请[联系我们的销售团队](mailto:gtm@mintlify.com)洽谈解决方案。 +如需自动翻译，[设置工作流](/workflows)，让代理按计划运行或在仓库推送时触发。