From f60855b466b92dbc1d207dfaf66c1d0d79bf6082 Mon Sep 17 00:00:00 2001 From: "locadex-agent[bot]" <217277504+locadex-agent[bot]@users.noreply.github.com> Date: Mon, 6 Oct 2025 20:12:07 +0000 Subject: [PATCH] docs(locadex): update translations --- es/changelog.mdx | 300 +++++++++++++++++------------------ es/optimize/seo.mdx | 10 +- fr/changelog.mdx | 326 +++++++++++++++++++------------------- fr/optimize/seo.mdx | 8 +- zh/changelog.mdx | 374 ++++++++++++++++++++++---------------------- zh/optimize/seo.mdx | 8 +- 6 files changed, 519 insertions(+), 507 deletions(-) diff --git a/es/changelog.mdx b/es/changelog.mdx index 389c477a4..84de81436 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -1,96 +1,96 @@ --- -title: "Actualizaciones de producto" +title: "Actualizaciones del producto" description: "Nuevos lanzamientos y mejoras" rss: true noindex: true --- - - ## Nuevas funciones + + ## Novedades * **Navegación de productos**: Organiza la documentación de varios productos con el conmutador de productos en la navegación - * **Comando de accesibilidad de la CLI**: Ejecuta `mint a11y` para analizar tu documentación en busca de problemas de accesibilidad - * **Respuestas de video en el área de pruebas de la API**: El área de pruebas de la API ahora admite la visualización de respuestas en formato video - * **Prefill del área de pruebas de la API**: Nueva opción para prellenar ejemplos del área de pruebas de la API y acelerar las pruebas - * **Comentarios sin autenticación**: En sitios con autenticación parcial, ahora los usuarios pueden enviar comentarios sin iniciar sesión - * **Compatibilidad con temas de Shiki**: Ahora se admiten temas de Shiki para el estilo de los bloques de código + * **Comando de CLI de accesibilidad**: Ejecuta `mint a11y` para probar tu documentación en busca de problemas de accesibilidad + * **Respuestas de video en el área de pruebas de la API**: El área de pruebas de la API ahora admite la visualización de tipos de respuesta en video + * **Autorrelleno del área de pruebas de la API**: Nueva opción para autorrellenar ejemplos en el área de pruebas de la API para agilizar las pruebas + * **Comentarios sin autenticación**: En sitios con autenticación parcial, los usuarios ahora pueden enviar comentarios sin autenticarse + * **Compatibilidad con temas de Shiki**: Ya se admiten temas de Shiki para el estilo de los bloques de código * **Twoslash para bloques de código**: Los bloques de código de TypeScript y JavaScript ahora admiten Twoslash para información de tipos en línea ## Mejoras de accesibilidad - * Se añadieron atributos ARIA completos en los componentes para mejorar el soporte de lectores de pantalla - * Nuevo botón “saltar al contenido principal” para la navegación con teclado + * Se añadieron atributos ARIA completos en todos los componentes para mejorar la compatibilidad con lectores de pantalla + * Nuevo botón "saltar al contenido principal" para la navegación con teclado * Compatibilidad con navegación mediante teclas de flecha en componentes de pestañas - * Mejoras en los tooltips, listas anidadas y accesibilidad de grupos de código - * Mejora de estados de foco e interacciones con teclado en toda la interfaz + * Mejora de los tooltips, las listas anidadas y la accesibilidad de los grupos de código + * Mejora de los estados de enfoque y de los patrones de interacción con teclado en toda la interfaz ## Mejoras del assistant y de Analytics - * Se añadió visualización con gráficos de barras para las búsquedas del assistant en Analytics + * Se añadió visualización de gráficos de barras para las búsquedas del assistant en Analytics * Selector de rango de fechas unificado en la página de Analytics del assistant * Controles de zoom para los gráficos de Analytics del assistant * Mejor gestión del historial del assistant con atajos de teclado y mejoras en la hoja de chat - ## Correcciones de errores y confiabilidad + ## Corrección de errores y confiabilidad - * Se corrigieron problemas de z-index con superposiciones del panel lateral - * Se corrigieron valores de respaldo de color en modo claro y errores de estilo relacionados con temas - * Se corrigió que los expandibles del área de pruebas de la API no funcionaban con enlaces de anclaje - * Se corrigió la accesibilidad de enlaces `.md` para ChatGPT y otros agentes LLM - * Se corrigió el manejo de dimensiones de imagen para width y height basados en porcentaje + * Se solucionaron problemas de z-index con superposiciones del panel lateral + * Se corrigieron colores de respaldo en modo claro y errores de estilo relacionados con el tema + * Se corrigió que los desplegables del área de pruebas de la API no funcionaran con enlaces ancla + * Se mejoró la accesibilidad de enlaces `.md` para ChatGPT y otros agentes de LLM + * Se corrigió el manejo de dimensiones de imágenes para anchos y altos basados en porcentajes * Se corrigieron problemas de renderizado de bloques de código con etiquetas de idioma y temas personalizados - * Se corrigió el formato y el estilo de enlaces en Accordion + * Se corrigió el formato y el estilo de enlaces en acordeones * Se corrigió el espaciado del pie de página cuando la configuración del assistant está vacía - * Se corrigió el renderizado de iconos de tarjetas para imágenes locales del repositorio + * Se corrigió el renderizado de iconos de tarjeta para imágenes locales del repositorio * Se corrigió el manejo de archivos de audio en el área de pruebas de la API (se evitó la decodificación UTF-8) * Se mejoró la gestión del estado de publicación de PR en el editor web - + ## Ampliación del soporte de idiomas - * Se añadió soporte para los idiomas rumano y checo en la interfaz de la documentación + * Se añadió compatibilidad con los idiomas rumano y checo en la interfaz de la documentación * Capacidades de localización mejoradas con cobertura de traducción completa para los nuevos idiomas - * Mejoras en el selector de idioma en todos los temas + * Mejoras en la funcionalidad del selector de idioma en todos los temas - ## Mejoras de la UI y la experiencia de usuario + ## Mejoras de la interfaz de usuario y de la experiencia - * Se corrigieron problemas de visibilidad de pestañas en páginas 404 para evitar resaltar incorrectamente la pestaña activa - * Se mejoró el manejo de imágenes pasando correctamente los atributos width y height en imágenes no optimizadas - * Se mejoró el diseño y la coherencia de estilo de la página 404 + * Se solucionaron problemas de visibilidad de pestañas en páginas 404 para evitar resaltar de forma incorrecta la pestaña activa + * Manejo de imágenes mejorado con paso correcto de los atributos width y height para imágenes no optimizadas + * Mejora del diseño y la consistencia de estilo de la página 404 ## Mejoras de infraestructura y rendimiento - * Se mejoró el procesamiento de imágenes GIF omitiendo el costoso autoformateo de Imgix para reducir el tiempo de procesamiento y el uso de ancho de banda - * Se optimizó el rendimiento de entrega de imágenes con un manejo especial para contenido animado + * Procesamiento de imágenes GIF mejorado al omitir el costoso autoformato de Imgix para reducir el tiempo de procesamiento y el uso de ancho de banda + * Rendimiento de entrega de imágenes optimizado con manejo especial para contenido animado - ## Correcciones de errores y confiabilidad + ## Corrección de errores y confiabilidad * Se corrigió el enrutamiento del correo de contacto en la configuración del dashboard para solicitudes del complemento assistant - * Se mejoraron las actualizaciones del esquema de la base de datos para una mejor gestión de usuarios + * Mejoras en las actualizaciones del esquema de base de datos para una mejor gestión de usuarios - - ## Mejoras del editor web e inicio de sesión del dashboard + + ## Mejoras en el editor web y el inicio de sesión del dashboard - * Continuación de la migración al enrutador de aplicaciones para el editor web, eliminando bloqueadores y mejorando el rendimiento - * Mejora del manejo de errores de inicio de sesión con mensajes explícitos de validación de correo electrónico - * Se corrigió el manejo de espacios en blanco en la validación de direcciones de correo electrónico + * Avance en la migración al app router para el editor web, eliminando bloqueadores y mejorando el rendimiento + * Manejo de errores de inicio de sesión mejorado con mensajes explícitos de validación de correo electrónico + * Corrección del manejo de espacios en blanco en la validación de direcciones de correo electrónico ## Mejoras de Autenticación - * Se añadió soporte para parámetros de redirección validados en el callback de inicio de sesión para reducir la fricción - * Se mejoró el flujo de inicio de sesión para SSO con un mejor manejo de redirecciones + * Se añadió compatibilidad con parámetros de redirección validados en la devolución de llamada de inicio de sesión para reducir la fricción + * Flujo de inicio de sesión mejorado para SSO con un mejor manejo de redirecciones - ## Correcciones de errores y confiabilidad + ## Corrección de errores y confiabilidad - * Se corrigieron problemas de integración con GitLab en repositorios más grandes + * Se solucionaron problemas de integración con GitLab en repositorios más grandes * Se mejoró el rendimiento de carga del dashboard con consultas de implementación optimizadas * Se corrigieron problemas de renderizado de rutas SVG en la documentación - * Se corrigió la navegación con teclado en la búsqueda y la funcionalidad de chat + * Se corrigió la navegación con teclado en la búsqueda y en la funcionalidad de chat - + ## Lanzamientos principales * **Mejora importante**: Páginas sugeridas por IA en páginas 404, [cuando alguien llega a un enlace roto → el agente de IA lee la ruta → sugiere páginas semánticamente similares](https://x.com/mintlify/status/1966625627773059495) @@ -99,60 +99,60 @@ noindex: true ## Assistant y MCP - * Se corrigió un error donde el assistant era limitado por tasa indebidamente debido a que la ventana de tiempo no se deslizaba correctamente - * Se corrigió un error con las llamadas de herramientas del assistant para manejar correctamente bloques `text` vacíos - * Se corrigió un error donde los nombres del servidor MCP concatenados con llamadas de herramientas a veces excedían la longitud de 60 caracteres que imponen los clientes MCP + * Se corrigió un error donde el assistant era limitado por tasa de forma incorrecta debido a que la ventana de tiempo no se deslizaba correctamente + * Se corrigió un error con la llamada a herramientas del assistant para manejar correctamente bloques `text` vacíos + * Se corrigió un error donde el nombre del servidor MCP concatenado con llamadas a herramientas a veces superaba el límite de 60 caracteres que imponen los clientes MCP * Se corrigió un error donde el menú del assistant tenía una altura varias veces mayor que el viewport y hacía scroll indefinidamente * Se corrigió un error donde los valores de gasto del assistant podían mostrarse con más de dos decimales en el dashboard ## Editor web e implementaciones - * Mejora de seguridad en el editor: solo los usuarios con `write permissions` en el repositorio de alojamiento de Git conectado pueden realizar cambios + * Mejora de seguridad añadida al editor, de modo que solo los usuarios con `write permissions` en el repositorio de alojamiento de Git conectado puedan hacer cambios * Se corrigió un error donde las implementaciones de vista previa no funcionaban para branches con `=` en el nombre * Se corrigió un error donde los nombres de branch largos desbordaban los modales al crear implementaciones de vista previa - * Mejora de usabilidad: el parámetro de consulta de email rellenará el campo en invitaciones de registro + * Mejora de usabilidad: el parámetro de búsqueda de email ahora completa previamente el campo en invitaciones de registro * Se corrigió un error donde copiar una página desde el menú contextual no funcionaba en Safari ## Área de pruebas de la API y navigation - * Múltiples códigos de respuesta del área de pruebas de la API ahora se muestran en un menú select con estilo controlado en lugar del menú select predeterminado del sistema al enfocarse + * Múltiples códigos de respuesta del área de pruebas de la API ahora se muestran en un menú select con estilo controlado en lugar del menú select predeterminado del sistema cuando está enfocado * Ahora puedes usar el [`expanded` field on navigation groups in your `docs.json` to make them be default open](https://mintlify.com/docs/navigation#default-expanded-state) - ## SEO e interfaz de usuario + ## SEO y UI - * Se corrigió un error donde los favicons no aparecían en los motores de búsqueda, sirviéndolos desde la misma URL que el propio sitio de documentación para cada sitio correspondiente - * Se corrigió un error donde las inserciones de YouTube parpadeaban al cargar - * Se corrigió un error donde expandir el menú de feedback para incluir respuestas escritas causaba un cambio de diseño en la tabla de contenido - * Se corrigió un error donde el texto se desbordaba por encima de la barra superior en el tema Maple al descartar el banner de notificación - * Se mejoraron los temas Maple y Willow añadiendo botones de inicio/cierre de sesión en la barra lateral para un acceso más sencillo + * Se corrigió un error donde los favicons no aparecían en los motores de búsqueda al servirlos desde la misma URL que el sitio de documentación de cada sitio correspondiente + * Se corrigió un error donde las incrustaciones de YouTube parpadeaban al cargar + * Se corrigió un error donde ampliar el menú de comentarios para incluir respuestas escritas causaba cambios de diseño en la tabla de contenido + * Se corrigió un error donde el texto se filtraba por encima de la barra superior en el tema Maple al descartar el banner de notificaciones + * Se mejoraron los temas Maple y Willow añadiendo botones de inicio/cierre de sesión en la barra lateral para un acceso más fácil ## Analytics y exportaciones - * Se corrigieron problemas de confiabilidad con la vista de Analytics del assistant y las exportaciones - * Las exportaciones de Analytics del assistant ahora se ejecutan en segundo plano y se envían por correo electrónico para una experiencia más confiable + * Se corrigieron problemas de fiabilidad en la vista de analytics del assistant y en las exportaciones + * Las exportaciones de analytics del assistant ahora se ejecutan en segundo plano y se envían por email para una experiencia más confiable - + ## Lanzamiento principal: recopilación de comentarios mejorada - * **Mejora importante**: Los lectores ahora pueden dar comentarios más detallados después de seleccionar *pulgar arriba/abajo*, incluidas opciones y comentarios escritos. También puedes recopilar comentarios en bloques de código y ver todas las respuestas en los Analytics de tu dashboard.\ + * **Mejora importante**: Los lectores ahora pueden dar comentarios más detallados después de seleccionar *pulgar arriba/abajo*, incluyendo opciones y comentarios escritos. También puedes recopilar comentarios en bloques de código y ver todas las respuestas en los Analytics de tu dashboard.\ *Nota: Contáctanos para habilitar esta función en tu sitio.* ## Mejoras de navegación y de experiencia - * Mejora de experiencia para ignorar barras finales y dobles barras, para que no tengas que preocuparte por ponerlas exactamente bien en tu docs.json - * Ahora puedes añadir un atributo `noAnchor` a tus etiquetas HTML `h1-6` para evitar que tengan un enlace de ancla + * Mejora de experiencia para ignorar barras finales y dobles, de modo que no tengas que preocuparte por escribirlas exactamente en tu docs.json + * Ahora puedes añadir el atributo `noAnchor` a tus etiquetas HTML `h1-6` para evitar que tengan un enlace de ancla * El tema Palm ahora tiene un selector de idioma flotante en la parte inferior izquierda, similar al enfoque de Stripe - * Se añadió un nuevo campo al docs.json llamado [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups) que te permite controlar si los usuarios son llevados o no a la primera página de un grupo de navegación cuando el grupo se expande + * Se añadió un nuevo campo al docs.json llamado [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups) que te permite controlar si los usuarios se navegan o no a la primera página de un grupo de navegación cuando el grupo se expande * Mejora de experiencia para que las listas ordenadas anidadas alternen estilos de decimal/romano a alfabético - ## Correcciones de errores y confiabilidad + ## Correcciones de errores y fiabilidad - * Se corrigió un error en el que los enlaces de ancla con posición de desplazamiento no funcionaban correctamente cuando había componentes JS en una página + * Se corrigió un error por el que los enlaces de ancla de la posición de desplazamiento no funcionaban correctamente cuando había componentes JS en una página * Se corrigió un error por el que Google estaba indexando archivos `*.md` sin procesar porque les faltaba el encabezado `x-robots-tag: noindex` - * Se corrigió un error con OAuth en la documentación protegida por autenticación en el que no te redirigía a tu página de inicio una vez completado el flujo con éxito - * Se corrigió un error en las vistas previas de documentación protegida por autenticación en el que no podías ver toda la barra de navegación - * Correcciones de errores en cómo se manejan los SVG con nuestra nueva CDN de imágenes + * Se corrigió un error con OAuth en documentación protegida por autenticación, donde no te redirigía a tu página de inicio una vez que completabas el flujo correctamente + * Se corrigió un error en las vistas previas de documentación protegida por autenticación donde no podías ver toda la barra de navegación + * Correcciones en cómo se manejan los SVG con nuestra nueva CDN de imágenes ## Mejoras de componentes y estilos @@ -164,87 +164,87 @@ noindex: true * Mejora de rendimiento al mover el CSS de KaTeX de cdnjs a nuestra propia CDN en CloudFront para reducir la latencia - + ## Mejoras en el manejo de imágenes - * **Mejora importante**: Las imágenes ya no provocan desplazamiento del diseño de forma predeterminada, incluso cuando no se especifican los atributos width y height; el dimensionamiento automático evita saltos de contenido durante la carga de páginas - * Todos los archivos estáticos en tu repositorio (PDF, TXT, XML, etc.) ahora se suben y sirven automáticamente cuando implementas, proporcionando cobertura completa de recursos + * **Mejora importante**: Las imágenes ya no causan desplazamiento de diseño por defecto, incluso cuando no se especifican los atributos width y height: el dimensionamiento automático evita saltos de contenido durante la carga de la página + * Todos los archivos estáticos de tu repositorio (PDF, TXT, XML, etc.) ahora se suben y sirven automáticamente cuando implementas, proporcionando cobertura completa de recursos ## Mejoras del editor web e implementación - * Se corrigió el flujo de creación de branch en el editor web para navegar correctamente a y permanecer en las ramas recién creadas - * Se mejoró el cuadro de diálogo de resolución de conflictos con una función de cierre adecuada; ya no se requieren recargas de página para descartarlos - * Se optimizó el rendimiento del flujo de actualización invalidando la caché solo de las páginas cambiadas durante actualizaciones parciales, reduciendo los tiempos de implementación + * Se corrigió el flujo de creación de branch en el editor web para navegar correctamente a, y permanecer en, las ramas recién creadas + * Se mejoró el cuadro de diálogo de conflictos de fusión con una función de escape adecuada; ya no se requieren recargas de página para descartar conflictos + * Se optimizó el rendimiento del flujo de actualización invalidando el caché solo de las páginas cambiadas durante actualizaciones parciales, reduciendo los tiempos de implementación ## Mejoras de autenticación y navegación * Nuevo soporte para autenticación en subdirectorios personalizados; si sirves la documentación en `https://yourdomain.com/docs`, la autenticación ahora funciona sin problemas - * Se corrigió un error de visualización en la barra lateral que aparecía incorrectamente cuando solo se configuraba un enlace - * Renovación integral de la navegación móvil: botones centrados con margen/espaciado adecuados, mejor espaciado en menús desplegables, eliminación de divisores y márgenes innecesarios para secciones vacías, y corrección de problemas de separación/espaciado en el tema Maple + * Se corrigió un error de visualización en la barra lateral que se mostraba incorrectamente cuando solo había un enlace configurado + * Renovación integral de la navegación móvil: botones centrados con márgenes/espaciado adecuados, mejor separación en menús desplegables, eliminación de divisores y márgenes innecesarios en secciones vacías, y corrección de problemas de separación/relleno en el tema Maple ## Correcciones de componentes y estilos - * Se resolvió el problema de conversión de etiquetas `` que las transformaba incorrectamente en componentes Heading y alteraba los estilos personalizados - * Se agregó un interruptor de configuración del assistant con un clic en el dashboard para una gestión más sencilla + * Se resolvió el problema de conversión de etiquetas `` que las transformaba incorrectamente en componentes Heading y afectaba el estilo personalizado + * Se añadió un interruptor de configuración del assistant con un clic en el dashboard para una gestión más sencilla - ## Mejoras técnicas y confiabilidad + ## Mejoras técnicas y fiabilidad - * Sistema de logging mejorado para flujos de actualización que permite una depuración más rápida y una resolución de problemas más ágil - * Se solucionó la limitación de tasa de GitHub para clientes con más de 10 especificaciones OpenAPI/AsyncAPI, pasando de la obtención de archivos individuales a la clonación del repositorio - * Se mejoró la confiabilidad del assistant con soporte de LLM de respaldo, mejor manejo de errores por límites de tasa y una herramienta de búsqueda más robusta + * Sistema de registro mejorado para los flujos de actualización, lo que permite una depuración más rápida y una resolución de problemas más ágil + * Se corrigió la limitación de tasa de GitHub para clientes con más de 10 especificaciones de OpenAPI/AsyncAPI, cambiando de la obtención de archivos individuales a la clonación del repositorio + * Se mejoró la fiabilidad del assistant con soporte de LLM de respaldo, mejor manejo de errores por límite de tasa y una herramienta de búsqueda más robusta - + ## Optimizaciones de rendimiento y de compilación - * La transpilación de MDX ahora ocurre en el momento de la implementación en lugar de en cada carga de página en entornos sin caché de NextJS serverless, mejorando el tiempo hasta el primer byte para páginas no cacheadas. - * El hashing basado en contenido evita retranspilar cuando MDX no ha cambiado, reduciendo los tiempos del flujo de actualización en ~50% para clientes con un gran número de páginas (las implementaciones de más de 5 minutos deberían reducirse aproximadamente a la mitad) - * La visualización de implementaciones de vista previa en el dashboard ahora es más rápida gracias a índices de base de datos añadidos y a la paralelización de consultas en nuestro backend - * Se redujo el tamaño de la página al eliminar datos duplicados de `navigation` en la carga útil `rsc` de cada página; las mejoras de rendimiento son más notables con un alto número de páginas o estructuras de navegación complejas - * Un prefetching más agresivo permite cargas de página instantáneas con mayor frecuencia + * La transpilación de MDX ahora ocurre en el momento de la implementación en lugar de en cada carga de página en entornos serverless de NextJS sin caché, lo que mejora el tiempo hasta el primer byte para páginas no cacheadas. + * El hashing basado en contenido evita la retranspilación cuando MDX no ha cambiado, reduciendo los tiempos del flujo de actualización en ~50% para clientes con un gran número de páginas (las implementaciones de más de 5 minutos deberían reducirse aproximadamente a la mitad) + * La visualización de implementaciones de vista previa en el dashboard ahora es más rápida gracias a índices de base de datos adicionales y paralelización de consultas en nuestro backend + * Se redujo el tamaño de la página eliminando datos duplicados de `navigation` en la carga `rsc` de cada página; las mejoras de rendimiento son más notorias con un alto número de páginas o estructuras de navegación complejas + * Un prefetch más agresivo permite cargas de página instantáneas con mayor frecuencia - ## Mejoras del área de pruebas de la API y de OpenAPI + ## Área de pruebas de la API y mejoras de OpenAPI * La conversión de OpenAPI a MCP se trasladó al backend, lo que permite que los servidores MCP alojados contengan herramientas (pronto habrá documentación y opciones de configuración más claras) - * Se añadió compatibilidad con Ruby en el área de pruebas de la API + * Se añadió compatibilidad con Ruby al área de pruebas de la API * Agregamos una función para que ahora puedas [especificar páginas de API usando solo tu docs.json](/es/api-playground/openapi-setup#auto-populate-api-pages) sin crear nuevos archivos mdx. - * Compatibilidad con [páginas de `webhook`](/es/api-playground/openapi-setup#webhooks) en la navegación de la documentación a partir de especificaciones OpenAPI - * Se optimizó el contexto del modelo de IA eliminando las especificaciones de enlaces de anclaje de los enlaces de Markdown al navegar a Anthropic, OpenAI u otros proveedores + * Compatibilidad con páginas de [`webhook`](/es/api-playground/openapi-setup#webhooks) en la navegación de la documentación a partir de especificaciones OpenAPI + * Se optimizó el contexto del modelo de IA eliminando las especificaciones de enlaces de ancla en enlaces de Markdown al navegar a Anthropic, OpenAI u otros proveedores ## Mejoras del editor web * La creación y el cambio de nombre de archivos ahora guardan los cambios al hacer clic fuera, en lugar de requerir presionar la tecla Enter - * Se corrigió la navegación de branch donde cambiar la URL a un branch específico redirigía al último branch activo en lugar del destino previsto - * Se codifican correctamente en la URL los títulos de branch que contienen `/` para evitar rupturas de navegación - * Se corrigió el atajo de enlace `Ctrl+K` en el Editor del dashboard para monorepos, que estaba anteponiendo la ruta del repositorio de documentación y creando enlaces rotos + * Se corrigió la navegación por branch donde cambiar la URL a un branch específico redirigía al último branch activo en lugar del destino previsto + * Codificación correcta de URL para títulos de branch que contienen `/` a fin de evitar fallos de navegación + * Se corrigió el atajo de enlace `Ctrl+K` en el Editor del dashboard de monorepo que estaba anteponiendo la ruta del repositorio de documentación y creando enlaces rotos ## Analytics e integraciones con LLM - * Compatibilidad con `llms.txt` y `llms-full.txt` personalizados: agrégalos a la raíz del repositorio de documentación para servirlos en los endpoints `/llms.txt` y `/llms-full.txt` para la personalización de LLM + * Compatibilidad con `llms.txt` y `llms-full.txt` personalizados: agrégalos a la raíz del repositorio de documentación para servirlos en los endpoints `/llms.txt` y `/llms-full.txt` para personalización de LLM * Se añadió la [integración de Analytics de Hightouch](/es/integrations/analytics/hightouch#hightouch) - * Seguimiento de Analytics mejorado en el menú contextual (visualización en el dashboard próximamente) - * Se añadieron pruebas de extremo a extremo (e2e) para `llms.txt` y `llms-full.txt` para garantizar su correcta entrega + * Seguimiento de Analytics del menú contextual mejorado (la visualización en el dashboard llegará pronto) + * Se agregaron pruebas e2e para `llms.txt` y `llms-full.txt` para garantizar un servicio correcto ## Mejoras de componentes y estilos * Compatibilidad con classnames personalizados en etiquetas `h{1-4}` para aplicar estilos de encabezado personalizados * Se corrigió que las etiquetas `h{1-4}` se renderizaran como componentes `Heading` con chips en modo de página personalizada - * Se añadieron selectores CSS a [breadcrumbs](/es/organize/navigation#breadcrumbs) para objetivos CSS personalizados - * Se corrigieron imágenes de Open Graph estiradas analizando dimensiones para mantener las proporciones a 56px de height + * Se agregaron selectores CSS a [breadcrumbs](/es/organize/navigation#breadcrumbs) para segmentación personalizada con CSS + * Se corrigieron imágenes open-graph estiradas analizando dimensiones para mantener las proporciones a 56px de height * Se corrigió `VSCode` a `VS Code` en el menú contextual cuando está habilitado - * Se corrigió que los encabezados dentro de componentes personalizados aparecieran en la tabla de contenidos junto con encabezados semánticos + * Se corrigió que los encabezados dentro de componentes personalizados aparecieran en la tabla de contenido junto con encabezados semánticos - ## Correcciones de errores y confiabilidad + ## Corrección de errores y fiabilidad * Se corrigieron problemas de renderizado de PDF con ciertos títulos de página al sanear caracteres que causaban problemas de generación - * Se resolvió el error de la CLI `Cannot convert undefined or null to object` al encontrar archivos OpenAPI JSON vacíos - * Se corrigió que las metatags de Open Graph personalizadas en `docs.json` fueran sobrescritas por las generadas - * Se corrigieron los clics del botón del feed RSS al aterrizar en enlaces de anclaje usando origin + pathname para los enlaces RSS + * Se resolvió el error de la CLI `Cannot convert undefined or null to object` al encontrar archivos JSON de OpenAPI vacíos + * Se corrigió que metatags open-graph personalizados en `docs.json` fueran sobrescritos por los generados + * Se corrigieron los clics del botón de RSS al aterrizar en enlaces de ancla usando origin + pathname para los enlaces RSS * Se mejoró la velocidad de descarga de la CLI eliminando sourcemaps ## Mejoras técnicas - * Se añadieron pruebas visuales al pipeline de CI para detectar regresiones antes + * Se agregaron pruebas visuales a la canalización de CI para detectar regresiones antes * Se mejoró el manejo de errores y las capacidades de depuración * Cobertura de pruebas integral para nuevas funciones y casos límite @@ -252,116 +252,116 @@ noindex: true ## Mejoras de autenticación - * Acceso público a nivel de grupo: haz públicos grupos de páginas completos mediante `docs.json` para no tener que añadir `public: true` en cada página ([más información](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level)) + * Acceso público a nivel de grupo: haz públicos grupos completos de páginas mediante `docs.json` para no necesitar `public: true` en cada página ([más información](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level)) * Compatibilidad con [`logoutURL` en la configuración de OAuth](https://mintlify.com/docs/authentication-personalization/authentication-setup#implementation-3) para eliminar cookies de origen y completar el cierre de sesión - * En caso de errores de OAuth, los usuarios se redirigen a tu `logoutURL` especificado para reiniciar el flujo de autenticación - * Solucionado un parpadeo de error 500 durante los flujos de OAuth/JWT antes del callback - * Eliminación automática de `https://` de las URL en la configuración de autenticación OAuth/JWT para evitar errores de configuración + * En caso de errores de OAuth, los usuarios se redirigen a la `logoutURL` especificada para reiniciar el flujo de autenticación + * Corregido un destello de error 500 durante los flujos de OAuth/JWT antes del callback + * Eliminación automática de `https://` de las URL en la configuración de autenticación OAuth/JWT para evitar una configuración incorrecta ## Mejoras del área de pruebas de la API * Nuevo [endpoint de la Search API](https://mintlify.com/docs/api-reference/assistant/search) para que puedas crear agentes y servidores MCP sobre tu documentación * Los archivos `openapi` y `asyncapi` ahora se sirven en sus rutas especificadas (por ejemplo, `https://mydocsurl.extension/{openapi-or-file-name}.json`) - * Ahora puedes usar el [campo `x-mint` en tus archivos openapi](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) para sobrescribir campos generados, personalizar el contenido de introducción o cambiar las URL de endpoints en los ejemplos de código + * Ahora puedes usar el [campo `x-mint` en tus archivos openapi](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) para sobrescribir campos generados, personalizar el contenido del prefacio o cambiar las URL de los endpoints en ejemplos de código * [`x-mcp` ahora es `x-mint.mcp`](https://mintlify.com/docs/api-playground/openapi-setup#mcp) en configuraciones de OpenAPI para controlar qué rutas se exponen como herramientas MCP ## Actualizaciones del assistant - * Se solucionó un problema por el cual el menú de acciones (con opciones como copiar y pulgar arriba) de mensajes antiguos desaparecía cuando llegaban nuevos mensajes en streaming - * Se corrigió la accesibilidad de páginas anidadas `/mcp/...` tras el [lanzamiento de servidores MCP alojados](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server) de la semana pasada + * Se corrigió un problema en el que el menú de acciones (con opciones como copiar y pulgar arriba) de los mensajes antiguos desaparecía cuando llegaban nuevos + * Se corrigió la accesibilidad de las páginas anidadas `/mcp/...` tras el [lanzamiento de servidores MCP alojados](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server) de la semana pasada ## Rendimiento y confiabilidad * Todos los recursos de imagen y video presentes en tu repositorio de documentación ahora se sirven en la ruta adecuada en tu domain. Por ejemplo, si tienes `/assets/marketing/my-logo.png` en tu repositorio, estará disponible en `https://mydocsurl.extension/assets/marketing/my-logo.png`. - * El campo de email en el inicio de sesión del Dashboard de Mintlify ahora tiene autofocus para que puedas empezar a escribir de inmediato *(mejora de calidad de vida)* - * Tanto los dominios personalizados como los subdomains en Redis para mejorar el rendimiento en los tiempos de carga de la navigation (~50 ms menos de latencia) - * Se añadió lógica de reintentos para exportaciones a PDF y mejorar la confiabilidad - * Se corrigió que el popup de consentimiento de cookies reapareciera tras la aceptación o el rechazo: ahora se respeta la primera selección - * Se solucionó copiar una página al portapapeles en Safari especificando un `type` MIME en `navigator.write` + * El campo de email en el inicio de sesión del Dashboard de Mintlify ahora tiene autofocus para que puedas comenzar a escribir de inmediato (mejora de calidad de vida) + * Tanto dominios personalizados como subdomains en Redis para mejorar el rendimiento de la carga de la navigation (~50 ms de reducción de latencia) + * Se agregó lógica de reintento para exportaciones a PDF para mejorar la confiabilidad + * Se corrigió que el popup de consentimiento de cookies reapareciera después de aceptar o descartar: ahora se respeta la primera selección + * Se corrigió el copiado de una página al portapapeles en Safari especificando un `type` MIME en `navigator.write` ## Mejoras técnicas - * Correcciones de la CLI para Windows y pnpm, además de pruebas de CI para prevenir regresiones - * Salida de logs de errores mejorada: una mejora de calidad de vida para nuestro equipo de ingeniería al depurar + * Correcciones de errores de la CLI para Windows y pnpm, además de pruebas de CI para prevenir regresiones + * Salida de registro de errores mejorada: una mejora de calidad de vida para nuestro equipo de ingeniería al depurar * Correcciones menores a la acción de CI de enlaces rotos cuando faltan archivos `contentDirectory` * Se corrigió una regresión causada por las correcciones de la vista previa protegida por autenticación de la semana pasada, donde la Tab activa no se establecía correctamente en la UI de navigation - * Se corrigió que el color de fondo light del tema no se aplicara a los iconos de la Tab activa - * Se solucionó un problema por el cual cambiar el tipo de autenticación en el dashboard se actualizaba y luego volvía al tipo guardado previamente: ahora la nueva selección persiste tras guardar + * Se corrigió que el color de fondo del tema light no se aplicara a los iconos de la Tab activa + * Se corrigió un problema en el que cambiar el tipo de autenticación en el dashboard se actualizaba y luego volvía al tipo guardado previamente: ahora la nueva selección persiste tras guardar * Mejoras internas de DX para clientes empresariales con bibliotecas de UI personalizadas: ahora nos resulta más fácil incluir tus componentes y atender solicitudes en plazos más cortos ## Mejoras de autenticación - * Mejoras en el desarrollo local de auth, lo que permite iterar más rápido en funciones de auth y corregir errores en esta área del producto - * Implementaciones de vista previa disponibles para sitios protegidos por auth + * Mejoras en el desarrollo local de auth, lo que permite desarrollar más rápido funciones de autenticación y correcciones de errores en esta área del producto + * Las implementaciones de vista previa ahora están disponibles para sitios protegidos con auth * Se corrigió el comportamiento de redirección para devolver correctamente a los usuarios a su página original después de autenticarse * Se corrigió la visualización del botón de cerrar sesión para la autenticación completa (antes solo funcionaba con autenticación parcial) ## Mejoras del área de pruebas de la API - * Se corrigió la carga de archivos con `multipart/form-data` en el área de pruebas de la API - * Se corrigió el comportamiento de los enlaces de anclaje para que, al hacer clic, actualicen la URL sin desplazarse al inicio de la página + * Se corrigió la carga de archivos `multipart/form-data` en el área de pruebas de la API + * Se corrigió el comportamiento de los enlaces de anclaje para que, al hacer clic, actualicen la URL sin desplazarse a la parte superior de la página * Se corrigieron problemas de enlaces de anclaje en pestañas anidadas ## Actualizaciones del assistant * Nueva Assistant API para integrarlo en tus propios productos, compatible con el AI SDK - * Se añadió un botón de copiar a las respuestas del chat + * Se agregó un botón para copiar en las respuestas del chat * Se corrigió un problema al reintentar mensajes en el assistant - * Mejoras al prompt predeterminado del assistant para que sea menos verboso por defecto + * Mejoras en el prompt predeterminado del assistant para hacerlo menos verboso por defecto ## Rendimiento y confiabilidad - * Búsqueda más ágil y precisa al abortar solicitudes con debounce mientras escribes + * La búsqueda se siente más ágil y precisa al abortar solicitudes con debounce mientras escribes * Aprovisionamiento de recursos para una nueva CDN: se espera que los tiempos de carga de imágenes y páginas mejoren pronto - * Se corrigieron errores al renderizar diagramas complejos de Mermaid como gráficos de GANTT - * Se corrigieron errores de la CLI en Windows para mejorar la estabilidad y se añadieron pruebas para prevenir regresiones + * Se corrigieron errores al renderizar diagramas complejos de Mermaid como gráficos de Gantt + * Se corrigieron errores de la CLI en Windows para mejorar la estabilidad y se agregaron pruebas para prevenir regresiones ## Mejoras técnicas - * Se añadió OpenTelemetry para trazas en la aplicación NextJS y mejorar el tiempo hasta el primer byte para los clientes + * Se agregó OpenTelemetry para trazas en la aplicación de Next.js para mejorar el time to first byte para los clientes * Migración de Octokit a GitHub API Client para mejorar la latencia en la experiencia del editor web - * Se corrigieron etiquetas meta duplicadas para OpenGraph + * Se corrigieron meta tags duplicadas para OpenGraph * Se actualizó MongoDB de la versión 6 a la 7 para mejorar el rendimiento y añadir nuevas funciones - ## Aplicación de Slack + ## Slack app * Acceso sin fricción: el bot responde a DMs, @menciones y cualquier pregunta en tu canal `#ask-ai` - * Configuración con un clic: instálala directamente desde tu Dashboard de Mintlify en segundos + * Configuración con un clic: instala directamente desde tu Dashboard de Mintlify en segundos * Respuestas contextuales: busca en toda tu documentación para ofrecer respuestas relevantes y precisas - * Reduce interrupciones de soporte: convierte las preguntas diarias en respuestas instantáneas de autoservicio + * Reduce interrupciones de soporte: convierte preguntas diarias en respuestas instantáneas de autoservicio - Obtén más información en nuestra [guía de la aplicación de Slack](/es/ai/slack-app). + Obtén más información en nuestra [guía de Slack app](/es/ai/slack-app). - ## Servidores MCP alojados + ## Servidores MCP hospedados - Implementa servidores Model Context Protocol (MCP) alojados directamente a través de Mintlify para integrarte con herramientas de IA como Claude, Cursor y otras. Obtén más información en nuestra [guía de MCP](/es/ai/model-context-protocol). + Implementa servidores del Model Context Protocol (MCP) hospedados directamente a través de Mintlify para integrarte con herramientas de IA como Claude, Cursor y otras. Obtén más información en nuestra [guía de MCP](/es/ai/model-context-protocol). Ayuda a los usuarios a conectar rápidamente tu servidor MCP con Cursor o VS Code desde cualquier página de tu documentación mediante el menú contextual. Consulta [Menú contextual](/es/ai/contextual-menu) para más información. ## Mejoras en el bloque de código - * Mejor resaltado de sintaxis - * Se añadieron más opciones de personalización, incluido el modo de enfoque, bloques de código expandibles, adaptación a modo oscuro y claro, menú desplegable de lenguaje, numeración de líneas e iconos + * Resaltado de sintaxis mejorado + * Se agregaron más opciones de personalización, incluyendo modo de enfoque, bloques de código expandibles, adaptación a modo oscuro y claro, menú desplegable de idioma, numeración de líneas e iconos ## Actualizaciones del Asistente de IA - * Mayor precisión mediante RAG agente con llamadas a herramientas - * Proporciona enlaces navegables a las páginas de referencia para que los usuarios puedan ir directamente a la fuente de las respuestas + * Mejora de la precisión mediante RAG agentico con invocación de herramientas + * Proporciona enlaces navegables a las páginas referenciadas para que los usuarios puedan ir directamente a la fuente de las respuestas * Atajo para copiar ejemplos de código generados por el assistant - * Atajo "Ask AI" en bloques de código de la documentación para generar explicaciones desde el assistant + * Atajo "Ask AI" en bloques de código de la documentación para generar explicaciones del assistant Obtén más información en la [documentación del assistant](/es/ai/assistant). - ## Registros de cambios suscribibles + ## Cambios suscribibles * Genera automáticamente un feed RSS a partir de las páginas de cambios - * Integra actualizaciones con RSS con Slack, correo electrónico y otras herramientas + * Integra actualizaciones habilitadas para RSS con Slack, correo electrónico y otras herramientas Obtén más información en nuestra nueva [guía de cambios](/es/create/changelogs) @@ -369,12 +369,12 @@ noindex: true ## Actualizaciones de estabilidad del área de pruebas de la API - * Busca para encontrar un endpoint - * Indica un endpoint en desuso con una etiqueta - * Oculta páginas de API autogeneradas de navigation - * Carga archivos multipart o de datos de formulario + * Búsqueda para encontrar un endpoint + * Indicar un endpoint en desuso con una etiqueta + * Ocultar páginas de la API generadas automáticamente de la navigation + * Cargar archivos multipart o de datos de formulario - Obtén más información en la [documentación del área de pruebas de la API](/es/api-playground/) + Obtén más información en la [documentación del área de pruebas de la API.](/es/api-playground/) ## `mint update` diff --git a/es/optimize/seo.mdx b/es/optimize/seo.mdx index 0dc90a715..d7f1bbd29 100644 --- a/es/optimize/seo.mdx +++ b/es/optimize/seo.mdx @@ -44,12 +44,16 @@ title: "El título de tu página de ejemplo"
- ## Referencia de metaetiquetas comunes + ## Referencia de etiquetas meta comunes
-A continuación encontrarás una lista completa de metaetiquetas que puedes añadir a tu `docs.json`. Estas metaetiquetas ayudan a mejorar el SEO de tu sitio, el alcance en redes sociales y la compatibilidad con los navegadores. +A continuación encontrarás una lista completa de etiquetas meta que puedes añadir a tu `docs.json`. Estas etiquetas ayudan a mejorar el SEO de tu sitio, el rendimiento en redes sociales y la compatibilidad con navegadores. -Puedes obtener una vista previa de cómo se mostrarán tus metaetiquetas en diferentes plataformas usando [metatags.io](https://metatags.io/). + + La etiqueta `og:image` añade una imagen de fondo que Mintlify superpone automáticamente con tu logotipo, el título de la página y la descripción al generar las vistas previas para redes sociales. + + +Puedes previsualizar cómo se mostrarán tus etiquetas meta en diferentes plataformas usando [metatags.io](https://metatags.io/). ```json expandable "seo": { diff --git a/fr/changelog.mdx b/fr/changelog.mdx index c01f33824..f9838ae04 100644 --- a/fr/changelog.mdx +++ b/fr/changelog.mdx @@ -1,35 +1,35 @@ --- -title: "Mises à jour produit" +title: "Mises à jour du produit" description: "Nouvelles versions et améliorations" rss: true noindex: true --- - + ## Nouvelles fonctionnalités - * **Navigation entre produits**: Organisez la documentation de plusieurs produits avec le sélecteur de produit dans la navigation + * **Navigation des produits**: Organisez la documentation de plusieurs produits avec le sélecteur de produit dans la navigation * **Commande CLI d’accessibilité**: Exécutez `mint a11y` pour tester l’accessibilité de votre documentation - * **Réponses vidéo dans le bac à sable d’API**: Le bac à sable d’API prend désormais en charge l’affichage de réponses vidéo - * **Préremplissage du bac à sable d’API**: Nouvelle option pour préremplir les exemples du bac à sable d’API afin de tester plus rapidement - * **Commentaires sans authentification**: Pour les sites avec authentification partielle, les utilisateurs peuvent désormais envoyer des commentaires sans être authentifiés - * **Prise en charge des thèmes Shiki**: Les thèmes Shiki sont désormais pris en charge pour le style des blocs de code - * **Twoslash pour les blocs de code**: Les blocs de code TypeScript et JavaScript prennent désormais en charge Twoslash pour afficher les informations de type en ligne + * **Réponses vidéo dans le bac à sable d’API**: Le bac à sable d’API prend désormais en charge l’affichage des réponses vidéo + * **Préremplissage du bac à sable d’API**: Nouvelle option pour préremplir les exemples du bac à sable d’API afin d’accélérer les tests + * **Commentaires non authentifiés**: Pour les sites utilisant une authentification partielle, les utilisateurs peuvent désormais envoyer des commentaires sans être authentifiés + * **Prise en charge des thèmes Shiki**: Les thèmes Shiki sont désormais pris en charge pour le style des code blocks + * **Twoslash pour les code blocks**: Les code blocks TypeScript et JavaScript prennent désormais en charge Twoslash pour afficher les informations de type en ligne ## Améliorations d’accessibilité - * Ajout d’attributs ARIA complets sur l’ensemble des composants pour une meilleure prise en charge des lecteurs d’écran + * Ajout d’attributs ARIA complets sur les composants pour une meilleure prise en charge des lecteurs d’écran * Nouveau bouton « passer au contenu principal » pour la navigation au clavier - * Prise en charge de la navigation aux touches fléchées dans les composants Tab - * Infobulles, listes imbriquées et accessibilité des groupes de code améliorées - * États de focus et interactions clavier améliorés dans toute l’interface + * Prise en charge des touches fléchées dans les composants d’onglets + * Accessibilité améliorée des info-bulles, listes imbriquées et groupes de code + * États de focus et interactions au clavier améliorés dans toute l’interface ## Améliorations de l’Assistant et des Analytics - * Ajout d’une visualisation en histogramme pour les Analytics des requêtes de l’Assistant + * Ajout d’un histogramme pour l’analyse des requêtes de l’Assistant * Sélecteur d’intervalle de dates unifié sur la page Analytics de l’Assistant * Contrôles de zoom pour les graphiques Analytics de l’Assistant - * Meilleure gestion de l’historique de l’Assistant avec des raccourcis clavier et des améliorations de la fenêtre de chat + * Meilleure gestion de l’historique de l’Assistant avec des raccourcis clavier et des améliorations du panneau de chat ## Corrections de bugs et fiabilité @@ -38,46 +38,46 @@ noindex: true * Correction des éléments extensibles du bac à sable d’API qui ne fonctionnaient pas avec les liens d’ancrage * Correction de l’accessibilité des liens `.md` pour ChatGPT et autres agents LLM * Correction de la gestion des dimensions d’image pour les largeurs et hauteurs en pourcentage - * Correction des problèmes de rendu des blocs de code avec les balises de langue et les thèmes personnalisés - * Correction du formatage et du style des liens d’accordéon - * Correction des espacements du pied de page lorsque la configuration de l’Assistant est vide - * Correction du rendu des icônes de carte pour les images du référentiel local - * Correction de la gestion des fichiers audio dans le bac à sable d’API (empêche le décodage UTF-8) + * Correction des problèmes de rendu des code blocks avec les balises de langage et les thèmes personnalisés + * Correction du formatage et du style des liens dans les accordéons + * Correction des espacements de pied de page lorsque la configuration de l’Assistant est vide + * Correction du rendu des icônes de cartes pour les images du référentiel local + * Correction de la gestion des fichiers audio dans le bac à sable d’API (prévention du décodage UTF-8) * Amélioration de la gestion de l’état de publication des PR dans l’éditeur web - + ## Extension de la prise en charge des langues - * Ajout de la prise en charge du roumain et du tchèque dans l’interface de la documentation - * Capacités de localisation renforcées avec une couverture de traduction complète pour les nouvelles langues + * Ajout de la prise en charge du roumain et du tchèque dans l’interface de documentation + * Capacités de localisation améliorées avec une couverture de traduction complète pour ces nouvelles langues * Amélioration du sélecteur de langue sur tous les thèmes ## Améliorations de l’UI et de l’expérience utilisateur - * Correction des problèmes de visibilité des onglets sur les pages 404 pour éviter une mise en évidence incorrecte de l’onglet actif - * Amélioration de la gestion des images avec passage correct des attributs width et height pour les images non optimisées + * Correction des problèmes de visibilité des onglets sur les pages 404 pour éviter une mise en surbrillance incorrecte de l’onglet actif + * Amélioration de la gestion des images avec la transmission correcte des attributs width et height pour les images non optimisées * Amélioration de la mise en page et de la cohérence du style des pages 404 ## Améliorations de l’infrastructure et des performances - * Amélioration du traitement des images GIF en évitant le coûteux formatage automatique Imgix afin de réduire le temps de traitement et l’utilisation de la bande passante - * Optimisation des performances de diffusion des images avec une gestion spécifique du contenu animé + * Traitement des images GIF amélioré en évitant l’auto-formatage coûteux d’Imgix pour réduire le temps de traitement et l’utilisation de la bande passante + * Optimisation des performances de diffusion des images avec un traitement spécifique du contenu animé ## Corrections de bugs et fiabilité - * Correction du routage des e-mails de contact dans les paramètres du Dashboard pour les demandes de l’add-on Assistant + * Correction du routage des e-mails de contact dans les paramètres du Dashboard pour les demandes d’add-on Assistant * Amélioration des mises à jour du schéma de base de données pour une meilleure gestion des utilisateurs - + ## Améliorations de l’éditeur web et de la connexion au Dashboard * Poursuite de la migration vers l’app router pour l’éditeur web, suppression des blocages et amélioration des performances * Amélioration de la gestion des erreurs de connexion avec des messages explicites de validation d’e-mail - * Correction de la gestion des espaces dans la validation des adresses e‑mail + * Correction de la gestion des espaces dans la validation des adresses e-mail - ## Améliorations de l’Authentification + ## Améliorations de l’authentification * Ajout de la prise en charge des paramètres de redirection validés dans le callback de connexion pour réduire les frictions * Amélioration du flux de connexion pour le SSO avec une meilleure gestion des redirections @@ -86,282 +86,282 @@ noindex: true * Correction des problèmes d’intégration GitLab avec des référentiels volumineux * Amélioration des performances de chargement du Dashboard avec des requêtes de déploiement optimisées - * Correction des problèmes de rendu des tracés SVG dans la documentation + * Correction des problèmes de rendu des chemins SVG dans la documentation * Correction de la navigation au clavier dans la recherche et le chat - - ## Versions majeures + + ## Grandes versions - * **Amélioration majeure** : pages suggérées par l’IA sur les pages 404, [quand quelqu’un arrive sur un lien mort → l’agent IA lit le chemin → propose des pages sémantiquement similaires](https://x.com/mintlify/status/1966625627773059495) - * **Version majeure** : la recherche web de l’Assistant peut désormais inclure des sources externes\ - *Remarque : contactez-nous pour activer cette fonctionnalité pour votre site.* + * **Amélioration majeure** : pages suggérées par l’IA sur les 404, [quand quelqu’un arrive sur un lien mort → l’agent IA lit le chemin → suggère des pages sémantiquement similaires](https://x.com/mintlify/status/1966625627773059495) + * **Version majeure** : la recherche web de l’assistant peut désormais inclure des sources externes\ + *Remarque : contactez-nous pour activer cette fonctionnalité sur votre site.* ## Assistant et MCP - * Correction d’un bug où l’Assistant était limité en débit de manière incorrecte à cause d’une fenêtre glissante qui ne se décalait pas correctement - * Correction d’un bug dans l’appel d’outils de l’Assistant pour gérer correctement les blocs `text` vides - * Correction d’un bug où le nom du serveur MCP, concaténé avec les appels d’outils, dépassait parfois la limite de 60 caractères imposée par les clients MCP - * Correction d’un bug où le menu de l’Assistant avait une height plusieurs fois supérieure à la fenêtre d’affichage et défilait indéfiniment - * Correction d’un bug où les montants de consommation de l’Assistant pouvaient s’afficher avec plus de deux décimales dans le Dashboard + * Correction d’un bug où l’assistant était incorrectement soumis à une limite de débit à cause d’une fenêtre temporelle qui ne glissait pas correctement + * Correction d’un bug dans l’appel d’outils de l’assistant pour gérer correctement les blocs `text` vides + * Correction d’un bug où les noms de serveur MCP concaténés avec des appels d’outils dépassaient parfois la limite de 60 caractères imposée par les clients MCP + * Correction d’un bug où le menu de l’assistant avait une hauteur plusieurs fois supérieure à la fenêtre d’affichage et défilait indéfiniment + * Correction d’un bug où les montants dépensés par l’assistant pouvaient s’afficher avec plus de deux décimales dans le Dashboard ## Éditeur web et déploiements - * Renforcement de la sécurité de l’éditeur : seuls les utilisateurs disposant des `write permissions` pour le référentiel Git connecté peuvent effectuer des modifications - * Correction d’un bug où les déploiements de prévisualisation ne fonctionnaient pas pour les branches contenant un `=` dans le nom + * Renforcement de la sécurité dans l’éditeur afin que seuls les utilisateurs disposant des `write permissions` pour le référentiel Git connecté puissent effectuer des modifications + * Correction d’un bug où les déploiements de prévisualisation ne fonctionnaient pas pour les branches comportant `=` dans le nom * Correction d’un bug où les noms de branche longs débordaient des modales lors de la création d’un déploiement de prévisualisation * Amélioration de l’ergonomie : le paramètre de requête email préremplit désormais le champ dans les invitations d’inscription * Correction d’un bug où la copie d’une page depuis le menu contextuel ne fonctionnait pas sur Safari ## Bac à sable d’API et navigation - * Plusieurs codes de réponse du bac à sable d’API s’affichent désormais dans un menu select stylisé contrôlé au lieu du select par défaut du système lorsqu’il est en focus - * Vous pouvez désormais utiliser le [champ `expanded` sur les groups de la navigation dans votre `docs.json` pour les ouvrir par défaut](https://mintlify.com/docs/navigation#default-expanded-state) + * Plusieurs codes de réponse du bac à sable d’API s’affichent désormais dans un menu select stylisé et contrôlé au lieu du menu select par défaut du système lorsqu’il est focalisé + * Vous pouvez désormais utiliser le [champ `expanded` sur les groupes de navigation dans votre `docs.json` pour les ouvrir par défaut](https://mintlify.com/docs/navigation#default-expanded-state) ## SEO et interface - * Correction d’un bug où les favicons n’apparaissaient pas dans les moteurs de recherche, en les servant depuis la même URL que le site de documentation lui-même pour chaque site concerné + * Correction d’un bug où les favicons n’apparaissaient pas dans les moteurs de recherche, en les servant depuis la même URL que le site de documentation lui‑même pour chaque site concerné * Correction d’un bug où les intégrations YouTube clignotaient au chargement * Correction d’un bug où l’extension du menu de retour d’expérience pour inclure des réponses écrites provoquait un décalage de mise en page avec la table des matières - * Correction d’un bug où le texte dépassait au-dessus de la barre supérieure sur le thème Maple lorsqu’on fermait la bannière de notification + * Correction d’un bug où le texte débordait au-dessus de la barre supérieure sur le thème Maple lorsqu’on fermait la bannière de notification * Amélioration des thèmes Maple et Willow avec l’ajout de boutons Connexion/Déconnexion dans la barre latérale pour un accès plus facile ## Analytics et exports - * Correction de problèmes de fiabilité avec la vue Analytics de l’Assistant et les exports - * Les exports Analytics de l’Assistant sont désormais exécutés en arrière-plan et envoyés par email pour une expérience plus fiable + * Correction de problèmes de fiabilité avec la vue Analytics de l’assistant et les exports + * Les exports Analytics de l’assistant sont désormais exécutés en arrière‑plan et envoyés par email pour une expérience plus fiable - - ## Publication majeure : collecte de retours améliorée + + ## Version majeure : collecte de retours améliorée - * **Amélioration majeure** : Les lecteurs peuvent désormais donner un avis plus détaillé après avoir sélectionné *pouce levé/baissé*, avec des options et des commentaires écrits. Vous pouvez aussi collecter des retours sur les code blocks et consulter toutes les réponses dans les Analytics de votre Dashboard.\ + * **Amélioration majeure** : Les lecteurs peuvent désormais donner des retours plus détaillés après avoir sélectionné *pouce levé/baissé*, avec des options et des commentaires écrits. Vous pouvez également collecter des retours sur les code blocks et consulter toutes les réponses dans les Analytics de votre Dashboard.\ *Remarque : contactez‑nous pour activer cette fonctionnalité sur votre site.* - ## Améliorations de la navigation et du confort d’utilisation + ## Améliorations de la navigation et de l’ergonomie - * Amélioration de confort pour ignorer les barres obliques finales et doubles, afin que vous n’ayez pas à vous en soucier dans votre docs.json - * Vous pouvez désormais ajouter l’attribut `noAnchor` à vos balises HTML `h1-6` pour éviter la création d’un lien d’ancre - * Le thème Palm propose désormais un sélecteur de langue flottant en bas à gauche, similaire à l’approche de Stripe - * Ajout d’un nouveau champ dans docs.json, appelé [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups), qui vous permet de contrôler si les utilisateurs sont dirigés ou non vers la première page d’un groupe de navigation lorsque le groupe est développé - * Amélioration de confort pour alterner les styles des listes ordonnées imbriquées entre décimal/Romain et alphabétique + * Amélioration ergonomique pour ignorer les barres obliques de fin et les doubles barres obliques afin que vous n’ayez pas à vous soucier de les mettre exactement comme il faut dans votre docs.json + * Vous pouvez désormais ajouter l’attribut `noAnchor` à vos balises HTML `h1-6` pour éviter qu’elles n’aient un lien d’ancrage + * Le thème Palm dispose désormais d’un sélecteur de langue flottant en bas à gauche, similaire à l’approche de Stripe + * Ajout d’un nouveau champ dans docs.json appelé [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups) qui vous permet de contrôler si les utilisateurs sont dirigés ou non vers la première page d’un groupe de navigation lorsque le groupe est développé + * Amélioration ergonomique pour alterner les styles des listes ordonnées imbriquées de décimal/Romain à alpha - ## Correctifs et fiabilité + ## Corrections de bogues et fiabilité - * Correction d’un bug où les liens d’ancrage de position de défilement ne fonctionnaient pas correctement en présence de composants JS sur une page - * Correction d’un bug où Google indexait des fichiers `*.md` bruts faute d’un en‑tête `x-robots-tag noindex` - * Correction d’un bug avec OAuth sur les docs protégées où vous n’étiez pas redirigé vers votre page initiale une fois le parcours terminé avec succès - * Correction d’un bug sur les aperçus des docs protégées par authentification où la barre de navigation complète n’était pas visible - * Correctifs concernant la gestion des SVG avec notre nouveau CDN d’images + * Correction d’un bogue où les liens d’ancrage de position de défilement ne fonctionnaient pas correctement lorsqu’il y avait des composants JS sur une page + * Correction d’un bogue où Google indexait des fichiers `*.md` bruts car ils n’avaient pas d’en‑tête `x-robots-tag noindex` + * Correction d’un bogue avec OAuth sur la documentation protégée où vous n’étiez pas redirigé vers votre page de départ une fois le parcours terminé avec succès + * Correction d’un bogue sur les aperçus de docs protégées par authentification où vous ne pouviez pas voir l’intégralité de la barre de navigation + * Corrections de bogues concernant la manière dont les SVG sont gérés avec notre nouveau CDN d’images ## Améliorations des composants et du style - * Ajout d’un nouveau sélecteur CSS pour des styles personnalisés sur `SidebarNavGroupDivider` - * De nouveaux tests de régression pour les pages d’API définies en MDX et sécurisées garantiront une stabilité accrue + * Ajout d’un nouveau sélecteur CSS pour les styles personnalisés sur `SidebarNavGroupDivider` + * De nouveaux tests de régression pour les pages d’API définies en MDX avec des règles de sécurité garantiront un niveau de stabilité supérieur ## Améliorations des performances - * Amélioration des performances en déplaçant le CSS de KaTeX de cdnjs vers notre propre CDN sur CloudFront afin de réduire la latence + * Amélioration des performances en déplaçant le CSS de KaTeX de cdnjs vers notre propre CDN sur CloudFront pour réduire la latence - + ## Améliorations de la gestion des images * **Amélioration majeure** : Les images ne provoquent plus de décalage de mise en page par défaut, même lorsque les attributs width et height ne sont pas spécifiés — le dimensionnement automatique empêche les sauts de contenu lors du chargement des pages - * Tous les fichiers statiques de votre référentiel (PDF, TXT, XML, etc.) sont désormais automatiquement téléversés et servis lors du déploiement, pour une couverture complète des ressources + * Tous les fichiers statiques de votre référentiel (PDF, TXT, XML, etc.) sont désormais automatiquement téléversés et servis lors du déploiement, pour une couverture complète des assets ## Améliorations de l’éditeur web et du déploiement * Correction du flux de création de branche dans l’éditeur web pour naviguer correctement vers les nouvelles branches créées et y rester - * Boîte de dialogue de résolution de conflits de fusion améliorée avec un véritable échappement, plus besoin de recharger la page pour fermer les conflits - * Optimisation des performances du flux de mise à jour en invalidant le cache uniquement des pages modifiées lors des mises à jour partielles, réduisant les temps de déploiement + * Boîte de dialogue de résolution de conflits de fusion améliorée avec une gestion correcte de l’échappement ; plus besoin de recharger la page pour fermer les conflits + * Optimisation des performances du flux de mise à jour en invalidant le cache uniquement des pages modifiées lors des mises à jour partielles, réduisant ainsi les temps de déploiement ## Améliorations de l’authentification et de la navigation - * Nouvelle prise en charge de l’authentification sur des sous‑répertoires personnalisés : si vous servez la documentation à `https://yourdomain.com/docs`, l’authentification fonctionne désormais sans friction - * Correction d’un bug d’affichage de la barre latérale qui apparaissait à tort lorsqu’un seul lien était configuré - * Refonte complète de la navigation mobile : boutons centrés avec marges/espacements appropriés, espacement amélioré dans les menus déroulants, suppression des séparateurs et marges inutiles pour les sections vides, et correction des problèmes d’écart/espacement du thème Maple + * Nouveau support de l’authentification sur des sous-répertoires personnalisés : si vous servez la documentation à `https://yourdomain.com/docs`, l’authentification fonctionne désormais de manière transparente + * Correction d’un bogue d’affichage de la barre latérale qui apparaissait incorrectement lorsqu’un seul lien était configuré + * Refonte complète de la navigation mobile : boutons centrés avec marges/espacements appropriés, espacement amélioré dans les menus déroulants, suppression des séparateurs et marges inutiles pour les sections vides, et correction des problèmes d’écarts/espacements du thème Maple - ## Correctifs de composants et de style + ## Corrections de composants et de styles - * Résolution d’un problème de conversion des balises `` qui les transformait à tort en composants Heading et perturbait les styles personnalisés - * Bascule de configuration de l’Assistant en un clic ajoutée au Dashboard pour une gestion simplifiée + * Résolution d’un problème de conversion des balises `` qui les transformait à tort en composants Heading et perturbait le style personnalisé + * Bascule de configuration de l’Assistant en un clic ajoutée au Dashboard pour une gestion plus simple ## Améliorations techniques et fiabilité - * Système de journalisation amélioré pour les flux de mise à jour, permettant un débogage plus rapide et une résolution accélérée des problèmes - * Correction de la limitation de taux GitHub pour les clients avec plus de 10 spécifications OpenAPI/AsyncAPI, en passant de la récupération de fichiers individuels au clonage du référentiel - * Fiabilité de l’Assistant améliorée grâce à une prise en charge de LLM de secours, une meilleure gestion des erreurs de limitation de taux et un outil de recherche plus robuste + * Système de journalisation amélioré pour les flux de mise à jour, permettant un débogage plus rapide et une résolution plus efficace des problèmes + * Correction des limitations de taux GitHub pour les clients avec plus de 10 spécifications OpenAPI/AsyncAPI en passant de la récupération de fichiers individuels au clonage du référentiel + * Fiabilité de l’Assistant améliorée avec prise en charge d’un LLM de secours, meilleure gestion des erreurs de limitation de débit et outil de recherche plus robuste - + ## Optimisations des performances et de la build - * La transpilation MDX se fait désormais au moment du déploiement plutôt qu’à chaque chargement de page dans les environnements serverless NextJS non mis en cache, améliorant le time to first byte pour les pages non mises en cache. - * Le hachage basé sur le contenu empêche la retranspilation lorsque le MDX n’a pas changé, réduisant d’environ 50 % les temps de mise à jour pour les clients avec un grand nombre de pages (les déploiements de plus de 5 minutes devraient être à peu près divisés par deux) - * La consultation des déploiements de prévisualisation dans le Dashboard est désormais plus rapide grâce à l’ajout d’index de base de données et à la parallélisation des requêtes dans notre backend - * Réduction de la taille des pages en éliminant les données `navigation` dupliquées dans la charge utile `rsc` de chaque page — gains de performance particulièrement visibles avec un grand nombre de pages ou des structures de navigation complexes - * Un préchargement plus agressif permet des chargements de page instantanés plus fréquemment + * La transpilation MDX a désormais lieu au moment du déploiement plutôt qu’à chaque chargement de page dans les environnements serverless NextJS non mis en cache, ce qui améliore le time to first byte pour les pages non mises en cache. + * Le hachage basé sur le contenu évite la retranspilation lorsque le MDX n’a pas changé, réduisant d’environ 50 % les temps de mise à jour pour les clients avec un grand nombre de pages (les déploiements de plus de 5 minutes devraient être approximativement divisés par deux). + * L’affichage des aperçus de déploiement dans le Dashboard est désormais plus rapide grâce à l’ajout d’index de base de données et à la parallélisation des requêtes dans notre backend. + * Réduction de la taille des pages en éliminant les données `navigation` dupliquées dans la charge utile `rsc` de chaque page — gains de performance particulièrement visibles avec un grand nombre de pages ou des structures de navigation complexes. + * Un préchargement plus agressif permet des chargements de page instantanés plus fréquents. ## Améliorations du bac à sable d’API et d’OpenAPI - * La conversion OpenAPI vers MCP a été déplacée vers le backend, permettant aux serveurs MCP hébergés de contenir des outils (attendez-vous bientôt à une documentation plus claire et à des options de configuration) - * Ajout de la prise en charge de Ruby dans le bac à sable d’API - * Nous avons ajouté une fonctionnalité qui vous permet désormais de [spécifier des pages d’API à l’aide de votre docs.json uniquement](/fr/api-playground/openapi-setup#auto-populate-api-pages) sans créer de nouveaux fichiers mdx. - * Prise en charge des [pages `webhook`](/fr/api-playground/openapi-setup#webhooks) dans la navigation de la documentation à partir des spécifications OpenAPI - * Contexte de modèle d’IA optimisé en supprimant les ancres des liens Markdown lors de la navigation vers Anthropic, OpenAI ou d’autres fournisseurs + * La conversion OpenAPI vers MCP a été déplacée vers le backend, permettant aux serveurs MCP hébergés d’inclure des outils (bientôt, une documentation plus claire et des options de configuration). + * Ajout de la prise en charge de Ruby dans le bac à sable d’API. + * Nous avons ajouté une fonctionnalité qui vous permet désormais de [définir des pages d’API uniquement via votre docs.json](/fr/api-playground/openapi-setup#auto-populate-api-pages) sans créer de nouveaux fichiers mdx. + * Prise en charge des [pages `webhook`](/fr/api-playground/openapi-setup#webhooks) dans la navigation des docs à partir des spécifications OpenAPI. + * Contexte de modèle IA optimisé en supprimant les spécifications de liens d’ancrage des liens Markdown lors de la navigation vers Anthropic, OpenAI ou d’autres fournisseurs. ## Améliorations de l’éditeur web - * La création/le renommage de fichiers enregistre désormais les modifications lors d’un clic à l’extérieur au lieu d’exiger l’appui sur la touche Entrée - * Correction de la navigation entre branches où la modification de l’URL vers une branche spécifique redirigeait vers la dernière branche active au lieu de la destination prévue - * Encodage correct des titres de branche contenant `/` dans les URL pour éviter les ruptures de navigation - * Correction du raccourci de lien `Ctrl+K` dans l’éditeur du Dashboard de monorepo qui préfixait le chemin du dépôt de docs et créait des liens cassés + * La création/le renommage de fichiers enregistre désormais les modifications lors d’un clic à l’extérieur au lieu d’exiger l’appui sur la touche Entrée. + * Correction de la navigation entre branches où la modification de l’URL vers une branche spécifique redirigeait vers la dernière branche active au lieu de la destination prévue. + * Encodage correct en URL des titres de branche contenant `/` pour éviter les problèmes de navigation. + * Correction du raccourci de création de lien `Ctrl+K` dans l’éditeur du Dashboard pour monorepo, qui préfixait le chemin du dépôt de docs et créait des liens cassés. ## Analytics et intégrations LLM - * Prise en charge de `llms.txt` et `llms-full.txt` personnalisés — ajoutez-les à la racine du dépôt de docs pour les servir aux endpoints `/llms.txt` et `/llms-full.txt` pour la personnalisation LLM - * Ajout de l’[intégration Analytics Hightouch](/fr/integrations/analytics/hightouch#hightouch) - * Amélioration du suivi Analytics du menu contextuel (affichage dans le Dashboard à venir) - * Ajout de tests e2e pour `llms.txt` et `llms-full.txt` afin de garantir une diffusion correcte + * Prise en charge de `llms.txt` et `llms-full.txt` personnalisés — ajoutez-les à la racine du dépôt de docs pour les servir aux endpoints `/llms.txt` et `/llms-full.txt` pour la personnalisation LLM. + * Ajout de l’[intégration Analytics Hightouch](/fr/integrations/analytics/hightouch#hightouch). + * Amélioration du suivi Analytics du menu contextuel (affichage dans le Dashboard à venir). + * Ajout de tests e2e pour `llms.txt` et `llms-full.txt` afin de garantir une diffusion correcte. ## Améliorations des composants et du style - * Prise en charge de classnames personnalisées dans les balises `h{1-4}` pour appliquer des styles de titres personnalisés - * Correction des balises `h{1-4}` rendues en tant que composants `Heading` avec puces en mode page personnalisée - * Ajout de sélecteurs CSS aux [breadcrumbs](/fr/organize/navigation#breadcrumbs) pour un ciblage CSS personnalisé - * Correction des images Open Graph étirées en analysant les dimensions pour maintenir les proportions à 56 px de height - * Correction de `VSCode` en `VS Code` dans le menu contextuel lorsque l’option est activée - * Correction des titres au sein de composants personnalisés apparaissant dans la table des matières aux côtés des titres sémantiques + * Prise en charge des classnames personnalisés dans les balises `h{1-4}` pour appliquer des styles de titres personnalisés. + * Correction des balises `h{1-4}` rendues comme composants `Heading` avec chips en mode page personnalisée. + * Ajout de sélecteurs CSS aux [breadcrumbs](/fr/organize/navigation#breadcrumbs) pour un ciblage CSS personnalisé. + * Correction des images Open Graph étirées en analysant les dimensions pour conserver les proportions à une height de 56px. + * Correction de `VSCode` en `VS Code` dans le menu contextuel lorsque l’option est activée. + * Correction des titres au sein de composants personnalisés apparaissant dans la table des matières aux côtés des titres sémantiques. ## Corrections de bugs et fiabilité - * Correction des problèmes de rendu PDF avec certains titres de page en assainissant les caractères qui provoquent des problèmes de génération - * Résolution de l’erreur de la CLI `Cannot convert undefined or null to object` lors de la rencontre de fichiers OpenAPI JSON vides - * Correction des métabalises Open Graph `docs.json` personnalisées écrasées par celles générées - * Correction des clics sur le bouton du flux RSS lors de l’arrivée sur des liens d’ancrage en utilisant l’origine + le pathname pour les liens RSS - * Amélioration de la vitesse de téléchargement de la CLI en supprimant les sourcemaps + * Correction des problèmes de rendu PDF avec certains titres de page en assainissant les caractères qui posent problème lors de la génération. + * Résolution de l’erreur de la CLI `Cannot convert undefined or null to object` lors de la rencontre de fichiers OpenAPI JSON vides. + * Correction des métabalises Open Graph `docs.json` personnalisées écrasées par celles générées. + * Correction des clics sur le bouton du flux RSS lors de l’arrivée sur des liens d’ancrage en utilisant origin + pathname pour les liens RSS. + * Amélioration de la vitesse de téléchargement de la CLI en supprimant les sourcemaps. ## Améliorations techniques - * Ajout de tests visuels au pipeline CI pour une détection plus précoce des régressions - * Amélioration de la gestion des erreurs et des capacités de débogage - * Couverture de tests complète pour les nouvelles fonctionnalités et les cas limites + * Ajout de tests visuels au pipeline CI pour une détection plus précoce des régressions. + * Amélioration de la gestion des erreurs et des capacités de débogage. + * Couverture de tests complète pour les nouvelles fonctionnalités et les cas limites. - + ## Améliorations de l’authentification - * Accès public au niveau des groupes : rendez des groupes de pages entiers publics via `docs.json` pour éviter d’avoir `public: true` sur chaque page ([en savoir plus](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level)) + * Accès public au niveau du groupe : rendez des groupes de pages entiers publics via `docs.json` pour éviter d’avoir `public: true` sur chaque page ([en savoir plus](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level)) * Prise en charge de [`logoutURL` dans la configuration OAuth](https://mintlify.com/docs/authentication-personalization/authentication-setup#implementation-3) pour supprimer les cookies en amont et finaliser la déconnexion * En cas d’erreur OAuth, les utilisateurs sont redirigés vers le `logoutURL` que vous avez spécifié pour relancer le flux d’authentification - * Correction d’un flash d’erreur 500 pendant les flux OAuth/JWT avant le callback - * Suppression automatique de `https://` des URL dans la configuration d’auth OAuth/JWT pour éviter les erreurs de configuration + * Correction d’un bref affichage d’erreur 500 pendant les flux OAuth/JWT avant le callback + * Suppression automatique de `https://` des URL dans la configuration d’auth OAuth/JWT pour éviter les mauvaises configurations ## Améliorations du bac à sable d’API - * Nouveau [endpoint Search API](https://mintlify.com/docs/api-reference/assistant/search) pour vous permettre de créer des agents et des serveurs MCP par-dessus votre documentation + * Nouveau [endpoint Search API](https://mintlify.com/docs/api-reference/assistant/search) pour créer des agents et des serveurs MCP par‑dessus votre documentation * Les fichiers `openapi` et `asyncapi` sont désormais servis à leurs chemins spécifiés (par exemple, `https://mydocsurl.extension/{openapi-or-file-name}.json`) - * Vous pouvez désormais utiliser le [`x-mint` field in your openapi files](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) pour remplacer des champs générés, personnaliser le contenu d’introduction ou modifier les URL des endpoints dans les exemples de code - * [`x-mcp` est désormais `x-mint.mcp`](https://mintlify.com/docs/api-playground/openapi-setup#mcp) dans les configurations OpenAPI pour contrôler quelles routes sont exposées comme outils MCP + * Vous pouvez désormais utiliser le [champ `x-mint` dans vos fichiers openapi](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) pour remplacer des champs générés, personnaliser le contenu de préambule ou modifier les URL des endpoints dans les exemples de code + * [`x-mcp` devient `x-mint.mcp`](https://mintlify.com/docs/api-playground/openapi-setup#mcp) dans les configurations OpenAPI pour contrôler quelles routes sont exposées en tant qu’outils MCP ## Mises à jour de l’Assistant - * Correction d’un problème où le menu d’action (avec des options comme copier et pouce levé) des anciens messages disparaissait lorsque de nouveaux messages arrivaient en flux - * Correction de l’accessibilité des pages imbriquées `/mcp/...` après la [publication des serveurs MCP hébergés](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server) la semaine dernière + * Correction d’un problème où le menu d’actions (options comme copier et pouce levé) des anciens messages disparaissait lorsque de nouveaux messages arrivaient en flux + * Correction de l’accessibilité des pages imbriquées `/mcp/...` après la [sortie des serveurs MCP hébergés](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server) la semaine dernière - ## Performance et fiabilité + ## Performances et fiabilité - * Tous les fichiers image et vidéo présents dans votre dépôt de documentation sont désormais servis au chemin approprié sur votre domaine. Par exemple, si vous avez `/assets/marketing/my-logo.png` dans votre dépôt, il sera disponible à `https://mydocsurl.extension/assets/marketing/my-logo.png`. - * Le champ e-mail sur l’écran de connexion du Tableau de bord Mintlify se focalise désormais automatiquement pour que vous puissiez commencer à taper immédiatement *(amélioration du confort)* - * Indexation des domaines personnalisés et des sous-domaines dans Redis pour améliorer les temps de chargement de la navigation (réduction de latence d’environ 50 ms) + * Tous les actifs image et vidéo présents dans votre dépôt de documentation sont désormais servis au chemin approprié sur votre domain. Par exemple, si vous avez `/assets/marketing/my-logo.png` dans votre dépôt, il sera disponible à `https://mydocsurl.extension/assets/marketing/my-logo.png`. + * Le champ e‑mail sur la page de connexion du Tableau de bord Mintlify est désormais focalisé automatiquement pour que vous puissiez commencer à saisir immédiatement *(amélioration du confort d’utilisation)* + * Prise en charge des domaines personnalisés et des sous‑domaines dans Redis pour améliorer les performances au chargement de la navigation (~50 ms de réduction de latence) * Ajout d’une logique de nouvelle tentative pour les exports PDF afin d’améliorer la fiabilité - * Correction de la réapparition de la bannière de consentement aux cookies après acceptation ou fermeture — la première sélection est désormais respectée - * Correction de la copie d’une page dans le presse-papiers sur Safari en spécifiant un `type` MIME dans `navigator.write` + * Correction de la fenêtre contextuelle de consentement aux cookies qui réapparaissait après acceptation ou refus — la première sélection est désormais respectée + * Correction de la copie d’une page vers le presse‑papiers sur Safari en spécifiant un `type` MIME dans `navigator.write` ## Améliorations techniques - * Corrections de bugs de l’Interface en ligne de commande (CLI) pour Windows et pnpm, plus des tests CI pour prévenir les régressions - * Amélioration de la sortie des logs d’erreur — un gain de confort pour notre équipe d’ingénierie lors du débogage + * Corrections de bogues de l’Interface en ligne de commande (CLI) pour Windows et pnpm, plus des tests CI pour prévenir les régressions + * Amélioration de la sortie des logs d’erreurs — un vrai gain de confort pour notre équipe d’ingénierie lors du débogage * Corrections mineures de l’action CI de liens cassés lorsque les fichiers `contentDirectory` sont manquants - * Correction d’une régression causée par les correctifs d’aperçu protégé par authentification de la semaine dernière où l’onglet actif n’était pas correctement défini dans l’interface de navigation - * Correction de la couleur d’arrière-plan du thème light qui ne s’appliquait pas aux icônes de l’onglet actif - * Correction d’un problème où la modification du type d’auth dans le Tableau de bord mettait à jour puis revenait au type précédemment enregistré — la nouvelle sélection persiste désormais après l’enregistrement + * Correction d’une régression due aux correctifs d’aperçu protégé par authentification de la semaine dernière, où l’onglet actif n’était pas correctement défini dans l’interface de navigation + * Correction de l’application de la couleur d’arrière‑plan light du thème aux icônes d’onglet actives + * Correction d’un problème où la modification du type d’authentification dans le Dashboard s’appliquait puis revenait à l’ancien type enregistré — la nouvelle sélection persiste désormais après enregistrement * Améliorations internes de l’DX pour les clients entreprise avec des bibliothèques UI personnalisées — il nous est désormais plus facile d’inclure vos composants et de répondre aux demandes sur des délais plus courts - + ## Améliorations de l’authentification - * Améliorations du développement local de l’auth, permettant d’itérer plus vite sur les fonctionnalités d’auth et les correctifs de bugs dans cette zone du produit - * Les déploiements de prévisualisation sont désormais disponibles pour les sites protégés par auth - * Correction du comportement de redirection pour renvoyer correctement les utilisateurs vers leur page d’origine après l’authentification - * Correction de l’affichage du bouton de déconnexion pour l’authentification complète (auparavant, cela ne fonctionnait que pour l’authentification partielle) + * Améliorations du développement local de l’authentification, permettant d’accélérer le développement des fonctionnalités et les correctifs de bugs dans cette zone du produit + * Aperçus de déploiement désormais disponibles pour les sites protégés par authentification + * Correction du comportement de redirection pour renvoyer correctement les utilisateurs vers leur page d’origine après authentification + * Correction de l’affichage du bouton de déconnexion pour l’authentification complète (auparavant, ne fonctionnait que pour l’authentification partielle) ## Améliorations du bac à sable d’API * Correction du téléversement de fichiers `multipart/form-data` dans le bac à sable d’API - * Correction du comportement des liens d’ancrage pour qu’un clic mette à jour l’URL sans remonter en haut de page - * Correction des liens d’ancrage dans les onglets imbriqués + * Correction du comportement des liens d’ancrage afin que le clic mette à jour l’URL sans remonter en haut de page + * Correction des problèmes de liens d’ancrage dans les onglets imbriqués ## Mises à jour de l’Assistant - * Nouvelle API de l’Assistant pour l’intégrer à vos propres produits, compatible avec l’AI SDK - * Ajout d’un bouton de copie aux réponses de chat - * Correction d’un problème lors de la relance de l’envoi des messages dans l’assistant - * Amélioration de l’invite par défaut de l’assistant pour la rendre moins verbeuse + * Nouvelle API de l’Assistant pour l’intégrer à vos propres produits, compatible avec le SDK d’IA + * Ajout d’un bouton de copie aux réponses du chat + * Correction d’un problème lors de la nouvelle tentative d’envoi de messages dans l’Assistant + * Amélioration de l’invite par défaut de l’Assistant pour la rendre moins verbeuse ## Performances et fiabilité * Recherche plus réactive et précise en annulant les requêtes différées pendant la saisie - * Provisionnement des ressources pour un nouveau CDN — attendez-vous bientôt à des temps de chargement d’images et de pages améliorés - * Correction de bugs lors du rendu de diagrammes Mermaid complexes comme les diagrammes GANTT + * Provisionnement de ressources pour un nouveau CDN — les temps de chargement des images et des pages devraient bientôt s’améliorer + * Correction de bugs pour le rendu de diagrammes Mermaid complexes, comme les diagrammes GANTT * Correction de bugs de la CLI sur Windows pour améliorer la stabilité et ajout de tests pour éviter les régressions ## Améliorations techniques - * Ajout d’OpenTelemetry pour les traces dans l’application NextJS afin d’améliorer le time to first byte pour les clients + * Ajout d’OpenTelemetry pour les traces dans l’application NextJS afin d’améliorer le temps jusqu’au premier octet pour les clients * Migration d’Octokit vers GitHub API Client pour réduire la latence dans l’éditeur web - * Suppression des balises meta OpenGraph en double + * Correction des balises meta dupliquées pour OpenGraph * Mise à niveau de MongoDB de la version 6 à la 7 pour de meilleures performances et de nouvelles fonctionnalités - + ## Application Slack - * Accès sans friction : le bot répond aux DMs, aux @mentions et à toute question dans votre canal `#ask-ai` + * Accès sans friction : le bot répond aux messages privés, aux @mentions et à toute question dans votre canal `#ask-ai` * Configuration en un clic : installez directement depuis votre Tableau de bord Mintlify en quelques secondes - * Réponses contextuelles : parcourt toute votre documentation pour fournir des réponses pertinentes et précises + * Réponses contextuelles : parcourt l’ensemble de votre documentation pour fournir des réponses pertinentes et exactes * Réduisez les interruptions du support : transformez les questions quotidiennes en réponses instantanées en libre-service - En savoir plus dans notre [guide de l’app Slack](/fr/ai/slack-app). + En savoir plus dans notre [guide de l’application Slack](/fr/ai/slack-app). ## Serveurs MCP hébergés - Déployez des serveurs Model Context Protocol (MCP) hébergés directement via Mintlify pour les intégrer à des outils d’IA comme Claude, Cursor, et d’autres. En savoir plus dans notre [guide MCP](/fr/ai/model-context-protocol). + Déployez des serveurs Model Context Protocol (MCP) hébergés directement via Mintlify pour intégrer des outils d’IA comme Claude, Cursor et autres. En savoir plus dans notre [guide MCP](/fr/ai/model-context-protocol). Aidez les utilisateurs à connecter rapidement votre serveur MCP à Cursor ou VS Code depuis n’importe quelle page de votre documentation via le menu contextuel. Voir [Menu contextuel](/fr/ai/contextual-menu) pour plus d’informations. ## Améliorations des code blocks - * Meilleure coloration syntaxique - * Plus d’options de personnalisation, y compris le mode focus, les code blocks extensibles, l’adaptation aux modes sombre et clair, le menu déroulant de langue, la numérotation des lignes et les icônes + * Amélioration de la coloration syntaxique + * Ajout de davantage d’options de personnalisation, notamment le mode focus, les code blocks extensibles, l’adaptation aux modes sombre et clair, le menu déroulant de la langue, la numérotation des lignes et des icônes - + ## Mises à jour de l’Assistant IA * Précision améliorée grâce à un RAG agentique avec appel d’outils * Fournit des liens navigables vers les pages référencées afin que les utilisateurs puissent aller directement à la source des réponses - * Raccourci de copie pour les exemples de code générés par l’assistant - * Raccourci "Ask AI" sur les code blocks dans la documentation pour générer des explications depuis l’assistant + * Raccourci de copie pour les exemples de code générés par l’Assistant + * Raccourci « Ask AI » sur les code blocks de la documentation pour générer des explications à partir de l’Assistant - En savoir plus dans la [documentation de l’assistant](/fr/ai/assistant). + En savoir plus dans la [documentation de l’Assistant](/fr/ai/assistant). ## Journaux des modifications abonnables - * Générer automatiquement un flux RSS à partir des pages du journal des modifications - * Intégrer les mises à jour compatibles RSS avec Slack, l’e-mail et d’autres outils + * Génération automatique d’un flux RSS à partir des pages du journal des modifications + * Intégrez les mises à jour compatibles RSS avec Slack, l’e-mail et d’autres outils En savoir plus dans notre nouveau [guide du journal des modifications](/fr/create/changelogs) @@ -371,14 +371,14 @@ noindex: true * Rechercher pour trouver un endpoint * Indiquer un endpoint obsolète avec une étiquette - * Masquer les pages d’API générées automatiquement de la navigation + * Masquer les pages d’API générées automatiquement dans la navigation * Téléverser des fichiers multipart ou des données de formulaire En savoir plus dans la [documentation du bac à sable d’API.](/fr/api-playground/) ## `mint update` - Vous pouvez désormais utiliser `mint update` pour mettre à jour votre Interface en ligne de commande (CLI). + Vous pouvez désormais utiliser `mint update` pour mettre à jour votre interface en ligne de commande (CLI). diff --git a/fr/optimize/seo.mdx b/fr/optimize/seo.mdx index 524572c5d..99737901b 100644 --- a/fr/optimize/seo.mdx +++ b/fr/optimize/seo.mdx @@ -47,9 +47,13 @@ title: "Titre de votre page d'exemple" ## Référence des balises meta courantes -Vous trouverez ci-dessous une liste complète des balises meta que vous pouvez ajouter à votre `docs.json`. Ces balises meta contribuent à améliorer le SEO de votre site, le partage sur les réseaux sociaux et la compatibilité des navigateurs. +Vous trouverez ci-dessous une liste complète des balises meta que vous pouvez ajouter à votre `docs.json`. Ces balises meta améliorent le SEO de votre site, le partage sur les réseaux sociaux et la compatibilité avec les navigateurs. -Vous pouvez prévisualiser l’affichage de vos balises meta sur différentes plateformes à l’aide de [metatags.io](https://metatags.io/). + + La balise `og:image` ajoute une image d’arrière-plan que Mintlify superpose automatiquement avec votre logo, le titre de la page et la description lors de la génération des aperçus pour les réseaux sociaux. + + +Vous pouvez prévisualiser l’apparence de vos balises meta sur différentes plateformes à l’aide de [metatags.io](https://metatags.io/). ```json expandable "seo": { diff --git a/zh/changelog.mdx b/zh/changelog.mdx index c62319e40..1253ccdf8 100644 --- a/zh/changelog.mdx +++ b/zh/changelog.mdx @@ -5,380 +5,380 @@ rss: true noindex: true --- - + ## 新功能 - * **Products 导航**：通过产品切换器为多个产品的文档进行组织 - * **无障碍 CLI 命令**：运行 `mint a11y` 测试文档的无障碍问题 + * **Products 导航**：通过产品切换器导航来组织多产品文档 + * **无障碍命令行界面（CLI）命令**：运行 `mint a11y` 测试文档中的无障碍问题 * **API 操作台中的视频响应**：API 操作台现已支持显示视频响应类型 * **API 操作台预填**：新增预填 API 操作台示例的选项，加快测试速度 - * **未认证反馈**：对启用部分认证的网站，用户现可在未认证情况下提交反馈 - * **Shiki 主题支持**：现已支持使用 Shiki 主题为代码块设定样式 - * **代码块的 Twoslash**：TypeScript 和 JavaScript 代码块现支持 Twoslash 内联类型信息 + * **未认证反馈**：对于使用部分认证的网站，用户现在无需认证即可提交反馈 + * **Shiki 主题支持**：现已支持用于代码块样式的 Shiki 主题 + * **Twoslash 支持代码块**：TypeScript 和 JavaScript 代码块现支持 Twoslash 内联类型信息 ## 无障碍改进 - * 在各组件中新增全面的 ARIA 属性，以更好地支持屏幕阅读器 - * 新增“跳至主要内容”按钮，便于键盘导航 + * 在各组件中添加了全面的 ARIA 属性，以更好地支持屏幕阅读器 + * 新增“跳至主内容”按钮，便于键盘导航 * 在 Tab 组件中支持方向键导航 - * 增强了工具提示、嵌套列表和代码组的可访问性 - * 改进了整个 UI 的焦点状态与键盘交互模式 + * 增强了工具提示、嵌套列表和代码组的无障碍性 + * 改进了全局 UI 的焦点状态和键盘交互模式 ## AI 助手与 Analytics 增强 - * 为助手 query 分析新增柱状图可视化 - * 在助手分析页统一了日期范围选择器 - * 为助手分析图表添加缩放控件 - * 通过热键与聊天面板改进，优化助手历史记录管理 + * 为 AI 助手 query 分析新增柱状图可视化 + * 在 AI 助手分析页面统一了日期范围选择器 + * 为 AI 助手分析图表新增缩放控件 + * 通过快捷键与聊天侧栏的改进，优化了 AI 助手历史记录管理 ## 缺陷修复与可靠性 - * 修复侧边面板覆盖层的 z-index 问题 - * 修复浅色模式的颜色回退与主题相关样式错误 + * 修复侧边面板遮罩的 z-index 问题 + * 修复浅色模式颜色回退与主题相关样式错误 * 修复 API 操作台可展开项与锚点链接不兼容的问题 - * 修复面向 ChatGPT 与其他 LLM 代理的 `.md` 链接可访问性 - * 修复按百分比 width 与 height 指定的图片尺寸处理 + * 修复针对 ChatGPT 和其他 LLM 代理的 `.md` 链接可访问性 + * 修复基于百分比的宽度与高度的图像尺寸处理 * 修复带语言标签与自定义主题的代码块渲染问题 * 修复折叠面板链接的格式与样式 - * 修复在助手配置为空时页脚间距异常 - * 修复本地存储库图片的卡片 icon 渲染 - * 修复 API 操作台中的音频文件处理（避免 UTF-8 解码） - * 改进网页版编辑器中的 PR 发布状态管理 + * 修复当 AI 助手配置为空时底部区域的间距 + * 修复本地存储库图像的卡片 icon 渲染 + * 修复 API 操作台中的音频文件处理（防止 UTF-8 解码） + * 改进网页编辑器中的 PR 发布状态管理 - + ## 语言支持扩展 - * 在文档界面中新增对 Romanian 和 Czech 的支持 - * 增强本地化能力，为新语言提供完整翻译覆盖 + * 在文档界面中新增对罗马尼亚语和捷克语的支持 + * 增强本地化能力，完整覆盖新增语言的翻译 * 改进所有主题中的语言选择器功能 ## UI 与用户体验改进 - * 修复 404 页面上的标签页可见性问题，避免错误的激活标签页高亮 - * 增强图片处理，为未优化图片正确传递 width 与 height 属性 + * 修复 404 页面上的标签页可见性问题，防止错误的活动标签页高亮 + * 增强图像处理，为非优化图像正确传递 width 和 height 属性 * 改进 404 页面的布局与样式一致性 ## 基础设施与性能增强 - * 通过跳过代价高的 Imgix 自动格式化，优化 GIF 图片处理，减少处理时间与带宽占用 - * 通过对动图的专项处理提升图片分发性能 + * 通过跳过高成本的 Imgix 自动格式化增强 GIF 图像处理，减少处理时间与带宽占用 + * 针对动图进行特殊处理以优化图像分发性能 ## 缺陷修复与可靠性 * 修复控制台设置中 Assistant 增强功能请求的联系邮箱路由 - * 增强数据库模式更新，以改进用户管理 + * 增强数据库架构更新以改进用户管理 - - ## 网页版编辑器与控制台登录改进 + + ## 网页编辑器与控制台登录改进 - * 持续推进网页版编辑器的 app router 迁移，移除阻塞并提升性能 - * 增强登录错误处理，提供明确的邮箱验证信息 + * 持续推进网页编辑器的 app router 迁移，移除阻碍并提升性能 + * 增强登录错误处理，提供明确的邮箱验证消息 * 修复邮箱地址验证中的空白字符处理 ## 认证改进 - * 在登录回调中新增对重定向参数的验证支持，降低登录阻力 + * 在登录回调中新增对重定向参数的验证支持，降低登录摩擦 * 改进 SSO 登录流程，优化重定向处理 ## 缺陷修复与可靠性 - * 修复 GitLab 集成在大型存储库上的问题 - * 通过优化 部署 查询，改进控制台加载性能 + * 修复 GitLab 集成在较大存储库中的问题 + * 通过优化部署相关查询改进控制台加载性能 * 修复文档中的 SVG 路径渲染问题 * 修复搜索与聊天功能中的键盘导航 - - ## 重大更新 + + ## 主要发布 - * **重要增强**：在 404 页面提供 AI 推荐，[当有人访问失效链接 → AI 代理解析路径 → 推荐语义相近的页面](https://x.com/mintlify/status/1966625627773059495) - * **重大发布**：AI 助手的网页搜索现在可包含外部来源\ + * **重大增强**：在 404 页面提供 AI 建议页面，[当用户访问失效链接 → AI 代理读取路径 → 建议语义相似的页面](https://x.com/mintlify/status/1966625627773059495) + * **重大发布**：AI 助手的网页搜索现在可以纳入外部来源\ *注意：如需为你的站点启用此功能，请联系我们。* ## AI 助手与 MCP - * 修复了因时间窗口未正确滑动而导致 AI 助手被错误限流的问题 - * 修复了 AI 助手在工具调用中处理空 `text` 块的错误 - * 修复了 MCP 服务器名称与工具调用拼接后有时会超过 MCP 客户端强制的 60 个字符限制的问题 - * 修复了 AI 助手菜单的 height 远大于视口并导致无限滚动的问题 - * 修复了控制台中 AI 助手花费金额可能显示超过两位小数的问题 + * 修复了因时间窗口未正确滑动，导致 AI 助手被错误地施加速率限制的问题 + * 修复了助手工具调用在处理空 `text` 块时的错误 + * 修复了 MCP 服务器名称与工具调用拼接后，有时会超过 MCP 客户端强制的 60 字符长度限制的问题 + * 修复了助手菜单的 height 远大于视口并无限滚动的问题 + * 修复了在控制台中助手花费数值可能显示超过两位小数的问题 - ## 网页编辑器与部署 + ## Web 编辑器与部署 - * 新增安全增强：仅对关联的 Git 托管存储库具有 `write permissions` 的用户才能在编辑器中进行更改 - * 修复了名称中包含 `=` 的 branch 无法创建预览部署的问题 - * 修复了过长的 branch 名称在创建预览部署时会溢出模态框的问题 - * 体验优化：注册邀请中，email query 参数将预填输入框 - * 修复了在 Safari 上通过上下文菜单复制页面无效的问题 + * 为编辑器新增安全增强：只有对已连接的 Git 托管存储库拥有 `write permissions` 的用户才能进行更改 + * 修复了名称中包含 `=` 的 branch 无法进行预览部署的问题 + * 修复了在创建预览部署时，过长的 branch 名称在弹窗中溢出的情况 + * 体验优化：注册邀请中的 email query 参数现在会预填输入框 + * 修复了在 Safari 上通过上下文菜单复制页面不起作用的问题 ## API 操作台与导航 - * 多个 API 操作台响应码在聚焦时现以受控的样式化选择菜单显示，而非系统默认选择菜单 - * 你现在可以在 `docs.json` 的导航 groups 中使用 [`expanded` 字段使其默认展开](https://mintlify.com/docs/navigation#default-expanded-state) + * 多个 API 操作台响应码在获得焦点时，现以受控样式的选择菜单显示，而非系统默认的选择菜单 + * 你现在可以在 `docs.json` 中的导航 groups 使用 [`expanded` 字段，使其默认展开](https://mintlify.com/docs/navigation#default-expanded-state) - ## SEO 与界面 + ## SEO 和 UI - * 通过从与各文档站相同的 URL 提供 favicon，修复了搜索引擎中不显示站点图标的问题 + * 修复了站点图标在搜索引擎中未显示的问题：现通过与各自文档站点相同的 URL 提供 * 修复了 YouTube 嵌入在加载时闪烁的问题 - * 修复了将反馈菜单扩展为包含文字回复时与目录之间出现布局位移的问题 - * 修复了在 Maple 主题中关闭通知横幅后文本溢出到顶栏上方的问题 - * 优化了 Maple 与 Willow 主题，在侧边栏新增登录/登出按钮，便于访问 + * 修复了将反馈菜单展开以包含文字回复时，导致与目录产生布局位移的问题 + * 修复了在 Maple 主题中关闭通知横幅后，文本会溢出到顶部栏之上的问题 + * 优化 Maple 和 Willow 主题：在侧边栏添加了登录/登出按钮，便于访问 ## Analytics 与导出 - * 修复了 AI 助手分析视图与导出的可靠性问题 - * AI 助手分析导出现改为在后台执行，并通过电子邮件发送，以提供更稳定可靠的体验 + * 修复了助手 Analytics 视图和导出的可靠性问题 + * 助手 Analytics 导出现在在后台执行，并通过电子邮件发送，提升稳定性与可靠性 - - ## 重大发布：更强大的反馈收集 + + ## 重大版本发布：反馈收集增强 - * **重大改进**：读者在选择“点赞/点踩”后，现在可以提供更为详尽的反馈，包括选项与文字评论。你还可以对代码块收集反馈，并在控制台的 Analytics 中查看所有反馈。\ - *注意：请联系我们为你的站点启用此功能。* + * 重大改进：读者在选择点赞/点踩后，现在可以提供更详细的反馈，包括选项和文字评论。你还可以对代码块收集反馈，并在控制台的 Analytics 中查看所有反馈。\ + 注意：请联系我们为你的网站启用此功能。 ## 导航与易用性改进 - * 易用性优化：忽略结尾斜杠与双斜杠，你无需在 docs.json 中严格保证格式完全一致 - * 现在可在 `h1-6` HTML 标签上添加 `noAnchor` 属性，避免生成锚点链接 - * Palm 主题现于左下角提供浮动语言选择器，类似 Stripe 的做法 - * 在 docs.json 中新增字段 [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups)，用于控制当导航分组展开时，是否自动进入该分组的第一页 - * 易用性优化：嵌套有序列表的样式将在十进制/罗马数字与字母之间交替 + * 易用性改进：忽略末尾斜杠和双斜杠，这样你就无需在 docs.json 中把它们处理得一丝不苟 + * 现在你可以在 `h1-6` HTML 标签上添加 `noAnchor` 属性，以避免生成锚点链接 + * Palm 主题现在在左下角提供浮动语言选择器，类似 Stripe 的做法 + * 在 docs.json 中新增名为 [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups) 的字段，可控制在展开某个导航分组时，是否将用户自动导航至该分组的第一页 + * 易用性改进：使嵌套有序列表的样式在十进制/罗马数字与字母样式之间交替 - ## 错误修复与可靠性 + ## Bug 修复与可靠性 - * 修复了页面存在 JS 组件时，滚动位置锚点链接工作不正确的问题 - * 修复了因缺少 `x-robots-tag noindex` 头而导致 Google 将原始 `*.md` 文件编入索引的问题 - * 修复了受保护文档的 OAuth 问题：成功完成流程后不会重定向回起始页面 - * 修复了受认证保护文档的预览中无法看到完整导航栏的问题 - * 修复了使用新图片 CDN 处理 SVG 的相关问题 + * 修复了当页面存在 JS 组件时，滚动位置锚点链接无法正常工作的错误 + * 修复了由于缺少 `x-robots-tag noindex` 头而导致 Google 将原始 `*.md` 文件编入索引的问题 + * 修复了受保护文档上的 OAuth 问题：成功完成流程后不会重定向回起始页面 + * 修复了认证保护文档的预览中无法看到整个导航栏的问题 + * 修复了使用我们新的图片 CDN 处理 SVG 的相关问题 ## 组件与样式增强 - * 为 `SidebarNavGroupDivider` 新增用于自定义样式的 CSS 选择器 - * 为在 MDX 中定义且含有安全设置的 API 页面新增回归测试，以确保更高稳定性 + * 为 `SidebarNavGroupDivider` 的自定义样式新增了一个 CSS 选择器 + * 新增针对由 MDX 定义且配置了安全性的 API 页面之回归测试，以确保更高的稳定性 ## 性能改进 - * 将 KaTeX CSS 从 cdnjs 迁移到我们在 CloudFront 上的自有 CDN，以降低时延并提升性能 + * 通过将 KaTeX 的 CSS 从 cdnjs 迁移到我们在 CloudFront 上的自有 CDN，降低延迟、提升性能 - - ## 图像处理改进 + + ## 图片处理改进 - * **重大改进**：即使未指定 width 和 height 属性，图像默认也不会再造成布局位移——自动尺寸可防止页面加载过程中的内容跳动 - * 存储库中的所有静态文件（PDF、TXT、XML 等）现会在部署时自动上传并提供服务，实现完整的资源覆盖 + * 重大改进：即使未指定 width 和 height 属性，图片默认也不会造成布局位移——自动尺寸可防止页面加载期间的内容跳动 + * 存储库中的所有静态文件（PDF、TXT、XML 等）现在会在部署时自动上传并提供服务，覆盖所有资源 - ## 网页编辑器与部署增强 + ## Web 编辑器与部署增强 - * 修复了网页编辑器中的 branch 创建流程，现在会正确跳转并停留在新建的 branch 上 - * 增强合并冲突对话框的转义处理，无需刷新页面即可关闭冲突 - * 优化更新流程性能：在部分更新时仅对变更页面进行缓存失效处理，缩短部署时间 + * 修复了 Web 编辑器中的 branch 创建流程，可正确跳转并停留在新创建的 branch 上 + * 增强了合并冲突对话框的退出能力，无需再通过刷新页面来关闭冲突 + * 优化更新流程性能：在部分更新时仅对变更页面进行缓存失效处理，从而缩短部署时间 ## 认证与导航改进 - * 新增对自定义子目录的认证支持；若文档服务于 `https://yourdomain.com/docs`，认证将无缝工作 - * 修复了在仅配置一个链接时侧边栏错误显示的问题 - * 全面升级移动端导航：按钮居中并具有合理的外边距/内边距；改进下拉菜单间距；移除空区块的不必要分隔线与边距；修复 Maple 主题中的间隙/内边距问题 + * 新增对自定义子目录的认证支持；如果你在 `https://yourdomain.com/docs` 提供文档，认证现在可无缝工作 + * 修复了仅配置一个链接时侧边栏仍会错误显示的问题 + * 全面优化移动端导航：按钮居中并具有合适的外边距/内边距，改进下拉菜单的间距，移除空章节中不必要的分隔线和边距，并修复 Maple 主题的间距/内边距问题 ## 组件与样式修复 - * 解决了将 `` 标签错误转换为 Heading 组件从而破坏自定义样式的问题 - * 在控制台新增一键切换 AI 助手配置，便于管理 + * 解决了 `` 标签被错误转换为 Heading 组件从而破坏自定义样式的问题 + * 在控制台中为 AI 助手新增一键配置开关，便于管理 ## 技术改进与可靠性 - * 增强更新工作流的日志系统，加快调试与问题定位 - * 通过从单文件抓取切换为存储库克隆，修复了拥有 10+ OpenAPI/AsyncAPI 规范的客户在 GitHub 上遇到的速率限制问题 - * 提升 AI 助手可靠性：增加备援 LLM 支持、改进限流错误处理，并强化搜索工具功能 + * 增强了更新流程的日志系统，加快调试与问题解决 + * 为拥有 10+ OpenAPI/AsyncAPI 规范的客户修复了 GitHub 速率限制问题：由逐个文件抓取改为存储库克隆 + * 提升了 AI 助手的可靠性：增加后备 LLM 支持、强化限流错误处理，以及更稳健的搜索工具能力 - + ## 性能与构建优化 - * 在未缓存的 NextJS 无服务器环境中，MDX 转译改为在部署时执行，而非每次页面加载时执行，从而改善未缓存页面的首字节时间（TTFB）。 - * 基于内容的哈希在 MDX 未变化时避免重新转译，将大量页面项目的更新流程时间缩短约 50%（超过 5 分钟的部署大致减半）。 - * 在控制台中预览部署的加载速度更快——我们在后端新增数据库索引并对查询进行并行化。 - * 通过移除每个页面 `rsc` 负载中的重复 `navigation` 数据，减小页面体积——在页面数量多或导航结构复杂时性能提升更明显。 - * 更积极的预取策略，使页面更常实现即刻加载。 + * 在未缓存的 Next.js 无服务器环境中，MDX 转译现改为在部署时进行，而非每次页面加载时进行，从而缩短未缓存页面的首字节时间（TTFB）。 + * 基于内容的哈希在 MDX 未发生变化时会阻止重新转译，将大量页面项目的更新流程时长降低约 50%（超过 5 分钟的部署应大致减半） + * 通过在后端添加数据库索引并对 query 并行化，控制台中的预览部署加载更快 + * 通过移除每个页面 `rsc` 负载中重复的 `navigation` 数据来减小页面体积——在页面数量多或导航结构复杂时收益最明显 + * 更积极的预取使即时页面加载更常见 - ## API 操作台与 OpenAPI 增强 + ## API 操作台和 OpenAPI 增强 - * 将 OpenAPI 到 MCP 的转换迁移到后端，使托管的 MCP 服务器能够包含工具（更清晰的文档与配置选项即将推出）。 - * 为 API 操作台新增 Ruby 支持。 - * 新增功能：现在你可以[仅通过 docs.json 指定 API 页面](/zh/api-playground/openapi-setup#auto-populate-api-pages)，无需创建任何新的 mdx 文件。 - * 在来自 OpenAPI 规范的文档导航中支持 [`webhook` 页面](/zh/api-playground/openapi-setup#webhooks)。 - * 优化 AI 模型上下文：在跳转至 Anthropic、OpenAI 或其他提供商时，从 Markdown 链接中去除锚点参数。 + * 将 OpenAPI 到 MCP 的转换迁移到后端，使托管的 MCP 服务器可包含工具（更清晰的文档和配置选项即将推出） + * 为 API 操作台新增 Ruby 支持 + * 新增功能：现在你可以[仅通过 docs.json 指定 API 页面](/zh/api-playground/openapi-setup#auto-populate-api-pages)，无需创建新的 mdx 文件。 + * 在文档导航中支持来自 OpenAPI 规范的 [`webhook` 页面](/zh/api-playground/openapi-setup#webhooks) + * 通过在导航至 Anthropic、OpenAI 或其他提供商时，从 Markdown 链接中移除锚点规格来优化 AI 模型上下文 ## Web 编辑器改进 - * 创建/重命名文件时，点击空白处即可保存变更，不再强制要求按 Enter 键。 - * 修复了 branch 导航问题：将 URL 切换到特定 branch 时会被重定向至上次活动的 branch，而非预期目标。 - * 对包含 `/` 的 branch 标题进行正确的 URL 编码，避免导航异常。 - * 修复了 monorepo 控制台编辑器中 `Ctrl+K` 链接快捷键会在前面加上文档仓库路径而导致链接失效的问题。 + * 创建/重命名文件时，点击空白处即可保存更改，无需再按 Enter 键 + * 修复 branch 导航：将 URL 切换到特定 branch 时会错误地重定向到上次活动的 branch，而非目标分支 + * 正确对包含 `/` 的 branch 标题进行 URL 编码，避免导航出错 + * 修复 monorepo 控制台编辑器中的 `Ctrl+K` 插入链接快捷键此前会在前面附加 docs 仓库路径并导致链接失效的问题 - ## Analytics 与 LLM 集成 + ## Analytics 和 LLM 集成 - * 支持自定义 `llms.txt` 与 `llms-full.txt`——将其添加到文档仓库根目录，即可在 `/llms.txt` 与 `/llms-full.txt` 端点提供，用于定制 LLM。 - * 新增 [Hightouch 分析集成](/zh/integrations/analytics/hightouch#hightouch)。 - * 增强了上下文菜单的分析追踪（控制台可视化即将推出）。 - * 为 `llms.txt` 与 `llms-full.txt` 添加端到端（e2e）测试，确保正确提供。 + * 支持自定义 `llms.txt` 和 `llms-full.txt`——将其添加到文档仓库根目录，即可通过 `/llms.txt` 和 `/llms-full.txt` 端点对 LLM 进行定制 + * 新增 [Hightouch 分析集成](/zh/integrations/analytics/hightouch#hightouch) + * 增强对上下文菜单的分析跟踪（控制台视图即将上线） + * 为 `llms.txt` 和 `llms-full.txt` 添加端到端测试，确保正确提供 ## 组件与样式增强 - * `h{1-4}` 标签支持自定义 className，以应用自定义标题样式。 - * 修复了自定义页面模式下 `h{1-4}` 标签被渲染为带徽章的 `Heading` 组件的问题。 - * 为[面包屑](/zh/organize/navigation#breadcrumbs)新增 CSS 选择器，便于自定义 CSS 定位。 - * 通过分析图像尺寸，在 56px height 下保持比例，修复被拉伸的 open-graph 图像。 - * 在上下文菜单中将 `VSCode` 更正为 `VS Code`。 - * 修复了自定义组件内的标题与语义化标题一同出现在目录中的问题。 + * 支持在 `h{1-4}` 标签中使用自定义类名，以应用自定义标题样式 + * 修复在自定义页面模式下，`h{1-4}` 标签被渲染为带有徽章的 `Heading` 组件的问题 + * 为[面包屑](/zh/organize/navigation#breadcrumbs)添加 CSS 选择器，便于定制化选择 + * 通过分析尺寸以在 56px height 下保持比例，修复被拉伸的 open-graph 图像 + * 在上下文菜单中将 `VSCode` 更正为 `VS Code` + * 修复自定义组件内的标题与语义化标题一同出现在目录中的问题 - ## Bug 修复与稳定性 + ## 错误修复与可靠性 - * 通过清理导致生成问题的字符，修复了某些页面标题的 PDF 渲染问题。 - * 解决了遇到空的 OpenAPI JSON 文件时出现的命令行界面（CLI）错误 `Cannot convert undefined or null to object`。 - * 修复了自定义 `docs.json` open-graph 元标签被生成标签覆盖的问题。 - * 修复了在访问锚点链接时 RSS 订阅按钮点击失效的问题，现改为使用 origin + pathname 作为 RSS 链接。 - * 通过移除 sourcemaps 提升了命令行界面（CLI）下载速度。 + * 通过清理导致生成问题的字符，修复某些页面标题的 PDF 渲染问题 + * 解决在遇到空的 OpenAPI JSON 文件时出现的 CLI 错误 `Cannot convert undefined or null to object` + * 修复自定义 `docs.json` open-graph 元标签被生成标签覆盖的问题 + * 通过对 RSS 链接使用 origin + pathname，修复在锚点链接页面上 RSS 订阅按钮点击无效的问题 + * 通过移除 sourcemaps 提升 CLI 下载速度 ## 技术改进 - * 在 CI 流水线中加入可视化测试，以更早发现回归。 - * 增强了错误处理与调试能力。 - * 为新功能与边界情况提供更全面的测试覆盖。 + * 在 CI 流水线中添加可视化测试，更早发现回归 + * 增强错误处理与调试能力 + * 为新功能和边界场景提供更完整的测试覆盖 - + ## 认证改进 - * 组级公开访问：通过 `docs.json` 将整个页面组设为公开，无需在每个页面上设置 `public: true`（[了解更多](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level)） - * 在 OAuth 配置中支持 [`logoutURL`](https://mintlify.com/docs/authentication-personalization/authentication-setup#implementation-3)，用于删除上游 cookie 并完成登出 - * 发生 OAuth 错误时，用户会被重定向到你指定的 `logoutURL`，以重新启动认证流程 - * 修复了在 OAuth/JWT 流程中回调前短暂出现 500 错误的问题 - * 在 OAuth/JWT 认证配置中自动去除 URL 中的 `https://`，以防误配置 + * 组级公开访问：通过 `docs.json` 将整个页面组设为公开，这样无需在每个页面上设置 `public: true`（[了解更多](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level)） + * 在 OAuth 配置中支持 [`logoutURL`](https://mintlify.com/docs/authentication-personalization/authentication-setup#implementation-3)，用于删除上游 Cookie 并完成登出 + * 发生 OAuth 错误时，用户会被重定向到你指定的 `logoutURL` 以重启认证流程 + * 修复了在回调前 OAuth/JWT 流程中短暂闪现 500 错误的问题 + * 在 OAuth/JWT 认证配置中自动剔除 URL 的 `https://` 以防止误配置 ## API 操作台增强 - * 新增 [Search API 端点](https://mintlify.com/docs/api-reference/assistant/search)，可在你的文档之上构建代理和 MCP 服务器 + * 新增 [Search API 端点](https://mintlify.com/docs/api-reference/assistant/search)，可在你的文档之上构建智能体和 MCP 服务器 * 现在会在指定路径提供 `openapi` 和 `asyncapi` 文件（例如 `https://mydocsurl.extension/{openapi-or-file-name}.json`） - * 现在可以在 openapi 文件中使用 [`x-mint` 字段](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) 来覆盖生成的字段、自定义前言内容，或更改代码示例中的端点 URL - * 在 OpenAPI 配置中，[`x-mcp` 现为 `x-mint.mcp`](https://mintlify.com/docs/api-playground/openapi-setup#mcp)，用于控制哪些路由以 MCP 工具的形式暴露 + * 现在可以在 openapi 文件中使用 [`x-mint` 字段](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) 覆盖生成字段、自定义前言内容，或更改代码示例中的端点 URL + * 在 OpenAPI 配置中，[`x-mcp` 现为 `x-mint.mcp`](https://mintlify.com/docs/api-playground/openapi-setup#mcp)，用于控制哪些路由以 MCP 工具形式暴露 ## AI 助手更新 - * 修复了旧消息的操作菜单（包含复制、点赞等选项）在新消息流式加载时消失的问题 - * 修复了上周[托管 MCP 服务器发布](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server)后嵌套的 `/mcp/...` 页面可访问性问题 + * 修复了当新消息流式传入时，旧消息的操作菜单（包含复制、点赞等选项）会消失的问题 + * 修复了上周 [托管 MCP 服务器发布](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server) 后，嵌套的 `/mcp/...` 页面可访问性问题 ## 性能与可靠性 - * 你文档仓库中的所有图片和视频资源现在都会在你的 domain 上按正确路径提供。例如，如果仓库中有 `/assets/marketing/my-logo.png`，它将可通过 `https://mydocsurl.extension/assets/marketing/my-logo.png` 访问。 - * Mintlify 控制台登录页的邮箱输入框现在会自动聚焦，便于立即输入（易用性优化） - * 在 Redis 中同时优化了自定义域和子域，以提升导航加载性能（约 50ms 延迟降低） - * 为 PDF 导出添加了重试逻辑以提升稳定性 - * 修复了在接受或关闭后 Cookie 同意弹窗再次出现的问题——现在会尊重首次选择 - * 通过在 `navigator.write` 中指定 MIME `type`，修复了在 Safari 上将页面复制到剪贴板的问题 + * 文档仓库中的所有图片和视频资源现在都会在你的 domain 上以正确路径提供。例如，如果仓库中有 `/assets/marketing/my-logo.png`，它将可通过 `https://mydocsurl.extension/assets/marketing/my-logo.png` 访问。 + * Mintlify 控制台登录页的邮箱输入框现在会自动聚焦，便于立即输入（使用体验改进） + * 在 Redis 中同时处理自定义域与子域，以提升导航加载性能（约 50ms 延迟降低） + * 为 PDF 导出增加了重试逻辑以提升可靠性 + * 修复了在接受或关闭后 Cookie 同意弹窗仍会再次出现的问题——现在首次选择将被保留 + * 通过在 `navigator.write` 中指定 MIME `type`，修复了在 Safari 上复制页面到剪贴板的问题 ## 技术改进 - * 修复了在 Windows 和 pnpm 上的 CLI 问题，并增加了 CI 测试以防止回归 - * 改进了错误日志输出——为工程团队调试带来更佳体验 + * 修复了 Windows 与 pnpm 上的 CLI 缺陷，并添加 CI 测试以防回归 + * 改进错误日志输出——为工程团队调试带来更佳体验 * 当缺少 `contentDirectory` 文件时，修复了 broken-link CI action 的一些小问题 - * 修复了上周认证保护预览修复引入的回归问题，导致导航 UI 中未正确设置活动标签页 - * 修复了主题的 light 背景色未应用于活动标签页 icon 的问题 - * 修复了在控制台中更改认证类型后先更新又回退到之前已保存类型的问题——现在新选择在保存后会保持 - * 面向使用自定义 UI 库的企业客户的内部 DX 改进——我们现在更容易在更短周期内纳入你的组件并响应需求 + * 修复了上周认证保护预览修复引发的回归问题，导致导航 UI 中活动标签页未正确设置 + * 修复了主题 light 背景色未应用于活动标签页 icon 的问题 + * 修复了在控制台中更改认证类型会先更新后又回退到先前保存类型的问题——现在新选择在保存后会持久生效 + * 面向拥有自定义 UI 库的企业客户的内部 DX 改进——我们更易在更短周期内纳入你的组件并响应需求 ## 认证改进 - * 改进本地环境下的认证体验，加快该产品领域的认证功能开发与缺陷修复 - * 现已支持对受认证保护的网站进行预览部署 - * 修复重定向行为，确保用户在认证后正确返回原始页面 - * 修复完整认证状态下的退出按钮显示问题（此前仅在部分认证时有效） + * 优化本地环境中的认证流程，加速相关功能开发与缺陷修复 + * 现已支持对受认证保护站点的预览部署 + * 修复重定向行为，认证后可正确返回到原始页面 + * 修复完整认证的登出按钮显示问题（之前仅在部分认证下可用） ## API 操作台增强 * 修复 API 操作台中的 `multipart/form-data` 文件上传功能 - * 修复锚点链接行为，使点击后仅更新 URL，而不会滚动至页面顶部 + * 修复锚点链接行为，点击后仅更新 URL 而不会滚动到页面顶部 * 修复嵌套选项卡中的锚点链接问题 ## AI 助手更新 - * 新增 Assistant API，便于集成到你自己的产品中，兼容 AI SDK - * 聊天回复新增复制按钮 - * 修复助手中重试消息的问题 - * 改进默认助手提示词，使其默认更简洁 + * 新增 Assistant API，便于将其集成到你自己的产品中，兼容 AI SDK + * 为聊天回复新增复制按钮 + * 修复在助手中重试消息的问题 + * 改进默认助手提示词，使其默认更为简洁 ## 性能与可靠性 - * 通过在输入时中止防抖请求，让搜索更灵敏、更准确 - * 为新的 CDN 预置资源——预计图像资源与页面加载时间将很快得到改善 - * 修复渲染复杂 Mermaid 图（如 GANTT 图）的问题 + * 通过在输入时中止防抖请求，让搜索更为灵敏且准确 + * 为新的 CDN 预置资源——预计图像资源与页面加载时间将很快改善 + * 修复渲染复杂 Mermaid 图表（如甘特图）的错误 * 修复 Windows 上的 CLI 问题以提升稳定性，并新增测试以防止回归 ## 技术改进 - * 在 NextJS 应用中加入 OpenTelemetry 追踪，以改善客户的首字节时间（TTFB） - * 从 Octokit 迁移到 GitHub API Client，以降低网页版编辑器体验中的延迟 + * 在 Next.js 应用中加入 OpenTelemetry 追踪，以改善客户的首字节时间 + * 从 Octokit 迁移到 GitHub API Client，提升网页编辑器的时延表现 * 修复 OpenGraph 的重复 meta 标签 - * 将 MongoDB 从 6 升级至 7，以获得更好的性能和新特性 + * 将 MongoDB 从 6 升级到 7，带来更佳性能与新特性 ## Slack 应用 - * 零阻力访问：机器人会回复私信、@提及，以及你 `#ask-ai` 频道中的任何问题 - * 一键安装：可在数秒内直接从你的 Mintlify 控制台安装 - * 上下文作答：搜索你的全部文档以提供相关且准确的回复 - * 减少支持打扰：将日常问题转化为即时的自助答案 + * 零摩擦访问：机器人可响应私信、@提及，以及你在 `#ask-ai` 频道中的任何提问 + * 一键设置：可在数秒内直接从你的 Mintlify 控制台安装 + * 具备上下文的回答：搜索你的全部文档以提供相关、准确的回复 + * 减少支持打扰：将日常问题转化为即时、自助式答案 - 在我们的 [Slack 应用指南](/zh/ai/slack-app) 中了解更多。 + 在我们的[Slack 应用指南](/zh/ai/slack-app)中了解更多。 ## 托管 MCP 服务器 - 通过 Mintlify 直接部署托管的 Model Context Protocol (MCP) 服务器，以集成 Claude、Cursor 等 AI 工具。详见我们的 [MCP 指南](/zh/ai/model-context-protocol)。 + 通过 Mintlify 直接部署托管的 Model Context Protocol（MCP）服务器，以集成到 Claude、Cursor 等 AI 工具中。在我们的 [MCP 指南](/zh/ai/model-context-protocol)中了解更多。 - 通过上下文菜单，帮助用户在文档任一页面快速将你的 MCP 服务器连接到 Cursor 或 VS Code。参见 [Contextual menu](/zh/ai/contextual-menu) 了解更多信息。 + 通过上下文菜单，帮助用户从文档中的任意页面快速将你的 MCP 服务器连接到 Cursor 或 VS Code。参见[上下文菜单](/zh/ai/contextual-menu)了解更多信息。 ## 代码块改进 * 改进语法高亮 - * 新增更多自定义选项，包括专注模式、可展开的代码块、深色与浅色模式自适应、语言下拉菜单、行号和图标 + * 新增更多自定义选项，包括专注模式、可展开的代码块、深浅色模式自适应、语言下拉菜单、行号与图标 ## AI 助手更新 - * 通过具备工具调用的代理式 RAG 提升准确性 - * 提供可导航的引用页面链接，便于用户直接访问答案来源 + * 通过具备工具调用的 agentic RAG 提升准确性 + * 提供指向引用页面的可导航链接，便于用户直接访问答案来源 * 为助手生成的代码示例提供复制快捷键 - * 在文档的代码块上提供“Ask AI”快捷方式，从助手生成解释 + * 在文档的代码块上提供“Ask AI”快捷方式，由助手生成解释 - 在 [assistant docs](/zh/ai/assistant) 中了解更多。 + 在[助手文档](/zh/ai/assistant)中了解更多。 ## 可订阅的更新日志 * 从更新日志页面自动生成 RSS 源 - * 将支持 RSS 的更新集成到 Slack、电子邮件及其他工具 + * 将支持 RSS 的更新集成到 Slack、电子邮件和其他工具 - 在我们的全新 [更新日志指南](/zh/create/changelogs) 中了解更多 + 在我们的新[更新日志指南](/zh/create/changelogs)中了解更多。 ## API 操作台稳定性更新 * 通过搜索查找端点 - * 使用标签标识已废弃的端点 - * 在导航中隐藏自动生成的 API 页面 + * 使用标签标注已废弃的端点 + * 将自动生成的 API 页面从导航中隐藏 * 上传 multipart 或表单数据文件 - 了解更多请见 [API 操作台文档](/zh/api-playground/)。 + 在 [API 操作台文档](/zh/api-playground/)中了解更多。 ## `mint update` - 现在可以使用 `mint update` 来更新你的命令行界面（CLI）。 + 现在可以使用 `mint update` 更新你的命令行界面（CLI）。 diff --git a/zh/optimize/seo.mdx b/zh/optimize/seo.mdx index d43af128c..6c0136e46 100644 --- a/zh/optimize/seo.mdx +++ b/zh/optimize/seo.mdx @@ -47,9 +47,13 @@ title: "您的示例页面标题" ## 常用 meta 标签参考 -下面是可添加到你的 `docs.json` 中的 meta 标签的完整列表。这些 meta 标签有助于提升站点的 SEO（搜索引擎优化）、社交分享效果和浏览器兼容性。 +下面是可添加到你的 `docs.json` 中的 meta 标签完整列表。这些 meta 标签有助于提升站点的 SEO（搜索引擎优化）、社交分享表现和浏览器兼容性。 -你可以使用 [metatags.io](https://metatags.io/) 预览这些 meta 标签在不同平台上的呈现方式。 + + 在生成社交媒体预览时，`og:image` 会作为背景图使用，Mintlify 会在其上自动叠加你的 logo、页面 title 和 description。 + + +你可以使用 [metatags.io](https://metatags.io/) 预览这些 meta 标签在不同平台上的呈现效果。 ```json expandable "seo": {