diff --git a/es/ai/markdown-export.mdx b/es/ai/markdown-export.mdx index 2292267a2..3540bf37b 100644 --- a/es/ai/markdown-export.mdx +++ b/es/ai/markdown-export.mdx @@ -141,4 +141,4 @@ La exportación de Markdown respeta las mismas reglas de autenticación que la v ## Atajo de teclado -Pulsa Command + C (Ctrl + C en Windows) para copiar una página en Markdown al portapapeles. +Pulsa Cmd + C (Ctrl + C en Windows) para copiar una página en Markdown al portapapeles. diff --git a/es/ai/mintlify-mcp.mdx b/es/ai/mintlify-mcp.mdx index 5a1566fad..694a036df 100644 --- a/es/ai/mintlify-mcp.mdx +++ b/es/ai/mintlify-mcp.mdx @@ -77,7 +77,7 @@ Debes tener un inicio de sesión OAuth interactivo en tu cuenta de Mintlify para Instala el conector oficial de Mintlify desde el [directorio de aplicaciones de ChatGPT](https://chatgpt.com/apps/mintlify-mcp/asdk_app_6a4d5a687f0881918be3cb8b4b93773d) y completa el inicio de sesión OAuth cuando se te solicite. Una vez instalado, ChatGPT puede llamar a las herramientas del Mintlify Admin MCP durante un chat. - 1. Abre la paleta de comandos con Command \+ Shift \+ P (Ctrl \+ Shift \+ P en Windows). + 1. Abre la paleta de comandos con Cmd \+ Shift \+ P (Ctrl \+ Shift \+ P en Windows). 2. Busca **Open MCP settings** y haz clic en **Add custom MCP**. 3. En `mcp.json`, agrega el Admin MCP: diff --git a/es/ai/model-context-protocol.mdx b/es/ai/model-context-protocol.mdx index 9a0df8681..3d4d518c9 100644 --- a/es/ai/model-context-protocol.mdx +++ b/es/ai/model-context-protocol.mdx @@ -475,7 +475,7 @@ Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu s Crea una guía para tus usuarios que incluya la URL de tu servidor MCP y los pasos para conectarlo a Cursor. - 1. Usa Command + Shift + P (Ctrl + Shift + P en Windows) para abrir la paleta de comandos. + 1. Usa Cmd + Shift + P (Ctrl + Shift + P en Windows) para abrir la paleta de comandos. 2. Busca `Open MCP settings`. 3. Selecciona **Add custom MCP**. Esto abrirá el archivo `mcp.json`. 4. En `mcp.json`, configura tu servidor: @@ -602,7 +602,7 @@ Conéctate al servidor MCP de Mintlify para buscar en este sitio de documentaci - 1. Usa Command + Shift + P (Ctrl + Shift + P en Windows) para abrir la paleta de comandos. + 1. Usa Cmd + Shift + P (Ctrl + Shift + P en Windows) para abrir la paleta de comandos. 2. Busca `Open MCP settings`. 3. Selecciona **Add custom MCP**. Esto abrirá el archivo `mcp.json`. @@ -622,7 +622,7 @@ Conéctate al servidor MCP de Mintlify para buscar en este sitio de documentaci - En el chat de Cursor, pregunta "What tools do you have available?" Cursor debería mostrar el servidor MCP de Mintlify como una herramienta disponible. + En el chat de Cursor, pregunta "What tools do you have available?" Cursor debería mostrar el servidor MCP de Mintlify como una herramienta disponible. diff --git a/es/api-playground/adding-sdk-examples.mdx b/es/api-playground/adding-sdk-examples.mdx index e9d5fade9..d87c6b150 100644 --- a/es/api-playground/adding-sdk-examples.mdx +++ b/es/api-playground/adding-sdk-examples.mdx @@ -6,7 +6,7 @@ keywords: ["x-codeSamples", "ejemplos de SDK", "Speakeasy", "SDK autogenerados"] Si tus usuarios interactúan con tu API mediante un SDK en lugar de solicitudes de red directas, agrega ejemplos de código de SDK con la extensión `x-codeSamples`. Mintlify muestra estos ejemplos en tus páginas de OpenAPI. -Puedes escribir estos ejemplos tú mismo o, si generas tus SDK con Speakeasy, hacer que se agreguen a tu especificación automáticamente. +Puedes escribir estos ejemplos tú mismo. Si generas tus SDK con Speakeasy, Speakeasy puede agregar los ejemplos a tu especificación automáticamente.
## Agregar ejemplos manualmente @@ -63,14 +63,14 @@ Si generas tus SDK con [Speakeasy](https://www.speakeasy.com), puedes incorporar -Ve a tu [Panel de Speakeasy](https://app.speakeasy.com) y abre la pestaña **API Registry**. Abre la entrada `*-with-code-samples` de la API. +Ve a tu [Panel de Speakeasy](https://app.speakeasy.com) y abre la pestaña **API Registry**. Abre la entrada `*-with-code-samples` de tu API. ![Captura de pantalla de la página API Registry de Speakeasy. Un recuadro rojo y el número 1 destacan la pestaña API Registry, y un recuadro rojo y el número 2 destacan la entrada de la API.](/images/speakeasy/openapi-registry-and-combined-spec.png) - Si la entrada no está etiquetada como **Combined Spec**, asegúrate de que la API tenga configurada una [URL de ejemplos de código automáticos](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls). + Si la entrada no está etiquetada como **Combined Spec**, asegúrate de que tu API tenga configurada una [URL de ejemplos de código automáticos](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls). Desde la página de la entrada del registro, copia la URL pública proporcionada. diff --git a/es/assistant/configure.mdx b/es/assistant/configure.mdx index e54236e4e..f64562f96 100644 --- a/es/assistant/configure.mdx +++ b/es/assistant/configure.mdx @@ -95,7 +95,7 @@ Puedes agregar hasta tres preguntas iniciales. Haz clic en **Preguntar al asiste ## Protección contra bots
-En la sección Protección contra bots, habilita captcha invisible para proteger tu assistant de abusos automatizados. La protección contra bots respeta la privacidad y es invisible para casi todos los visitantes. +En la sección **Bot Protection**, habilita captcha invisible para proteger tu assistant de abusos automatizados. La protección contra bots respeta la privacidad y es invisible para casi todos los visitantes. Para habilitar la protección contra bots: diff --git a/es/assistant/use.mdx b/es/assistant/use.mdx index 23606f19f..2eccb531d 100644 --- a/es/assistant/use.mdx +++ b/es/assistant/use.mdx @@ -71,7 +71,7 @@ El assistant aparece en dos ubicaciones: como un botón junto a la barra de bús ## Atajo de teclado -Abre el panel de chat del assistant con el atajo de teclado Command + I en macOS y Ctrl + I en Windows. +Abre el panel de chat del assistant con el atajo de teclado Cmd + I en macOS y Ctrl + I en Windows.
## Parámetros de URL diff --git a/es/changelog.mdx b/es/changelog.mdx index 637b3a80a..881dd0874 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -5,6 +5,78 @@ rss: true noindex: true --- + + +
+ ## Preferencias de notificaciones +
+ + - **Preferencias de notificaciones:** Elige qué correos recibes para cada evento, incluidas las respuestas y menciones en comentarios, las resoluciones de hilos, las sugerencias enviadas, aceptadas o rechazadas, las ejecuciones de automatizaciones y el feedback de producto. Configura tus preferencias en la página de [Notificaciones](https://app.mintlify.com/settings/organization/notifications) de tu dashboard. + - **Correos de fallos de automatizaciones:** Activa las notificaciones de ejecuciones de automatizaciones para recibir un correo cuando falle una ejecución. Mintlify retiene los siguientes correos de fallo hasta que una ejecución vuelva a completarse con éxito. + - **Notificaciones de uso compartido:** Mintlify te notifica cuando alguien comparte una página contigo. + +
+ ## Editor y colaboración +
+ + - **Modo fuente colaborativo:** El modo fuente ahora admite colaboración en tiempo real. Ve los cursores de tus compañeros mientras trabajan en la misma rama que tú. Las ediciones de frontmatter se sincronizan en vivo entre el modo visual y el modo fuente. Consulta [Edición en tiempo real](/es/editor/collaborate#real-time-editing). + - **Reacciones a comentarios:** Reacciona a un comentario con un emoji para darlo por visto sin responder. Pasa el cursor sobre una reacción para ver quién reaccionó, y reaccionar al comentario de otra persona notifica a su autor. Consulta [Comentarios](/es/editor/collaborate#comments). + - **Publicación selectiva:** Selecciona cambios individuales en el menú de publicación para publicar parte de tu trabajo pendiente en lugar de todo a la vez. + - **Medios en páginas privadas:** Sube imágenes y videos a páginas privadas. Los medios privados solo se sirven a las personas que pueden abrir la página y se eliminan cuando la página se borra. + - **Pulido del editor:** Los resultados de búsqueda muestran los títulos de las páginas y revelan el archivo en la barra lateral, la barra lateral lista solo páginas Markdown de forma predeterminada, el diálogo de compartir busca destinatarios por dirección de correo, el menú de sugerencias de emojis tiene mejor relevancia de búsqueda y el panel del agente permanece disponible en la configuración del sitio. + +
+ ## Automatizaciones +
+ + - **Alcance de las ejecuciones manuales:** Cuando activas una automatización manualmente, elige si revisa los cambios desde una fecha, todo el sitio o un pull request específico. Consulta [Ejecutar una automatización manualmente](/es/automations/manage#run-an-automation-manually). + +
+ ## Analíticas +
+ + - **Filtro de página:** Filtra tus analíticas a una página específica con el nuevo desplegable de páginas del dashboard. + +
+ ## Playground de API +
+ + - **Alternadores de campos opcionales:** En el modal del playground, los campos requeridos se ordenan primero y los campos opcionales se contraen detrás de un control **Expand N optional fields**, con un alternador global en el encabezado. Los campos contraídos siguen siendo localizables. Buscar en la página el nombre de un campo oculto expande la sección que lo contiene, y los valores que ingresaste persisten al contraer y expandir. + - **Contraer campos por defecto:** Establece `expand: false` bajo `x-mint: playground` en una operación para contraer por defecto los campos de objetos anidados. Consulta [Contraer campos del playground](/es/api-playground/openapi-setup#collapse-playground-fields). + +
+ ## Redacción +
+ + - **`mint test`:** Genera pruebas para los bloques de código de tu documentación desde la CLI. Las ejecuciones se guardan para que puedas revisar informes anteriores. Consulta [`mint test`](/es/cli/commands#mint-test). + - **Mejoras de ``:** Los encabezados dentro de bloques `` se integran en la tabla de contenidos de la página, los anclajes `## Title {#id}` funcionan con cualquier sangría y los bloques de código dentro de `` se comportan como los bloques de código en la raíz de la página. Consulta [MDX](/es/components/mdx). + - **Markdown en títulos de componentes:** Los títulos de componentes, como los títulos de accordions, admiten formato Markdown en línea como código y negritas. + - **Anchos de columnas de tablas:** Las tablas HTML respetan los anchos de `` que definas. + +
+ ## Referidos +
+ + - **Referidos para Enterprise:** Las organizaciones Enterprise ahora pueden participar en el [programa de referidos](https://app.mintlify.com/settings/organization/referrals). + +
+ ## Correcciones de errores +
+ + - **Exportaciones estáticas:** Las compilaciones estáticas incluyen tus archivos de logo, de modo que los sitios exportados ya no hacen referencia a recursos faltantes. + - **Subgrupos de GitLab:** Los repositorios en subgrupos anidados de GitLab se sincronizan correctamente. + - **Repositorios grandes:** Los repositorios tan grandes que GitHub trunca su listado de archivos ahora sincronizan todos los archivos. + - **Citas del assistant:** Las citas que omitían un segmento inicial de la ruta ahora abren la página correcta. + - **Vistas previas autenticadas:** Los preview deployments de documentación detrás de autenticación sirven tus archivos modificados. + - **Traducciones:** La automatización de traducción escribe enlaces internos con prefijo de idioma, de modo que las páginas recién traducidas enlazan dentro de su propio idioma. + - **Limpieza de OpenAPI:** Eliminar una especificación de OpenAPI elimina de tu sitio los recursos que generó. + - **Fuentes personalizadas:** El texto en negrita se mantiene en negrita cuando configuras un peso de fuente personalizado para el cuerpo. + - **Feedback de código:** El popover de feedback de fragmentos de código se muestra por encima del panel de la tabla de contenidos. + - **Banners descartados:** Los banners descartados ya no parpadean al cargar la página. + - **Correcciones del editor:** Los enlaces de estilo referencia y los componentes `Link` se renderizan correctamente, las tablas HTML con `colspan` o clases hacen round-trip sin cambios, editar una página ya no reformatea el contenido que no tocaste y cambiar de rama ya no causa bucles de redirección. + + +
@@ -1542,7 +1614,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a ## Otros - * Compatibilidad con "Open in Grok" en el [menú contextual](/es/ai/contextual-menu) + * Compatibilidad con "Open in Grok" en el [menú contextual](/es/ai/contextual-menu) * Compatibilidad con la subida de archivos ZIP en el [onboarding](deploy/github#clone-to-your-own-repository) ## Correcciones de errores @@ -1555,7 +1627,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a * El Asistente de IA ya no aparece al imprimir páginas. * Se corrigió que el cursor fuera invisible en modo oscuro. * Se corrigió un error que podía eliminar atributos de estilo en MDX. - * Se corrigió un problema por el que las fechas de "última modificación" de la página se actualizaban incorrectamente durante cambios globales de configuración. + * Se corrigió un problema por el que las fechas de "última modificación" de la página se actualizaban incorrectamente durante cambios globales de configuración. * Se corrigió un problema de autenticación que impedía que las páginas índice se renderizaran correctamente. * El estado de GitHub ahora se muestra correctamente durante el onboarding si GitHub está caído. @@ -1699,7 +1771,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a ## Mejoras de localización * Se añadió compatibilidad con los idiomas polaco, uzbeko y hebreo. - * Los elementos de la interfaz de usuario en el área de pruebas de la API, incluidos los botones "Try it" y "Send", ahora están localizados en todos los idiomas compatibles. + * Los elementos de la interfaz de usuario en el área de pruebas de la API, incluidos los botones "Try it" y "Send", ahora están localizados en todos los idiomas compatibles. @@ -1752,7 +1824,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a ## Fechas de última modificación - Ahora puedes mostrar marcas de tiempo de "última modificación" en todas las páginas de tu documentación. Activa esta función estableciendo la bandera [`timestamp`](/es/organize/settings-seo#metadata) en tu configuración de `docs.json`. + Ahora puedes mostrar marcas de tiempo de "última modificación" en todas las páginas de tu documentación. Activa esta función estableciendo la bandera [`timestamp`](/es/organize/settings-seo#metadata) en tu configuración de `docs.json`. Cuando está habilitada, cada página mostrará automáticamente cuándo se actualizó por última vez, lo que ayuda a los lectores a entender qué tan actual es el contenido. @@ -1808,7 +1880,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a ## Mejoras en el área de pruebas de la API * Se corrigió un problema por el que la sección de respuesta desaparecía al cambiar entre endpoints con diferentes códigos de respuesta. El área de pruebas ahora se restablece correctamente al primer código de respuesta disponible al navegar a un nuevo endpoint. - * Se corrigió la visualización duplicada del encabezado "Authorization" en esquemas de autenticación HTTP Basic. La sección de autenticación ahora muestra una interfaz más limpia con etiquetas y descripciones de campo correctas. + * Se corrigió la visualización duplicada del encabezado "Authorization" en esquemas de autenticación HTTP Basic. La sección de autenticación ahora muestra una interfaz más limpia con etiquetas y descripciones de campo correctas. * Se mejoró el manejo de esquemas `oneOf` en objetos y arrays anidados. Los esquemas de API complejos con múltiples opciones de tipo ahora se renderizan correctamente como menús desplegables en lugar de Tabs en los contextos apropiados. * Se corrigieron parámetros de ruta faltantes que estaban definidos a nivel de endpoint en especificaciones OpenAPI. Los parámetros especificados por encima de las operaciones individuales ahora se incluyen correctamente tanto en la página principal como en el área de pruebas. * Se mejoró la generación de ejemplos de respuesta para incluir todas las propiedades obligatorias, incluso cuando los ejemplos solo especifican algunos campos. Esto garantiza que los ejemplos de respuesta sean completos y precisos. @@ -1976,7 +2048,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a ## Mejoras de navigation y UI * Se añadió un canal estable para la barra de desplazamiento en los componentes de navigation para un diseño coherente - * Se hizo clicable la sección "On this page" para desplazarse rápidamente a la parte superior de una página + * Se hizo clicable la sección "On this page" para desplazarse rápidamente a la parte superior de una página * Se corrigió la posición de la barra del assistant en todos los temas * Se mejoró la barra del assistant para evitar que se superponga al contenido * Se corrigió el ancho máximo (max-width) de páginas anchas en el tema Almond @@ -2070,7 +2142,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a ## Mejoras de accesibilidad * Se agregaron atributos ARIA completos en los componentes para un mejor soporte de lectores de pantalla - * Nuevo botón "saltar al contenido principal" para la navegación con teclado + * 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 * Mejora de los tooltips, las listas anidadas y la accesibilidad de los grupos de código * Estados de enfoque e interacciones con teclado mejorados en toda la interfaz @@ -2405,7 +2477,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a * Mayor precisión mediante RAG con enfoque agentic y 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 * 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 del 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/assistant/index). @@ -2498,7 +2570,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a * Corregida la inconsistencia de estilo de icon para anclas sin contenedor * Ajustes de estilo mejorados para el borde del dashboard para la respuesta en móvil-tablet-escritorio * Mostrar ejemplos de código incluso en modo simple para el área de pruebas de la API - * Compatibilidad con el atajo "command + k" para buscar en el editor web + * Compatibilidad con el atajo "command + k" para buscar en el editor web * Los bloques de código dentro de los callouts se expanden para llenar el width del área del callout @@ -2541,7 +2613,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a ![gráfico con el texto "Themes v2"](/images/changelog/themes.png) - Nuevos [temas prediseñados](customize/themes) para modificar el look & feel de tu documentación. Configúralos a través de tu [archivo docs.json](organize/settings). + Nuevos [temas prediseñados](customize/themes) para modificar el look & feel de tu documentación. Configúralos a través de tu [archivo docs.json](organize/settings). Ahora disponible: diff --git a/es/cli/commands.mdx b/es/cli/commands.mdx index ded50fa83..73b47350d 100644 --- a/es/cli/commands.mdx +++ b/es/cli/commands.mdx @@ -774,7 +774,7 @@ Ejecuta el comando desde la raíz de tu proyecto de documentación. Recorre cada `mint format` reescribe los archivos in situ. Confirma o guarda tus cambios antes de ejecutarlo para que puedas revisar el diff. -Cuando termina, el comando muestra cuántos archivos MDX se reformatearon y cuántos no se pudieron analizar. Si algún archivo falla, el comando termina con el código `1` e imprime la ruta del archivo y el error, de modo que puedas ejecutarlo en CI para exigir un formato coherente. +Cuando termina, el comando muestra cuántos archivos MDX se reformatearon y cuántos no se pudieron analizar. Si algún archivo falla, el comando termina con el código `1` e imprime la ruta del archivo y el error, de modo que puedas ejecutarlo en CI para exigir un formato coherente. Consulta [Instalar en CI](/es/cli/install#install-in-ci) para ver un pipeline de ejemplo. --- diff --git a/es/cli/install.mdx b/es/cli/install.mdx index 73737d430..32c74602f 100644 --- a/es/cli/install.mdx +++ b/es/cli/install.mdx @@ -24,6 +24,10 @@ keywords: ["CLI", "npm", "instalar", "Node.js", "pnpm", "mint"] ``` + + La CLI se publica en npm como el paquete [`mint`](https://www.npmjs.com/package/mint). No instales el paquete heredado `mintlify` en scripts de instalación ni en pipelines de CI. Si tienes ambos paquetes instalados, consulta [Paquete mintlify versus mint](#troubleshooting). + + Si el usuario te pidió configurar Mintlify y no solo instalar la CLI, continúa con la autenticación, la creación del proyecto, la vista previa, la validación y el despliegue. Sigue el [flujo de configuración para agentes en el Inicio rápido](/es/quickstart#set-up-mintlify-for-the-user). No te detengas después de que `mint --version` se ejecute correctamente. @@ -121,6 +125,41 @@ Si `mint update` no está disponible en tu versión, reinstala la CLI con la úl ``` +
+ ## Instalar en CI +
+ +Para ejecutar comprobaciones de la CLI en un pipeline de integración continua, instala el paquete `mint` de forma global y luego ejecuta los comandos que necesites. Por ejemplo, este job de GitHub Actions comprueba el formato con [`mint format`](/es/cli/commands#mint-format) y valida la compilación con [`mint validate`](/es/cli/commands#mint-validate): + +```yaml +name: Docs checks + +on: + pull_request: + paths: + - "**/*.mdx" + - "docs.json" + +jobs: + docs-checks: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - name: Install the Mintlify CLI + run: npm i -g mint + - name: Check formatting + run: | + mint format + if [ -n "$(git status --porcelain)" ]; then + echo "Files are not formatted. Run 'mint format' locally and commit the changes." + exit 1 + fi + - name: Validate the build + run: mint validate +``` + +`mint format` reescribe los archivos en su lugar y termina con el código `1` si algún archivo no se puede analizar, por lo que el job comprueba si hay un diff después de ejecutarlo. `mint validate` termina con un error ante cualquier advertencia o error y no necesita ninguna comprobación adicional. +
## Soporte para editores
diff --git a/es/cli/mdx-extension.mdx b/es/cli/mdx-extension.mdx index 730766f74..ddc4bb650 100644 --- a/es/cli/mdx-extension.mdx +++ b/es/cli/mdx-extension.mdx @@ -1,6 +1,6 @@ --- title: "Extensión Mintlify MDX" -description: "Instala la extensión Mintlify MDX para obtener autocompletado, diagnósticos en línea, documentación al pasar el cursor y una previsualización en el editor mientras escribes MDX localmente." +description: "Instala la extensión Mintlify MDX para obtener autocompletado, diagnósticos en línea, documentación al pasar el cursor y vista previa en el editor." keywords: ["Cursor", "MDX", "autocompletado", "diagnósticos", "IntelliSense", "previsualización", "editor"] --- @@ -71,7 +71,7 @@ Pasa el cursor sobre un componente o una propiedad para ver qué hace y un enlac ## Ir a la definición
-Mantén presionado CMD (macOS) o CTRL (Windows) y haz clic para navegar a la definición de: +Mantén presionado Cmd (macOS) o Ctrl (Windows) y haz clic para navegar a la definición de: - Componentes de snippet. - Rutas de importación. diff --git a/es/components/accordions.mdx b/es/components/accordions.mdx index baafdff5e..902b7a880 100644 --- a/es/components/accordions.mdx +++ b/es/components/accordions.mdx @@ -69,7 +69,7 @@ Agrupa acordeones relacionados usando ``. Esto crea una sección -````mdx Accordion Group Example +````mdx Accordion group example Puedes incluir otros componentes dentro de los Accordion. diff --git a/es/contact-support.mdx b/es/contact-support.mdx index c23563e90..158e8b690 100644 --- a/es/contact-support.mdx +++ b/es/contact-support.mdx @@ -7,7 +7,7 @@ description: "Contacta al soporte de Mintlify para obtener ayuda con tu sitio de ## Consulta nuestra documentación
-Usa el atajo de teclado Command + I (macOS) o Ctrl + I (Windows/Linux) para iniciar un chat con nuestro Asistente de IA entrenado con nuestra documentación. +Usa el atajo de teclado Cmd + I (macOS) o Ctrl + I (Windows/Linux) para iniciar un chat con nuestro Asistente de IA entrenado con nuestra documentación.
## Mira tutoriales en video diff --git a/es/create/reusable-snippets.mdx b/es/create/reusable-snippets.mdx index 031942ee1..f122ef945 100644 --- a/es/create/reusable-snippets.mdx +++ b/es/create/reusable-snippets.mdx @@ -4,7 +4,7 @@ description: "Crea fragmentos de contenido reutilizables con variables para mant keywords: ["content snippets", "reusable content", "variables"] --- -Uno de los principios fundamentales del desarrollo de software es DRY (Don't Repeat Yourself), que también se aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, crea un fragmento personalizado para ese contenido. Los fragmentos incluyen contenido que puedes importar en otros archivos para reutilizarlo. Tú controlas dónde aparece el fragmento en una página. Si alguna vez necesitas actualizar el contenido, solo tendrás que editar el fragmento en lugar de cada archivo donde se use. +Uno de los principios fundamentales del desarrollo de software es DRY (Don't Repeat Yourself), que también se aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, crea un fragmento personalizado para ese contenido. Los fragmentos incluyen contenido que puedes importar en otros archivos para reutilizarlo. Tú controlas dónde aparece el fragmento en una página. Si alguna vez necesitas actualizar el contenido, solo tendrás que editar el fragmento en lugar de cada archivo donde se use. Actualmente, los fragmentos no son compatibles con el editor web. Para usar fragmentos, edita tus archivos MDX localmente con la CLI o envía las importaciones de fragmentos directamente a tu repositorio. @@ -36,7 +36,7 @@ Importa fragmentos en las páginas usando una ruta absoluta o relativa. El nombre que usas para renderizar un fragmento importado como una etiqueta JSX debe empezar con una letra mayúscula, como `MySnippet`. MDX trata las etiquetas en minúsculas, como ``, como nombres literales de elementos HTML o elementos personalizados, en lugar de referencias a fragmentos importados. Usa PascalCase para los nombres de fragmentos como convención. - Las importaciones relativas habilitan la navegación en el IDE. Pulsa CMD y haz clic en el nombre de un fragmento en tu editor para ir directamente a su definición. + Las importaciones relativas habilitan la navegación en el IDE. Pulsa Cmd y haz clic en el nombre de un fragmento en tu editor para ir directamente a su definición.
diff --git a/es/credits.mdx b/es/credits.mdx index 80a4fc5cb..166f7c299 100644 --- a/es/credits.mdx +++ b/es/credits.mdx @@ -1,6 +1,6 @@ --- title: "Precios por créditos" -description: "Conoce el precio fijo en créditos de cada acción de IA, cómo funciona el saldo compartido de créditos de tu organización y cómo Mintlify factura complementos, excedentes y acumulados." +description: "Conoce el precio fijo de cada acción de IA, cómo funciona tu saldo compartido de créditos y cómo Mintlify factura complementos, excedentes y acumulados." keywords: ["créditos", "facturación", "precios", "organización", "assistant", "agente", "automatizaciones", "complementos", "excedentes", "acumulados", "uso", "exportar", "CSV", "registro de actividad"] --- diff --git a/es/guides/use-automations.mdx b/es/guides/use-automations.mdx index 18d5fa325..970972001 100644 --- a/es/guides/use-automations.mdx +++ b/es/guides/use-automations.mdx @@ -112,7 +112,7 @@ Decide cuánta revisión deseas antes de que los cambios se publiquen. Cada ejecución de una automatización que actualiza tu documentación cuesta 250 créditos, sin importar cuánto contenido lee el agente o cuántas páginas cambia. Las ejecuciones que no encuentran nada que actualizar no cuestan nada. Para ver cuántos créditos usan tus automatizaciones, consulta el registro de actividad en la página de [Uso](https://app.mintlify.com/settings/organization/usage). -Programar tareas cron para que se ejecuten en momentos específicos te da un control más preciso sobre el uso de créditos. Por ejemplo, ejecuta una automatización una vez al día o una vez a la semana para limitar cuántas actualizaciones puede hacer al mes, y agrupa varios cambios de origen en una sola actualización en lugar de pagar por cada uno por separado. Las automatizaciones activadas por push pueden variar más de un mes a otro porque dependen de la frecuencia con la que cambian el contenido o el código. +Programar tareas cron para que se ejecuten en momentos específicos te da un control más preciso sobre el uso de créditos. Por ejemplo, ejecuta una automatización una vez al día o una vez a la semana para limitar cuántas actualizaciones puede hacer al mes. Una programación también agrupa varios cambios de origen en una sola actualización, de modo que no pagas por cada cambio por separado. Las automatizaciones activadas por push pueden variar más de un mes a otro porque dependen de la frecuencia con la que cambian el contenido o el código.
## Revisar y mejorar los resultados de las automatizaciones diff --git a/es/help-center/configure-oauth-with-auth0.mdx b/es/help-center/configure-oauth-with-auth0.mdx index d2178b5c5..2b9af5e3d 100644 --- a/es/help-center/configure-oauth-with-auth0.mdx +++ b/es/help-center/configure-oauth-with-auth0.mdx @@ -1,6 +1,6 @@ --- title: "Configurar la autenticación OAuth 2.0 con Auth0" -description: "Configura Auth0 como proveedor de identidad OAuth 2.0 para un sitio privado de documentación de Mintlify, incluyendo las URLs de los endpoints, el registro del callback y el control de acceso basado en grupos." +description: "Configura Auth0 como proveedor de identidad OAuth 2.0 para documentación privada de Mintlify: URLs de endpoints, callback y acceso por grupos." keywords: ["Auth0", "OAuth", "OAuth 2.0", "OIDC", "identity provider", "SSO", "private docs", "authentication"] --- @@ -43,7 +43,7 @@ Para restringir páginas a usuarios específicos de Auth0, tienes dos opciones. - **Claims del token (recomendado).** Añade un claim de grupos al ID token o al access token mediante una [Auth0 Action](https://auth0.com/docs/customize/actions) y configura Mintlify para leerlo. Consulta [Usar grupos desde claims del token de OAuth](/es/deploy/authentication-setup#use-groups-from-oauth-token-claims). Si obtienes los grupos del ID token, mantén `openid` en tus scopes. - **Info API URL.** Apunta Mintlify a `https://YOUR_AUTH0_DOMAIN/userinfo` o a tu propio endpoint que devuelva los datos del usuario en el [formato de datos de usuario](/es/deploy/authentication-setup#user-data-format). El endpoint debe aceptar `Authorization: Bearer ` y devolver los grupos en la respuesta. -Luego etiqueta las páginas o grupos de navegación con un valor `groups` que coincida para que solo los miembros de ese grupo puedan verlos. +Luego añade un valor `groups` que coincida al frontmatter de cada página que quieras restringir para que solo los miembros de ese grupo puedan verla. ## Solución de problemas diff --git a/es/help-center/tailwind-classes-not-applying-in-editor-preview.mdx b/es/help-center/tailwind-classes-not-applying-in-editor-preview.mdx index 4304532b4..a35757016 100644 --- a/es/help-center/tailwind-classes-not-applying-in-editor-preview.mdx +++ b/es/help-center/tailwind-classes-not-applying-in-editor-preview.mdx @@ -1,6 +1,6 @@ --- -title: "Las clases de Tailwind no se aplican en la vista previa en vivo del editor" -description: "Diagnostica por qué una página con estilos de clases de Tailwind CSS, como una página de destino en modo personalizado, se ve sin estilo en la vista previa en vivo del editor web pero se muestra correctamente en las implementaciones y con mint dev." +title: "Las clases de Tailwind no se aplican en la vista previa" +description: "La vista previa en vivo del editor omite la compilación que genera el CSS de Tailwind. Comprueba los estilos con mint dev o una implementación de vista previa." keywords: ["tailwind not working", "tailwind classes not applying", "custom page looks broken", "editor preview unstyled", "live preview missing styles", "custom mode no styles"] --- diff --git a/es/search-index/connect.mdx b/es/search-index/connect.mdx index 98caccd55..5660878fe 100644 --- a/es/search-index/connect.mdx +++ b/es/search-index/connect.mdx @@ -83,7 +83,7 @@ Para configurar un agente manualmente, o para verificar lo que cambió la CLI, s - 1. Abre la paleta de comandos con Command + Shift + P (Ctrl + Shift + P en Windows). + 1. Abre la paleta de comandos con Cmd + Shift + P (Ctrl + Shift + P en Windows). 2. Busca **Open MCP settings**. 3. Selecciona **Add custom MCP** para abrir `mcp.json`. diff --git a/fr/ai/markdown-export.mdx b/fr/ai/markdown-export.mdx index 8b678c752..7b1ce0a32 100644 --- a/fr/ai/markdown-export.mdx +++ b/fr/ai/markdown-export.mdx @@ -141,4 +141,4 @@ L'export Markdown respecte les mêmes règles d'authentification que la version ## Raccourci clavier
-Appuyez sur Command + C (Ctrl + C sous Windows) pour copier une page au format Markdown dans le presse-papiers. +Appuyez sur Cmd + C (Ctrl + C sous Windows) pour copier une page au format Markdown dans le presse-papiers. diff --git a/fr/ai/mintlify-mcp.mdx b/fr/ai/mintlify-mcp.mdx index 7e61d282d..ea3765965 100644 --- a/fr/ai/mintlify-mcp.mdx +++ b/fr/ai/mintlify-mcp.mdx @@ -77,7 +77,7 @@ Vous devez disposer d'une connexion OAuth interactive à votre compte Mintlify p Installez le connecteur officiel Mintlify depuis le [répertoire d'applications ChatGPT](https://chatgpt.com/apps/mintlify-mcp/asdk_app_6a4d5a687f0881918be3cb8b4b93773d) et terminez la connexion OAuth lorsque vous y êtes invité. Une fois installé, ChatGPT peut appeler les outils du Mintlify Admin MCP pendant un chat. - 1. Ouvrez la palette de commandes avec Command \+ Shift \+ P (Ctrl \+ Shift \+ P sous Windows). + 1. Ouvrez la palette de commandes avec Cmd \+ Shift \+ P (Ctrl \+ Shift \+ P sous Windows). 2. Recherchez **Open MCP settings** et cliquez sur **Add custom MCP**. 3. Dans `mcp.json`, ajoutez l'Admin MCP : diff --git a/fr/ai/model-context-protocol.mdx b/fr/ai/model-context-protocol.mdx index 22a7875b6..427d93958 100644 --- a/fr/ai/model-context-protocol.mdx +++ b/fr/ai/model-context-protocol.mdx @@ -362,9 +362,9 @@ Si des fichiers correspondent aux modèles définis dans [.mintignore](/fr/organ ### Indexation pour la recherche avec `docs.json`
-Par défaut, Mintlify n'indexe, pour la recherche via votre serveur MCP, que les pages incluses dans la navigation de votre `docs.json`. +Par défaut, Mintlify n'indexe, pour la recherche via votre serveur MCP, que les pages incluses dans la navigation de votre `docs.json`. -Mintlify exclut les [pages masquées](/fr/organize/hidden-pages) (pages qui ne figurent pas dans votre navigation) de l'index de recherche, sauf si vous choisissez d'indexer toutes les pages. Pour inclure les pages masquées dans les résultats de recherche de votre serveur MCP, ajoutez la propriété `seo.indexing` à votre `docs.json`. +Mintlify exclut les [pages masquées](/fr/organize/hidden-pages) (pages qui ne figurent pas dans votre navigation) de l'index de recherche, sauf si vous choisissez d'indexer toutes les pages. Pour inclure les pages masquées dans les résultats de recherche de votre serveur MCP, ajoutez la propriété `seo.indexing` à votre `docs.json`. ```json "seo": { @@ -372,7 +372,7 @@ Mintlify exclut les [pages masquées](/fr/organize/hidden-pages) (pages qui ne f } ``` -Pour exclure une page donnée de l'indexation par les moteurs de recherche, ajoutez `noindex: true` à son frontmatter. +Pour exclure une page donnée de l'indexation par les moteurs de recherche, ajoutez `noindex: true` à son frontmatter. ```mdx --- @@ -386,13 +386,13 @@ noindex: true ## Utiliser votre serveur MCP
-Vos utilisateurs doivent connecter votre serveur MCP à leurs outils d'IA préférés. +Vos utilisateurs doivent connecter votre serveur MCP à leurs outils d'IA préférés. -1. Rendez l'URL de votre serveur MCP publique. -2. Les utilisateurs copient l'URL de votre serveur MCP et l'ajoutent à leurs outils. +1. Rendez l'URL de votre serveur MCP publique. +2. Les utilisateurs copient l'URL de votre serveur MCP et l'ajoutent à leurs outils. 3. Les utilisateurs accèdent à votre contenu depuis leurs outils. -Voici quelques façons d'aider vos utilisateurs à se connecter à votre serveur MCP : +Voici quelques façons d'aider vos utilisateurs à se connecter à votre serveur MCP : @@ -400,8 +400,8 @@ Voici quelques façons d'aider vos utilisateurs à se connecter à votre ser | Option | Identifiant | Description | | :----- | :--------- | :---------- | - | **Copier l'URL du serveur MCP** | `mcp` | Copie l'URL de votre serveur MCP dans le presse‑papiers de l'utilisateur. | - | **Copier la commande d'installation MCP** | `add-mcp` | Copie la commande `npx add-mcp` pour installer le serveur MCP. | + | **Copier l'URL du serveur MCP** | `mcp` | Copie l'URL de votre serveur MCP dans le presse‑papiers de l'utilisateur. | + | **Copier la commande d'installation MCP** | `add-mcp` | Copie la commande `npx add-mcp` pour installer le serveur MCP. | | **Se connecter à Cursor** | `cursor` | Installe votre serveur MCP dans Cursor. | | **Se connecter à VS Code** | `vscode` | Installe votre serveur MCP dans VS Code. | @@ -413,13 +413,13 @@ Voici quelques façons d'aider vos utilisateurs à se connecter à votre ser - Créez un guide pour vos utilisateurs qui inclut l'URL de votre serveur MCP et les étapes pour le connecter à Claude. + Créez un guide pour vos utilisateurs qui inclut l'URL de votre serveur MCP et les étapes pour le connecter à Claude. 1. Accédez à la page [Connectors](https://claude.ai/settings/connectors) dans les paramètres de Claude. 2. Sélectionnez **Add custom connector**. - 3. Ajoutez le nom et l'URL de votre serveur MCP. + 3. Ajoutez le nom et l'URL de votre serveur MCP. 4. Sélectionnez **Add**. - 5. Lors de l'utilisation de Claude, sélectionnez le bouton des pièces jointes (l'icône « plus »). + 5. Lors de l'utilisation de Claude, sélectionnez le bouton des pièces jointes (l'icône « plus »). 6. Sélectionnez votre serveur MCP. @@ -434,7 +434,7 @@ Voici quelques façons d'aider vos utilisateurs à se connecter à votre ser - Créez un guide pour vos utilisateurs qui inclut l'URL de votre serveur MCP et la commande pour le connecter à Claude Code. + Créez un guide pour vos utilisateurs qui inclut l'URL de votre serveur MCP et la commande pour le connecter à Claude Code. ```bash claude mcp add --transport http @@ -473,9 +473,9 @@ Voici quelques façons d'aider vos utilisateurs à se connecter à votre ser - Créez un guide pour vos utilisateurs qui inclut l'URL de votre serveur MCP et les étapes pour le connecter à Cursor. + Créez un guide pour vos utilisateurs qui inclut l'URL de votre serveur MCP et les étapes pour le connecter à Cursor. - 1. Utilisez Command + Shift + P (Ctrl + Shift + P sous Windows) pour ouvrir la palette de commandes. + 1. Utilisez Cmd + Shift + P (Ctrl + Shift + P sous Windows) pour ouvrir la palette de commandes. 2. Recherchez « Open MCP settings ». 3. Sélectionnez **Add custom MCP**. Cela ouvre le fichier `mcp.json`. 4. Dans `mcp.json`, configurez votre serveur : @@ -502,7 +502,7 @@ Voici quelques façons d'aider vos utilisateurs à se connecter à votre ser - Créez un guide pour vos utilisateurs qui inclut l'URL de votre serveur MCP et les étapes pour le connecter à VS Code. + Créez un guide pour vos utilisateurs qui inclut l'URL de votre serveur MCP et les étapes pour le connecter à VS Code. 1. Créez un fichier `.vscode/mcp.json`. 2. Dans `mcp.json`, configurez votre serveur : @@ -528,11 +528,11 @@ Voici quelques façons d'aider vos utilisateurs à se connecter à votre ser ### Exemple : connexion au serveur MCP de Mintlify -Connectez-vous au serveur MCP de Mintlify pour rechercher sur ce site de documentation depuis votre outil d'IA préféré. Vous obtiendrez ainsi des réponses plus précises sur l'utilisation de Mintlify dans votre environnement local, et vous verrez comment aider vos utilisateurs à se connecter à votre serveur MCP. +Connectez-vous au serveur MCP de Mintlify pour rechercher sur ce site de documentation depuis votre outil d'IA préféré. Vous obtiendrez ainsi des réponses plus précises sur l'utilisation de Mintlify dans votre environnement local, et vous verrez comment aider vos utilisateurs à se connecter à votre serveur MCP. - En haut de cette page, ouvrez le menu contextuel et choisissez **Connect to Cursor** ou **Connect to VS Code** pour connecter le serveur MCP de Mintlify à l'IDE de votre choix. + En haut de cette page, ouvrez le menu contextuel et choisissez **Connect to Cursor** ou **Connect to VS Code** pour connecter le serveur MCP de Mintlify à l'IDE de votre choix. @@ -551,7 +551,7 @@ Connectez-vous au serveur MCP de Mintlify pour rechercher sur ce site de documen - 1. Dans Claude, cliquez sur le bouton des pièces jointes (l'icône "plus"). + 1. Dans Claude, cliquez sur le bouton des pièces jointes (l'icône "plus"). 2. Sélectionnez le serveur MCP de Mintlify. 3. Posez à Claude une question sur Mintlify. @@ -602,7 +602,7 @@ Connectez-vous au serveur MCP de Mintlify pour rechercher sur ce site de documen - 1. Utilisez Command + Shift + P (Ctrl + Shift + P sous Windows) pour ouvrir la palette de commandes. + 1. Utilisez Cmd + Shift + P (Ctrl + Shift + P sous Windows) pour ouvrir la palette de commandes. 2. Recherchez « Open MCP settings ». 3. Sélectionnez **Add custom MCP**. Cela ouvre le fichier `mcp.json`. diff --git a/fr/api-playground/adding-sdk-examples.mdx b/fr/api-playground/adding-sdk-examples.mdx index dc3dfb29a..9a230116f 100644 --- a/fr/api-playground/adding-sdk-examples.mdx +++ b/fr/api-playground/adding-sdk-examples.mdx @@ -6,7 +6,7 @@ keywords: ["x-codeSamples", "exemples de SDK", "Speakeasy", "SDK autogénérés" Si vos utilisateurs interagissent avec votre API via un SDK plutôt que par des requêtes réseau directes, ajoutez des exemples de code SDK avec l'extension `x-codeSamples`. Mintlify affiche ces exemples sur vos pages OpenAPI. -Vous pouvez écrire ces exemples vous-même ou, si vous générez vos SDK avec Speakeasy, les faire ajouter automatiquement à votre spécification. +Vous pouvez écrire ces exemples vous-même. Si vous générez vos SDK avec Speakeasy, Speakeasy peut ajouter automatiquement les exemples à votre spécification.
## Ajouter des exemples manuellement @@ -63,14 +63,14 @@ Si vous générez vos SDK avec [Speakeasy](https://www.speakeasy.com), vous pouv -Accédez à votre [tableau de bord Speakeasy](https://app.speakeasy.com) et ouvrez l'onglet **API Registry**. Ouvrez l'entrée `*-with-code-samples` de l'API. +Accédez à votre [tableau de bord Speakeasy](https://app.speakeasy.com) et ouvrez l'onglet **API Registry**. Ouvrez l'entrée `*-with-code-samples` de votre API. ![Capture d'écran de la page API Registry de Speakeasy. Un carré rouge et le chiffre 1 mettent en évidence l'onglet API Registry, et un carré rouge et le chiffre 2 mettent en évidence l'entrée de l'API.](/images/speakeasy/openapi-registry-and-combined-spec.png) - Si l'entrée n'est pas étiquetée **Combined Spec**, vérifiez que l'API dispose d'une [URL d'exemples de code automatiques](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls) configurée. + Si l'entrée n'est pas étiquetée **Combined Spec**, vérifiez que votre API dispose d'une [URL d'exemples de code automatiques](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls) configurée. Depuis la page de l'entrée du registre, copiez l'URL publique fournie. diff --git a/fr/assistant/configure.mdx b/fr/assistant/configure.mdx index 1d70d00a6..edfe14182 100644 --- a/fr/assistant/configure.mdx +++ b/fr/assistant/configure.mdx @@ -95,7 +95,7 @@ Vous pouvez ajouter jusqu'à trois questions de démarrage. Cliquez sur **Demand ## Protection contre les bots
-Dans la section Protection contre les bots, activez le captcha invisible pour protéger votre assistant contre les abus automatisés. La protection contre les bots respecte la vie privée et est invisible pour la quasi-totalité des visiteurs. +Dans la section **Bot Protection**, activez le captcha invisible pour protéger votre assistant contre les abus automatisés. La protection contre les bots respecte la vie privée et est invisible pour la quasi-totalité des visiteurs. Pour activer la protection contre les bots : diff --git a/fr/assistant/use.mdx b/fr/assistant/use.mdx index f59ac9bd9..1ffd97f03 100644 --- a/fr/assistant/use.mdx +++ b/fr/assistant/use.mdx @@ -71,7 +71,7 @@ L'assistant apparaît à deux endroits : sous forme de bouton à côté de la ba ## Raccourci clavier -Ouvrez le panneau de chat de l'assistant avec le raccourci clavier Command + I sur macOS et Ctrl + I sur Windows. +Ouvrez le panneau de chat de l'assistant avec le raccourci clavier Cmd + I sur macOS et Ctrl + I sur Windows.
## Paramètres d'URL diff --git a/fr/changelog.mdx b/fr/changelog.mdx index a22bd5b7a..f154dcd60 100644 --- a/fr/changelog.mdx +++ b/fr/changelog.mdx @@ -5,6 +5,78 @@ rss: true noindex: true --- + + +
+ ## Préférences de notification +
+ + - **Préférences de notification :** Choisissez les e-mails que vous recevez pour chaque événement, y compris les réponses aux commentaires et les mentions, les résolutions de fils, les suggestions soumises, acceptées ou refusées, les exécutions d'automatisations et les retours produit. Configurez vos préférences sur la page [Notifications](https://app.mintlify.com/settings/organization/notifications) de votre dashboard. + - **E-mails d'échec d'automatisation :** Activez les notifications d'exécution des automatisations pour recevoir un e-mail lorsqu'une exécution échoue. Mintlify retient ensuite les e-mails d'échec suivants jusqu'à ce qu'une exécution réussisse à nouveau. + - **Notifications de partage :** Mintlify vous notifie lorsqu'une personne partage une page avec vous. + +
+ ## Éditeur et collaboration +
+ + - **Mode source collaboratif :** Le mode source prend désormais en charge la collaboration en temps réel. Voyez les curseurs de vos coéquipiers pendant qu'ils travaillent sur la même branche que vous. Les modifications du frontmatter se synchronisent en direct entre le mode visuel et le mode source. Consultez [Édition en temps réel](/fr/editor/collaborate#real-time-editing). + - **Réactions aux commentaires :** Réagissez à un commentaire avec un emoji pour en prendre acte sans répondre. Survolez une réaction pour voir qui a réagi, et réagir au commentaire d'une autre personne notifie son auteur. Consultez [Commentaires](/fr/editor/collaborate#comments). + - **Publication sélective :** Sélectionnez des modifications individuelles dans le menu de publication pour publier une partie de votre travail en attente au lieu de tout publier d'un coup. + - **Médias sur les pages privées :** Téléversez des images et des vidéos sur les pages privées. Les médias privés ne sont servis qu'aux personnes qui peuvent ouvrir la page, et ils sont supprimés lorsque la page est supprimée. + - **Finitions de l'éditeur :** Les résultats de recherche affichent les titres des pages et révèlent le fichier dans la barre latérale, la barre latérale ne liste par défaut que les pages Markdown, la fenêtre de partage recherche les destinataires par adresse e-mail, le menu de suggestions d'emoji offre une meilleure pertinence de recherche, et le panneau de l'agent reste disponible dans les paramètres du site. + +
+ ## Automatisations +
+ + - **Périmètre des exécutions manuelles :** Lorsque vous déclenchez une automatisation manuellement, choisissez si elle examine les modifications depuis une date, le site entier ou une pull request spécifique. Consultez [Exécuter une automatisation manuellement](/fr/automations/manage#run-an-automation-manually). + +
+ ## Analytics +
+ + - **Filtre de page :** Filtrez vos analytics sur une page spécifique grâce au nouveau menu déroulant de pages dans le dashboard. + +
+ ## Playground API +
+ + - **Bascules des champs optionnels :** Dans la fenêtre du playground, les champs obligatoires sont triés en premier et les champs optionnels sont repliés derrière un contrôle **Expand N optional fields**, avec une bascule globale dans l'en-tête. Les champs repliés restent trouvables. Rechercher sur la page le nom d'un champ masqué déplie la section qui le contient, et les valeurs que vous avez saisies persistent entre le repli et le dépliage. + - **Replier les champs par défaut :** Définissez `expand: false` sous `x-mint: playground` sur une opération pour replier par défaut les champs d'objets imbriqués. Consultez [Replier les champs du playground](/fr/api-playground/openapi-setup#collapse-playground-fields). + +
+ ## Rédaction +
+ + - **`mint test` :** Générez des tests pour les blocs de code de votre documentation depuis la CLI. Les exécutions sont enregistrées afin que vous puissiez consulter les rapports passés. Consultez [`mint test`](/fr/cli/commands#mint-test). + - **Améliorations de `` :** Les titres à l'intérieur des blocs `` sont intégrés à la table des matières de la page, les ancres `## Title {#id}` fonctionnent à n'importe quel niveau d'indentation, et les blocs de code à l'intérieur de `` se comportent comme les blocs de code à la racine de la page. Consultez [MDX](/fr/components/mdx). + - **Markdown dans les titres de composants :** Les titres de composants, comme les titres d'accordéons, prennent en charge la mise en forme Markdown en ligne comme le code et le gras. + - **Largeurs des colonnes de tableaux :** Les tableaux HTML respectent les largeurs `` que vous définissez. + +
+ ## Parrainages +
+ + - **Parrainages Enterprise :** Les organisations Enterprise peuvent désormais participer au [programme de parrainage](https://app.mintlify.com/settings/organization/referrals). + +
+ ## Corrections de bugs +
+ + - **Exports statiques :** Les builds statiques embarquent vos fichiers de logo, de sorte que les sites exportés ne référencent plus d'assets manquants. + - **Sous-groupes GitLab :** Les dépôts dans des sous-groupes GitLab imbriqués se synchronisent correctement. + - **Grands dépôts :** Les dépôts suffisamment volumineux pour que GitHub tronque leur liste de fichiers synchronisent désormais tous les fichiers. + - **Citations de l'assistant :** Les citations qui perdaient un premier segment de chemin ouvrent désormais la bonne page. + - **Prévisualisations authentifiées :** Les déploiements de prévisualisation pour la documentation derrière une authentification servent vos fichiers modifiés. + - **Traductions :** L'automatisation de traduction écrit des liens internes préfixés par la langue, de sorte que les pages nouvellement traduites pointent vers des pages de leur propre langue. + - **Nettoyage OpenAPI :** La suppression d'une spécification OpenAPI supprime les assets générés de votre site. + - **Polices personnalisées :** Le texte en gras reste en gras lorsque vous définissez une graisse personnalisée pour la police du corps de texte. + - **Retours sur le code :** La fenêtre contextuelle de retour sur les extraits de code s'affiche au-dessus du panneau de la table des matières. + - **Bannières masquées :** Les bannières masquées ne clignotent plus au chargement de la page. + - **Corrections de l'éditeur :** Les liens de type référence et les composants `Link` s'affichent correctement, les tableaux HTML avec `colspan` ou des classes font l'aller-retour sans modifications, la modification d'une page ne reformate plus le contenu non touché, et le changement de branche ne provoque plus de boucles de redirection. + + +
@@ -1831,82 +1903,82 @@ Consultez les retours ventilés par pages individuelles dans votre tableau de bo * **Langages Shiki personnalisés** : Ajout de la prise en charge de langages de programmation personnalisés dans les blocs de code via la configuration `docs.json`, permettant la coloration syntaxique pour des langages spécifiques à un domaine * **Intégration Clarity Analytics** : Microsoft Clarity est désormais disponible en tant qu’intégration d’analytics pour l’enregistrement de sessions et le suivi via heatmaps - ## Améliorations de l'API playground + ## Améliorations de l'API playground - * Les clés d'authentification sont désormais conservées dans l'API playground lors de la navigation entre les pages et les sessions de navigateur, ce qui évite de devoir ressaisir les identifiants lors des tests de plusieurs endpoints - * Les clés d'authentification sont automatiquement préremplies à partir de votre configuration, ce qui permet de démarrer plus rapidement les tests d'endpoints authentifiés - * Correction des noms d'en-têtes d'authentification pour Bearer auth et OAuth afin d'utiliser les standards HTTP appropriés - * Les entrées de sécurité définies au niveau de l'opération dans les spécifications OpenAPI remplacent désormais correctement les définitions de sécurité de niveau supérieur - * Correction d'un problème où les entrées d'en-têtes marquées comme paramètres de sécurité étaient incorrectement incluses dans les exemples de code générés - * Meilleure prise en charge des paramètres de style `deepObject` dans l'affichage des champs d'API - * Meilleurs messages d'erreur lorsque des URL invalides sont fournies dans les configurations d'API - * Amélioration de l'interface utilisateur de l'API playground avec un meilleur espacement, une meilleure mise en page et de meilleurs états de chargement + * Les clés d'authentification sont désormais conservées dans l'API playground lors de la navigation entre les pages et les sessions de navigateur, ce qui évite de devoir ressaisir les identifiants lors des tests de plusieurs endpoints + * Les clés d'authentification sont automatiquement préremplies à partir de votre configuration, ce qui permet de démarrer plus rapidement les tests d'endpoints authentifiés + * Correction des noms d'en-têtes d'authentification pour Bearer auth et OAuth afin d'utiliser les standards HTTP appropriés + * Les entrées de sécurité définies au niveau de l'opération dans les spécifications OpenAPI remplacent désormais correctement les définitions de sécurité de niveau supérieur + * Correction d'un problème où les entrées d'en-têtes marquées comme paramètres de sécurité étaient incorrectement incluses dans les exemples de code générés + * Meilleure prise en charge des paramètres de style `deepObject` dans l'affichage des champs d'API + * Meilleurs messages d'erreur lorsque des URL invalides sont fournies dans les configurations d'API + * Amélioration de l'interface utilisateur de l'API playground avec un meilleur espacement, une meilleure mise en page et de meilleurs états de chargement - ## Améliorations de la navigation et de l'interface + ## Améliorations de la navigation et de l'interface - * Les indicateurs au survol des onglets bénéficient désormais d'un style amélioré pour un meilleur retour visuel + * Les indicateurs au survol des onglets bénéficient désormais d'un style amélioré pour un meilleur retour visuel * Les mots longs sont désormais correctement renvoyés à la ligne pour éviter le défilement horizontal - * Le composant Step gère désormais les cas où aucun titre d'étape n'est fourni - * L'espacement de la section du logo est amélioré avec un meilleur padding - * Correction des identifiants de titres pour gérer correctement les points d'interrogation et les caractères spéciaux dans les liens d'ancrage + * Le composant Step gère désormais les cas où aucun titre d'étape n'est fourni + * L'espacement de la section du logo est amélioré avec un meilleur padding + * Correction des identifiants de titres pour gérer correctement les points d'interrogation et les caractères spéciaux dans les liens d'ancrage * Le composant Icon accepte désormais la prop `className` pour un style personnalisé * Correction des couleurs du sélecteur de thème pour une meilleure visibilité en mode clair comme en mode sombre - ## Améliorations de l'éditeur web + ## Améliorations de l'éditeur web - * Le changement de branche est désormais intégré directement dans l'interface de l'éditeur pour faciliter la navigation entre les branches - * Correction de la création et du renommage de fichiers pour correspondre correctement aux emplacements de fichiers d'origine dans le frontmatter MDX + * Le changement de branche est désormais intégré directement dans l'interface de l'éditeur pour faciliter la navigation entre les branches + * Correction de la création et du renommage de fichiers pour correspondre correctement aux emplacements de fichiers d'origine dans le frontmatter MDX * Correction de la gestion du déplacement de fichiers vers des chemins précédemment supprimés - * L'état des dossiers persiste désormais dans l'éditeur entre les sessions + * L'état des dossiers persiste désormais dans l'éditeur entre les sessions ## Améliorations des composants et du style * Les images peuvent désormais être zoomées avec un style de superposition amélioré en mode clair comme en mode sombre - * Correction des styles des raccourcis clavier à l'intérieur des callouts pour le mode sombre - * Amélioration de la génération d'images OG avec la prise en charge de Google Fonts et une meilleure logique de troncature - * Amélioration de l'interface utilisateur des tableaux avec un meilleur alignement, espacement et lisibilité + * Correction des styles des raccourcis clavier à l'intérieur des callouts pour le mode sombre + * Amélioration de la génération d'images OG avec la prise en charge de Google Fonts et une meilleure logique de troncature + * Amélioration de l'interface utilisateur des tableaux avec un meilleur alignement, espacement et lisibilité * Correction du comportement de défilement pour les tableaux dans les onglets et les étapes dans les onglets * Amélioration du style de la barre latérale pour le thème Palm ## Performances et infrastructure * Les thèmes Shiki sont désormais chargés à la demande pour améliorer les performances de chargement initial de la page - * Réduction de la latence de navigation grâce à l'optimisation du préchargement + * Réduction de la latence de navigation grâce à l'optimisation du préchargement ## Corrections de bugs et fiabilité - * Suppression correcte des valeurs ajoutées sur les champs objet et tableau dans l'API playground + * Suppression correcte des valeurs ajoutées sur les champs objet et tableau dans l'API playground * Correction des problèmes de rendu de la table des matières - * Correction de l'isolation des favicons pour éviter les conflits entre différents sites de documentation - * Correction de l'affichage de la barre latérale sur les pages non API - * Correction du clignotement du contour lors de l'ouverture/fermeture de la modale de zoom d'image - * Les liens externes s'ouvrent désormais correctement dans de nouveaux onglets - * Correction des incohérences de design du tableau de bord et amélioration de l'espacement + * Correction de l'isolation des favicons pour éviter les conflits entre différents sites de documentation + * Correction de l'affichage de la barre latérale sur les pages non API + * Correction du clignotement du contour lors de l'ouverture/fermeture de la modale de zoom d'image + * Les liens externes s'ouvrent désormais correctement dans de nouveaux onglets + * Correction des incohérences de design du tableau de bord et amélioration de l'espacement - ## Améliorations de l'assistant + ## Améliorations de l'assistant - * **Les questions de démarrage pour l'assistant sont là ! Vous pouvez ajouter les vôtres dans le tableau de bord, à [Assistant --> Settings](https://dashboard.mintlify.com/mintlify/mintlify/products/assistant/settings)** - * La qualité des insights de l'assistant a été améliorée, avec une protection antispam par défaut pour les mots-clés abusifs et les requêtes JSON. + * **Les questions de démarrage pour l'assistant sont là ! Vous pouvez ajouter les vôtres dans le tableau de bord, à [Assistant --> Settings](https://dashboard.mintlify.com/mintlify/mintlify/products/assistant/settings)** + * La qualité des insights de l'assistant a été améliorée, avec une protection antispam par défaut pour les mots-clés abusifs et les requêtes JSON. - ## Améliorations de l'aire de jeu API + ## Améliorations de l'aire de jeu API - * L'aire de jeu API renseigne désormais automatiquement les valeurs par défaut des paramètres, ce qui fait gagner du temps lors des tests d'endpoints. - * Les problèmes avec `allOf`, `oneOf` et les schémas d'objets imbriqués qui entraînaient auparavant des problèmes de rendu ou des champs affichés incorrectement ont été corrigés ; les schémas API complexes s'affichent maintenant correctement avec tous les champs visibles et bien structurés. - * Les types de champs enum et nullable affichent désormais des libellés exacts dans l'aire de jeu, clarifiant les valeurs acceptées et le caractère optionnel des champs. - * Lors de l'utilisation d'objets imbriqués dans les requêtes API, l'aire de jeu affiche désormais des libellés descriptifs pertinents pour chaque champ au lieu d'espaces réservés génériques, ce qui facilite la compréhension des données à fournir. - * Les tableaux de constantes enum et les affichages des champs API bénéficient désormais d'un formatage et d'un alignement améliorés, ce qui facilite le balayage des options disponibles et la compréhension des exigences des champs. - * Les modales de l'aire de jeu API affichent désormais, en haut, des descriptions riches au format MDX, offrant un meilleur contexte pour les endpoints avec texte formaté, liens et exemples de code. + * L'aire de jeu API renseigne désormais automatiquement les valeurs par défaut des paramètres, ce qui fait gagner du temps lors des tests d'endpoints. + * Les problèmes avec `allOf`, `oneOf` et les schémas d'objets imbriqués qui entraînaient auparavant des problèmes de rendu ou des champs affichés incorrectement ont été corrigés ; les schémas API complexes s'affichent maintenant correctement avec tous les champs visibles et bien structurés. + * Les types de champs enum et nullable affichent désormais des libellés exacts dans l'aire de jeu, clarifiant les valeurs acceptées et le caractère optionnel des champs. + * Lors de l'utilisation d'objets imbriqués dans les requêtes API, l'aire de jeu affiche désormais des libellés descriptifs pertinents pour chaque champ au lieu d'espaces réservés génériques, ce qui facilite la compréhension des données à fournir. + * Les tableaux de constantes enum et les affichages des champs API bénéficient désormais d'un formatage et d'un alignement améliorés, ce qui facilite le balayage des options disponibles et la compréhension des exigences des champs. + * Les modales de l'aire de jeu API affichent désormais, en haut, des descriptions riches au format MDX, offrant un meilleur contexte pour les endpoints avec texte formaté, liens et exemples de code. ## Modifications Analytics - * Chargement différé des analytics : PostHog et LogRocket se chargent désormais après le contenu de la documentation, ce qui améliore les temps de chargement initiaux et les scores Core Web Vitals, sans affecter les données d'analytics. - * Enregistrement de session conditionnel : l'enregistrement de session PostHog peut désormais être activé conditionnellement selon les propriétés utilisateur ou le contexte de page, pour mieux contrôler le déclenchement des enregistrements. + * Chargement différé des analytics : PostHog et LogRocket se chargent désormais après le contenu de la documentation, ce qui améliore les temps de chargement initiaux et les scores Core Web Vitals, sans affecter les données d'analytics. + * Enregistrement de session conditionnel : l'enregistrement de session PostHog peut désormais être activé conditionnellement selon les propriétés utilisateur ou le contexte de page, pour mieux contrôler le déclenchement des enregistrements. ## Améliorations visuelles - * Les tableaux ont désormais un meilleur alignement, un espacement cohérent et une lisibilité renforcée. Les en-têtes s'alignent correctement avec leurs colonnes de contenu. + * Les tableaux ont désormais un meilleur alignement, un espacement cohérent et une lisibilité renforcée. Les en-têtes s'alignent correctement avec leurs colonnes de contenu. ## Corrections de bugs @@ -1916,7 +1988,7 @@ Consultez les retours ventilés par pages individuelles dans votre tableau de bo * Icône Claude mise à jour avec un border-radius approprié pour une cohérence visuelle. * Correction du routage de `/llms.txt` afin que les agents LLM puissent accéder correctement à la documentation. * Empêche l’expansion infinie des schémas dans des specs OpenAPI complexes pouvant provoquer des plantages du navigateur. - * Suppression du débordement horizontal (x-overflow) dans le thème Palm qui coupait le texte dans l'aire de jeu API. + * Suppression du débordement horizontal (x-overflow) dans le thème Palm qui coupait le texte dans l'aire de jeu API. * Augmentation de la taille de police du contenu pour améliorer la compatibilité avec les modes lecteur des navigateurs. * Correction du style du bouton de connexion Google pour une meilleure cohérence visuelle. @@ -1924,23 +1996,23 @@ Consultez les retours ventilés par pages individuelles dans votre tableau de bo ## Améliorations des insights - * Amélioration de la page des insights avec des sélecteurs de date corrigés pour « aujourd'hui » et « hier » + * Amélioration de la page des insights avec des sélecteurs de date corrigés pour « aujourd'hui » et « hier » * Tableau de feedback amélioré avec une recherche renforcée - * Ajout d'un état de chargement pour le tableau des catégories + * Ajout d'un état de chargement pour le tableau des catégories - ## Améliorations de l'assistant + ## Améliorations de l'assistant * Ajout d’un paramétrage de l’emplacement de l’assistant dans le tableau de bord * Amélioration des réponses de l’assistant avec des correctifs sur la récupération du contexte et les messages d’outils - ## Améliorations de l'aire de jeu API et d'OpenAPI + ## Améliorations de l'aire de jeu API et d'OpenAPI * Refactorisation des champs d’endpoint de l’aire de jeu API pour utiliser un nouveau graphe de schéma, améliorant les performances * Amélioration de l’affichage des exemples d’API dans la modale de l’aire de jeu, même lorsque la barre latérale de l’assistant est ouverte * Correction des props adjacentes à `$refs` et aux props `x-` perdues lors de l’analyse OpenAPI * Correction du style de l’en-tête de la modale de l’aire de jeu API - ## Améliorations de l'éditeur web et des déploiements + ## Améliorations de l'éditeur web et des déploiements * Restauration du bouton de création manuelle de preview pour faciliter la création de déploiements de preview * Ajout d’un fetcher dans le tableau de bord pour les données de protections de branches @@ -2189,26 +2261,26 @@ Consultez les retours ventilés par pages individuelles dans votre tableau de bo * **Amélioration majeure** : Les lecteurs peuvent désormais donner un feedback plus détaillé après avoir sélectionné *pouce vers le haut/bas*, avec des options supplémentaires et des commentaires écrits. Vous pouvez également collecter du feedback sur les blocs de code et consulter toutes les réponses dans vos Analytics sur le Dashboard.\ *Remarque : contactez-nous pour activer cette fonctionnalité pour votre site.* - ## Améliorations de la navigation et de l'ergonomie + ## Améliorations de la navigation et de l'ergonomie - * Amélioration de l'ergonomie pour ignorer les barres obliques finales 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 un attribut `noAnchor` à vos balises HTML `h1-6` pour éviter qu'elles 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 ou non redirigés vers la première page d'un groupe de navigation lorsque le groupe est développé - * Amélioration de l'ergonomie pour faire alterner les styles des listes ordonnées imbriquées entre décimal/romain et alphabétique + * Amélioration de l'ergonomie pour ignorer les barres obliques finales 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 un attribut `noAnchor` à vos balises HTML `h1-6` pour éviter qu'elles 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 ou non redirigés vers la première page d'un groupe de navigation lorsque le groupe est développé + * Amélioration de l'ergonomie pour faire alterner les styles des listes ordonnées imbriquées entre décimal/romain et alphabétique ## Corrections de bugs et fiabilité - * Correction d'un bug où les liens d'ancrage basés sur la position de défilement ne fonctionnaient pas correctement lorsqu'il y avait des composants JS sur une page - * Correction d'un bug où Google indexait des fichiers `*.md` bruts parce qu'il leur manquait un en-tête `x-robots-tag noindex` - * Correction d'un bug avec OAuth sur la documentation protégée, où vous n'étiez pas redirigé vers votre page de départ une fois le flux terminé avec succès - * Correction d'un bug sur les aperçus de documentation protégée par authentification où vous ne pouviez pas voir l'intégralité de la barre de navigation - * Corrections de bugs sur la façon dont les SVG sont gérés avec notre nouveau CDN d'images + * Correction d'un bug où les liens d'ancrage basés sur la position de défilement ne fonctionnaient pas correctement lorsqu'il y avait des composants JS sur une page + * Correction d'un bug où Google indexait des fichiers `*.md` bruts parce qu'il leur manquait un en-tête `x-robots-tag noindex` + * Correction d'un bug avec OAuth sur la documentation protégée, où vous n'étiez pas redirigé vers votre page de départ une fois le flux terminé avec succès + * Correction d'un bug sur les aperçus de documentation protégée par authentification où vous ne pouviez pas voir l'intégralité de la barre de navigation + * Corrections de bugs sur la façon 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 les styles personnalisés sur `SidebarNavGroupDivider` - * De nouveaux tests de régression pour les pages d'API définies en MDX et ayant une sécurité définie garantiront un degré de stabilité plus élevé + * 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 et ayant une sécurité définie garantiront un degré de stabilité plus élevé ## Améliorations des performances @@ -2221,28 +2293,28 @@ Consultez les retours ventilés par pages individuelles dans votre tableau de bo * **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 pendant le 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 de vos déploiements, offrant une couverture complète des ressources - ## Améliorations de l'éditeur web et des déploiements + ## Améliorations de l'éditeur web et des déploiements - * Correction du workflow 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 une gestion correcte de l'échappement, plus besoin de recharger la page pour fermer les conflits + * Correction du workflow 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 une gestion correcte de l'échappement, plus besoin de recharger la page pour fermer les conflits * Optimisation des performances du workflow de mise à jour en invalidant le cache uniquement pour les 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 + ## Améliorations de l'authentification et de la navigation - * Nouveau support de l'authentification sur des sous-chemins personnalisés : si vous servez la documentation sur `https://yourdomain.com/docs`, l'authentification fonctionne désormais de manière transparente - * Correction d'un bug d'affichage de la barre latérale qui s'affichait de manière incorrecte lorsqu'un seul lien était configuré - * Refonte complète de la navigation mobile : boutons centrés avec des marges/espacements appropriés, espacement amélioré dans les menus déroulants, suppression des séparateurs inutiles et des marges pour les sections vides, et correction des problèmes d'espacement/marges du thème Maple + * Nouveau support de l'authentification sur des sous-chemins personnalisés : si vous servez la documentation sur `https://yourdomain.com/docs`, l'authentification fonctionne désormais de manière transparente + * Correction d'un bug d'affichage de la barre latérale qui s'affichait de manière incorrecte lorsqu'un seul lien était configuré + * Refonte complète de la navigation mobile : boutons centrés avec des marges/espacements appropriés, espacement amélioré dans les menus déroulants, suppression des séparateurs inutiles et des marges pour les sections vides, et correction des problèmes d'espacement/marges du thème Maple ## Corrections de composants et de style - * Résolution d'un problème de conversion des balises `` qui étaient incorrectement transformées en composants Heading et perturbaient le style personnalisé - * Ajout d'un interrupteur de configuration de l'Assistant en un clic dans le Dashboard pour une gestion plus simple + * Résolution d'un problème de conversion des balises `` qui étaient incorrectement transformées en composants Heading et perturbaient le style personnalisé + * Ajout d'un interrupteur de configuration de l'Assistant en un clic dans le Dashboard pour une gestion plus simple ## Améliorations techniques et fiabilité * Système de journalisation renforcé pour les workflows de mise à jour, permettant un débogage et une résolution des problèmes plus rapides * Correction de la limitation de débit GitHub pour les clients ayant plus de 10 spécifications OpenAPI/AsyncAPI en passant de la récupération individuelle de fichiers au clonage du référentiel - * Amélioration de la fiabilité de l'Assistant avec une prise en charge de LLM de secours, une meilleure gestion des erreurs de limitation de débit et une fonctionnalité d'outil de recherche plus robuste + * Amélioration de la fiabilité de l'Assistant avec une prise en charge de LLM de secours, une meilleure gestion des erreurs de limitation de débit et une fonctionnalité d'outil de recherche plus robuste diff --git a/fr/cli/commands.mdx b/fr/cli/commands.mdx index cf8972d33..03eb8d645 100644 --- a/fr/cli/commands.mdx +++ b/fr/cli/commands.mdx @@ -776,7 +776,7 @@ Exécutez la commande depuis la racine de votre projet de documentation. Elle pa `mint format` réécrit les fichiers sur place. Committez ou stashez vos modifications avant de l'exécuter afin de pouvoir examiner le diff. -Une fois terminé, la commande affiche le nombre de fichiers MDX reformatés et le nombre de fichiers dont l'analyse a échoué. Si un fichier échoue, la commande se termine avec le code `1` et affiche le chemin du fichier ainsi que l'erreur, ce qui vous permet de l'exécuter en CI pour imposer un formatage cohérent. +Une fois terminé, la commande affiche le nombre de fichiers MDX reformatés et le nombre de fichiers dont l'analyse a échoué. Si un fichier échoue, la commande se termine avec le code `1` et affiche le chemin du fichier ainsi que l'erreur, ce qui vous permet de l'exécuter en CI pour imposer un formatage cohérent. Consultez [Installer en CI](/fr/cli/install#install-in-ci) pour un exemple de pipeline. --- diff --git a/fr/cli/install.mdx b/fr/cli/install.mdx index 56d298e9c..4a371999c 100644 --- a/fr/cli/install.mdx +++ b/fr/cli/install.mdx @@ -24,6 +24,10 @@ keywords: ["CLI", "npm", "installer", "Node.js", "pnpm", "mint"] ``` + + La CLI est publiée sur npm sous le package [`mint`](https://www.npmjs.com/package/mint). N'installez pas l'ancien package `mintlify` dans vos scripts d'installation ou vos pipelines CI. Si les deux packages sont installés, consultez [Package mintlify versus mint](#troubleshooting). + + Si l'utilisateur vous a demandé de configurer Mintlify plutôt que d'installer uniquement la CLI, poursuivez avec l'authentification, la création du projet, la prévisualisation, la validation et le déploiement. Suivez le [workflow de configuration pour les agents dans le démarrage rapide](/fr/quickstart#set-up-mintlify-for-the-user). Ne vous arrêtez pas une fois que `mint --version` fonctionne. @@ -121,6 +125,41 @@ Si `mint update` n'est pas disponible dans votre version, réinstallez la CLI av ``` +
+ ## Installer en CI +
+ +Pour exécuter des vérifications CLI dans un pipeline d'intégration continue, installez le package `mint` globalement, puis exécutez les commandes dont vous avez besoin. Par exemple, ce job GitHub Actions vérifie le formatage avec [`mint format`](/fr/cli/commands#mint-format) et valide le build avec [`mint validate`](/fr/cli/commands#mint-validate) : + +```yaml +name: Docs checks + +on: + pull_request: + paths: + - "**/*.mdx" + - "docs.json" + +jobs: + docs-checks: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - name: Install the Mintlify CLI + run: npm i -g mint + - name: Check formatting + run: | + mint format + if [ -n "$(git status --porcelain)" ]; then + echo "Files are not formatted. Run 'mint format' locally and commit the changes." + exit 1 + fi + - name: Validate the build + run: mint validate +``` + +`mint format` réécrit les fichiers en place et se termine avec le code `1` si un fichier ne peut pas être analysé, c'est pourquoi le job vérifie la présence d'un diff après son exécution. `mint validate` se termine avec une erreur en cas d'avertissements ou d'erreurs et ne nécessite aucune vérification supplémentaire. +
## Prise en charge des éditeurs
diff --git a/fr/cli/mdx-extension.mdx b/fr/cli/mdx-extension.mdx index bda9be622..a857a7b7c 100644 --- a/fr/cli/mdx-extension.mdx +++ b/fr/cli/mdx-extension.mdx @@ -1,6 +1,6 @@ --- title: "Extension Mintlify MDX" -description: "Installez l'extension Mintlify MDX pour bénéficier de l'autocomplétion, des diagnostics en ligne, de la documentation au survol et d'une prévisualisation dans l'éditeur pendant que vous rédigez du MDX en local." +description: "Installez l'extension Mintlify MDX pour obtenir l'autocomplétion, les diagnostics en ligne, la documentation au survol et un aperçu dans l'éditeur." keywords: ["Cursor", "MDX", "autocomplétion", "diagnostics", "IntelliSense", "prévisualisation", "éditeur"] --- @@ -71,7 +71,7 @@ Survolez un composant ou une propriété pour voir sa fonction et un lien vers s ## Atteindre la définition
-Maintenez CMD (macOS) ou CTRL (Windows) et cliquez pour accéder à la définition : +Maintenez Cmd (macOS) ou Ctrl (Windows) et cliquez pour accéder à la définition : - des composants de snippet ; - des chemins d'import ; diff --git a/fr/components/accordions.mdx b/fr/components/accordions.mdx index 9b2984e19..aba900abc 100644 --- a/fr/components/accordions.mdx +++ b/fr/components/accordions.mdx @@ -69,7 +69,7 @@ Regroupez les Accordions liés avec ``. Cela crée une section c -````mdx Accordion Group Example +````mdx Accordion group example Vous pouvez placer d'autres composants à l'intérieur des Accordion. diff --git a/fr/contact-support.mdx b/fr/contact-support.mdx index 5e4fedd10..6ab673563 100644 --- a/fr/contact-support.mdx +++ b/fr/contact-support.mdx @@ -7,7 +7,7 @@ description: "Contactez le support Mintlify pour obtenir de l'aide sur votre sit ## Interrogez notre documentation
-Utilisez le raccourci clavier Command + I (macOS) ou Ctrl + I (Windows/Linux) pour démarrer une conversation avec notre Assistant IA entraîné sur notre documentation. +Utilisez le raccourci clavier Cmd + I (macOS) ou Ctrl + I (Windows/Linux) pour démarrer une conversation avec notre Assistant IA entraîné sur notre documentation.
## Tutoriels vidéo diff --git a/fr/create/reusable-snippets.mdx b/fr/create/reusable-snippets.mdx index dde2a7d93..e0d4e437e 100644 --- a/fr/create/reusable-snippets.mdx +++ b/fr/create/reusable-snippets.mdx @@ -36,7 +36,7 @@ Importez des snippets dans des pages en utilisant soit un chemin absolu, soit un Le nom utilisé pour rendre un snippet importé sous forme de balise JSX doit commencer par une lettre majuscule, comme `MySnippet`. MDX traite les balises commençant par une minuscule, comme ``, comme des noms littéraux d’éléments HTML ou d’éléments personnalisés plutôt que comme des références à des snippets importés. Par convention, utilisez la PascalCase pour les noms de snippets. - Les imports relatifs permettent la navigation dans l’IDE. Appuyez sur CMD et cliquez sur le nom d’un snippet dans votre éditeur pour accéder directement à la définition de ce snippet. + Les imports relatifs permettent la navigation dans l’IDE. Appuyez sur Cmd et cliquez sur le nom d’un snippet dans votre éditeur pour accéder directement à la définition de ce snippet.
@@ -49,7 +49,7 @@ Le nom utilisé pour rendre un snippet importé sous forme de balise JSX doit co Hello world! This is my content I want to reuse across pages. ``` -2. Importez l'extrait dans votre fichier de destination à l'aide d'un chemin absolu ou relatif. +2. Importez l'extrait dans votre fichier de destination à l'aide d'un chemin absolu ou relatif. @@ -201,10 +201,10 @@ import InstallSnippet from "/shared/install-snippet.mdx"; ``` - Important : lors de la création d'extraits JSX, utilisez la syntaxe de fonction fléchée (`=>`) plutôt que des déclarations de fonction. Le mot‑clé `function` n'est pas pris en charge dans les extraits. + Important : lors de la création d'extraits JSX, utilisez la syntaxe de fonction fléchée (`=>`) plutôt que des déclarations de fonction. Le mot‑clé `function` n'est pas pris en charge dans les extraits. -2. Importez l'extrait. +2. Importez l'extrait. ```mdx destination-file.mdx --- diff --git a/fr/credits.mdx b/fr/credits.mdx index 9e9738377..b1f42b481 100644 --- a/fr/credits.mdx +++ b/fr/credits.mdx @@ -1,6 +1,6 @@ --- title: "Tarification par crédits" -description: "Découvrez le prix fixe en crédits de chaque action d'IA, le fonctionnement du solde de crédits partagé de votre organisation, et la facturation des paliers, dépassements et reports." +description: "Découvrez le prix fixe en crédits de chaque action d'IA, votre solde de crédits partagé et la facturation Mintlify des paliers, dépassements et reports." keywords: ["crédits", "facturation", "tarification", "organisation", "assistant", "agent", "automatisations", "paliers", "dépassements", "reports", "utilisation", "export", "CSV", "journal d'activité"] --- diff --git a/fr/guides/use-automations.mdx b/fr/guides/use-automations.mdx index a2ce9f2bd..5b3e117a6 100644 --- a/fr/guides/use-automations.mdx +++ b/fr/guides/use-automations.mdx @@ -112,7 +112,7 @@ Décidez du niveau de relecture souhaité avant que les modifications soient mis Chaque exécution d'automatisation qui met à jour votre documentation coûte 250 crédits, quels que soient la quantité de contenu que l'agent lit et le nombre de pages qu'il modifie. Les exécutions qui ne trouvent rien à mettre à jour ne coûtent rien. Pour connaître le coût réel de vos automatisations, consultez le journal d'activité sur la page [Usage](https://app.mintlify.com/settings/organization/usage). -La planification de tâches cron à des moments précis vous donne un contrôle plus fin sur l'utilisation des crédits. Par exemple, exécutez une automatisation une fois par jour ou une fois par semaine pour plafonner le nombre de mises à jour qu'elle peut effectuer par mois, et regroupez plusieurs modifications sources en une seule mise à jour au lieu de payer chacune séparément. Les automatisations déclenchées par push peuvent varier davantage d'un mois à l'autre car elles dépendent de la fréquence à laquelle le contenu ou le code change. +La planification de tâches cron à des moments précis vous donne un contrôle plus fin sur l'utilisation des crédits. Par exemple, exécutez une automatisation une fois par jour ou une fois par semaine pour plafonner le nombre de mises à jour qu'elle peut effectuer par mois. Une planification regroupe également plusieurs modifications sources en une seule mise à jour, de sorte que vous ne payez pas chaque modification séparément. Les automatisations déclenchées par push peuvent varier davantage d'un mois à l'autre car elles dépendent de la fréquence à laquelle le contenu ou le code change.
## Examiner et améliorer les résultats d'automatisation diff --git a/fr/help-center/configure-oauth-with-auth0.mdx b/fr/help-center/configure-oauth-with-auth0.mdx index 19608754c..b21c9a79a 100644 --- a/fr/help-center/configure-oauth-with-auth0.mdx +++ b/fr/help-center/configure-oauth-with-auth0.mdx @@ -1,6 +1,6 @@ --- title: "Configurer l'authentification OAuth 2.0 avec Auth0" -description: "Configurez Auth0 comme fournisseur d'identité OAuth 2.0 pour un site de documentation Mintlify privé, y compris les URL d'endpoints, l'enregistrement du callback et le contrôle d'accès basé sur les groupes." +description: "Configurez Auth0 comme fournisseur d'identité OAuth 2.0 pour une documentation Mintlify privée : URL des endpoints, callback et accès par groupes." keywords: ["Auth0", "OAuth", "OAuth 2.0", "OIDC", "identity provider", "SSO", "private docs", "authentication"] --- @@ -43,7 +43,7 @@ Pour restreindre certaines pages à des utilisateurs Auth0 spécifiques, vous av - **Claims des jetons (recommandé).** Ajoutez un claim de groupes à l'ID token ou à l'access token avec une [Auth0 Action](https://auth0.com/docs/customize/actions) et configurez Mintlify pour le lire. Voir [Utiliser les groupes issus des claims des jetons OAuth](/fr/deploy/authentication-setup#use-groups-from-oauth-token-claims). Si vous récupérez les groupes depuis l'ID token, conservez `openid` dans vos scopes. - **Info API URL.** Pointez Mintlify vers `https://YOUR_AUTH0_DOMAIN/userinfo` ou vers votre propre endpoint renvoyant des données utilisateur au [format des données utilisateur](/fr/deploy/authentication-setup#user-data-format). L'endpoint doit accepter `Authorization: Bearer ` et renvoyer les groupes dans la réponse. -Ensuite, taguez les pages ou les groupes de navigation avec une valeur `groups` correspondante afin que seuls les membres de ce groupe puissent les voir. +Ensuite, ajoutez une valeur `groups` correspondante dans le frontmatter de chaque page que vous souhaitez restreindre afin que seuls les membres de ce groupe puissent la voir. ## Dépannage diff --git a/fr/help-center/tailwind-classes-not-applying-in-editor-preview.mdx b/fr/help-center/tailwind-classes-not-applying-in-editor-preview.mdx index 2a5f71348..71c242825 100644 --- a/fr/help-center/tailwind-classes-not-applying-in-editor-preview.mdx +++ b/fr/help-center/tailwind-classes-not-applying-in-editor-preview.mdx @@ -1,6 +1,6 @@ --- -title: "Les classes Tailwind ne s'appliquent pas dans l'aperçu en direct de l'éditeur" -description: "Diagnostiquez pourquoi une page stylisée avec des classes Tailwind CSS, comme une page de destination en mode personnalisé, semble sans style dans l'aperçu en direct de l'éditeur web mais s'affiche correctement sur les déploiements et avec mint dev." +title: "Les classes Tailwind ne s'appliquent pas dans l'aperçu" +description: "L'aperçu en direct de l'éditeur ignore le build qui génère le CSS de Tailwind. Vérifiez le style avec mint dev ou un déploiement de prévisualisation." keywords: ["tailwind ne fonctionne pas", "classes tailwind non appliquées", "page personnalisée semble cassée", "aperçu de l'éditeur sans style", "styles manquants dans l'aperçu en direct", "mode personnalisé sans styles"] --- diff --git a/fr/search-index/connect.mdx b/fr/search-index/connect.mdx index 1b735c94e..95be3f80e 100644 --- a/fr/search-index/connect.mdx +++ b/fr/search-index/connect.mdx @@ -83,7 +83,7 @@ Pour configurer manuellement un agent, ou vérifier les modifications effectuée - 1. Ouvrez la palette de commandes avec Command + Shift + P (Ctrl + Shift + P sous Windows). + 1. Ouvrez la palette de commandes avec Cmd + Shift + P (Ctrl + Shift + P sous Windows). 2. Recherchez **Ouvrir les paramètres MCP**. 3. Sélectionnez **Ajouter un MCP personnalisé** pour ouvrir `mcp.json`. diff --git a/redirects.json b/redirects.json index 1fba4f9c0..662a5e625 100644 --- a/redirects.json +++ b/redirects.json @@ -1359,6 +1359,10 @@ "source": "/fr/workflows/enable", "destination": "/fr/automations/manage" }, + { + "source": "/zh/workflows/enable", + "destination": "/zh/automations/manage" + }, { "source": "/workflows/index", "destination": "/automations/index" @@ -1371,6 +1375,10 @@ "source": "/fr/workflows/index", "destination": "/fr/automations/index" }, + { + "source": "/zh/workflows/index", + "destination": "/zh/automations/index" + }, { "source": "/workflows/reference", "destination": "/automations/reference" @@ -1383,6 +1391,10 @@ "source": "/fr/workflows/reference", "destination": "/fr/automations/reference" }, + { + "source": "/zh/workflows/reference", + "destination": "/zh/automations/reference" + }, { "source": "/workflows/manage", "destination": "/automations/manage" @@ -1395,6 +1407,10 @@ "source": "/fr/workflows/manage", "destination": "/fr/automations/manage" }, + { + "source": "/zh/workflows/manage", + "destination": "/zh/automations/manage" + }, { "source": "/workflows/create", "destination": "/automations/create" @@ -1407,6 +1423,10 @@ "source": "/fr/workflows/create", "destination": "/fr/automations/create" }, + { + "source": "/zh/workflows/create", + "destination": "/zh/automations/create" + }, { "source": "/guides/use-workflows", "destination": "/guides/use-automations" @@ -1419,6 +1439,10 @@ "source": "/fr/guides/use-workflows", "destination": "/fr/guides/use-automations" }, + { + "source": "/zh/guides/use-workflows", + "destination": "/zh/guides/use-automations" + }, { "source": "/what-is-mintlify", "destination": "/reference/concepts" diff --git a/zh/ai/markdown-export.mdx b/zh/ai/markdown-export.mdx index 68222a8c5..c64a8510d 100644 --- a/zh/ai/markdown-export.mdx +++ b/zh/ai/markdown-export.mdx @@ -141,4 +141,4 @@ Markdown 导出遵循与每个页面 HTML 版本相同的身份验证规则。 ## 键盘快捷键
-按 Command + C（在 Windows 上为 Ctrl + C）将页面以 Markdown 格式复制到剪贴板。 +按 Cmd + C（在 Windows 上为 Ctrl + C）将页面以 Markdown 格式复制到剪贴板。 diff --git a/zh/ai/mintlify-mcp.mdx b/zh/ai/mintlify-mcp.mdx index cbc282999..c0b6ae279 100644 --- a/zh/ai/mintlify-mcp.mdx +++ b/zh/ai/mintlify-mcp.mdx @@ -77,7 +77,7 @@ keywords: ["MCP", "写入权限", "AI", "编辑", "Claude", "ChatGPT", "Cursor", 从 [ChatGPT 应用目录](https://chatgpt.com/apps/mintlify-mcp/asdk_app_6a4d5a687f0881918be3cb8b4b93773d) 安装 Mintlify 官方连接器，并在出现提示时完成 OAuth 登录。安装后，ChatGPT 即可在聊天中调用 Mintlify 管理员 MCP 工具。 - 1. 使用 Command \+ Shift \+ P (Windows 上为 Ctrl \+ Shift \+ P) 打开命令面板。 + 1. 使用 Cmd \+ Shift \+ P (Windows 上为 Ctrl \+ Shift \+ P) 打开命令面板。 2. 搜索 **Open MCP settings** 并点击 **Add custom MCP**。 3. 在 `mcp.json` 中添加管理员 MCP： diff --git a/zh/ai/model-context-protocol.mdx b/zh/ai/model-context-protocol.mdx index 578822621..7095d134f 100644 --- a/zh/ai/model-context-protocol.mdx +++ b/zh/ai/model-context-protocol.mdx @@ -470,8 +470,8 @@ noindex: true 为用户创建一份指南，包含你的 MCP 服务器 URL 以及将其连接到 Cursor 的步骤。 - 1. 使用 Command + Shift + P (Windows 上为 Ctrl + Shift + P) 打开命令面板。 - 2. 搜索 "Open MCP settings"。 + 1. 使用 Cmd + Shift + P (Windows 上为 Ctrl + Shift + P) 打开命令面板。 + 2. 搜索 "Open MCP settings"。 3. 选择 **Add custom MCP**。这会打开 `mcp.json` 文件。 4. 在 `mcp.json` 中配置服务器： @@ -597,7 +597,7 @@ noindex: true - 1. 使用 Command + Shift + P (Windows 上为 Ctrl + Shift + P) 打开命令面板。 + 1. 使用 Cmd + Shift + P (Windows 上为 Ctrl + Shift + P) 打开命令面板。 2. 搜索 “Open MCP settings”。 3. 选择 **Add custom MCP**。这会打开 `mcp.json` 文件。 diff --git a/zh/api-playground/adding-sdk-examples.mdx b/zh/api-playground/adding-sdk-examples.mdx index 8c5b4f5a5..dc75d5420 100644 --- a/zh/api-playground/adding-sdk-examples.mdx +++ b/zh/api-playground/adding-sdk-examples.mdx @@ -6,7 +6,7 @@ keywords: ["x-codeSamples", "SDK 示例", "Speakeasy", "自动生成的 SDK"] 如果你的用户通过 SDK 而非直接的网络请求与 API 交互，请使用 `x-codeSamples` 扩展添加 SDK 代码示例。Mintlify 会在你的 OpenAPI 页面上显示这些示例。 -你可以自行编写这些示例；如果你使用 Speakeasy 生成 SDK，也可以让示例自动添加到你的规范中。 +你可以自行编写这些示例。如果你使用 Speakeasy 生成 SDK，Speakeasy 可以自动将示例添加到你的规范中。
## 手动添加示例 @@ -63,14 +63,14 @@ paths: -前往你的 [Speakeasy 控制台](https://app.speakeasy.com)，打开 **API Registry** 标签页。打开该 API 的 `*-with-code-samples` 条目。 +前往你的 [Speakeasy 控制台](https://app.speakeasy.com)，打开 **API Registry** 标签页。打开你的 API 的 `*-with-code-samples` 条目。 ![Speakeasy API Registry 页面的屏幕截图。红色方框和数字 1 标出 API Registry 标签页，红色方框和数字 2 标出该 API 的条目。](/images/speakeasy/openapi-registry-and-combined-spec.png) - 如果该条目未标记为 **Combined Spec**，请确认该 API 已配置[自动代码示例 URL](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls)。 + 如果该条目未标记为 **Combined Spec**，请确认你的 API 已配置[自动代码示例 URL](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls)。 在注册表条目的页面中，复制提供的公开 URL。 diff --git a/zh/assistant/configure.mdx b/zh/assistant/configure.mdx index afd108d4d..5096beb57 100644 --- a/zh/assistant/configure.mdx +++ b/zh/assistant/configure.mdx @@ -95,7 +95,7 @@ AI 助手可以根据用户正在查看的页面生成特定于页面的问题 ## 机器人防护
-在"机器人防护"部分，启用隐形验证码以保护你的 AI 助手免受自动化滥用。机器人防护注重隐私保护，对几乎所有访客不可见。 +在 **Bot Protection** 部分，启用隐形验证码以保护你的 AI 助手免受自动化滥用。机器人防护注重隐私保护，对几乎所有访客不可见。 要启用机器人防护： diff --git a/zh/assistant/use.mdx b/zh/assistant/use.mdx index 4821c3394..50f50cb23 100644 --- a/zh/assistant/use.mdx +++ b/zh/assistant/use.mdx @@ -71,7 +71,7 @@ AI 助手出现在两个位置：搜索栏旁边的按钮和页面底部的横 ## 键盘快捷键
-使用键盘快捷键打开 AI 助手聊天面板：macOS 上使用 Command + I，Windows 上使用 Ctrl + I。 +使用键盘快捷键打开 AI 助手聊天面板：macOS 上使用 Cmd + I，Windows 上使用 Ctrl + I。
## URL 参数 diff --git a/zh/changelog.mdx b/zh/changelog.mdx index 11fb598b5..798ec046c 100644 --- a/zh/changelog.mdx +++ b/zh/changelog.mdx @@ -5,6 +5,78 @@ rss: true noindex: true --- + + +
+ ## 通知偏好设置 +
+ + - **通知偏好设置：** 选择你希望针对每类事件接收哪些邮件，包括评论回复和提及、讨论解决、建议的提交、接受或拒绝、automation 运行以及产品反馈。在 dashboard 的 [Notifications](https://app.mintlify.com/settings/organization/notifications) 页面配置偏好设置。 + - **Automation 失败邮件：** 开启 automation 运行通知后，运行失败时你会收到邮件。此后 Mintlify 会暂停发送失败邮件，直到再次有运行成功。 + - **分享通知：** 当有人与你分享页面时，Mintlify 会通知你。 + +
+ ## 编辑器与协作 +
+ + - **协作源代码模式：** 源代码模式现在支持实时协作。当队友与你在同一 branch 上工作时，可以看到他们的光标。frontmatter 编辑会在可视模式和源代码模式之间实时同步。详情请参见 [实时编辑](/zh/editor/collaborate#real-time-editing)。 + - **评论表情回应：** 用表情符号回应评论，无需回复即可表示知悉。将鼠标悬停在表情回应上可查看是谁作出了回应，回应他人的评论会通知其作者。详情请参见 [评论](/zh/editor/collaborate#comments)。 + - **选择性发布：** 在发布菜单中选择单个更改，只发布部分待处理的工作，而不必一次性全部发布。 + - **私密页面上的媒体：** 可向私密页面上传图片和视频。私密媒体只会提供给能够打开该页面的人，并且在页面删除时一并移除。 + - **编辑器打磨：** 搜索结果会显示页面标题并在侧边栏中定位文件，侧边栏默认只列出 Markdown 页面，分享对话框可按电子邮箱地址搜索收件人，表情符号建议菜单的搜索相关性更好，agent 面板在站点设置中保持可用。 + +
+ ## Automations +
+ + - **手动运行的运行范围：** 手动触发 automation 时，可选择让它审查自某个日期以来的更改、整个站点或特定的 pull request。详情请参见 [手动运行 automation](/zh/automations/manage#run-an-automation-manually)。 + +
+ ## 分析 +
+ + - **页面过滤器：** 使用 dashboard 中新增的页面下拉菜单，将分析数据筛选到特定页面。 + +
+ ## API playground +
+ + - **可选字段开关：** 在 playground 弹窗中，必填字段排在最前，可选字段折叠在 **Expand N optional fields** 控件之后，页眉中还提供全局开关。折叠的字段仍然可以找到：在页面中搜索隐藏字段名会展开包含它的部分，你输入的值在折叠和展开之间保持不变。 + - **默认折叠字段：** 在操作的 `x-mint: playground` 下设置 `expand: false`，即可默认折叠嵌套对象字段。详情请参见 [折叠 playground 字段](/zh/api-playground/openapi-setup#collapse-playground-fields)。 + +
+ ## 创作 +
+ + - **`mint test`：** 通过 CLI 为文档中的代码块生成测试。运行结果会被保存，方便你回顾以往的报告。详情请参见 [`mint test`](/zh/cli/commands#mint-test)。 + - **`` 改进：** `` 块内的标题会合并到页面目录中，`## Title {#id}` 锚点在任意缩进下都可用，`` 内的代码块与页面根级的代码块行为一致。详情请参见 [MDX](/zh/components/mdx)。 + - **组件标题中的 Markdown：** 组件标题（例如 accordion 标题）支持代码、加粗等内联 Markdown 格式。 + - **表格列宽：** HTML 表格会遵循你编写的 `` 宽度。 + +
+ ## 推荐 +
+ + - **Enterprise 推荐：** Enterprise 组织现在可以参与[推荐计划](https://app.mintlify.com/settings/organization/referrals)。 + +
+ ## 错误修复 +
+ + - **静态导出：** 静态构建会打包你的 logo 文件，导出的站点不再引用缺失的资源。 + - **GitLab 子组：** 嵌套 GitLab 子组中的仓库可以正确同步。 + - **大型仓库：** 文件列表大到被 GitHub 截断的仓库现在会同步所有文件。 + - **Assistant 引用：** 之前丢失开头路径段的引用现在会打开正确的页面。 + - **认证预览：** 需要身份验证的文档的预览部署会提供你更改后的文件。 + - **翻译：** 翻译 automation 会写入带语言前缀的内部链接，因此新翻译的页面会在其自身语言内跳转。 + - **OpenAPI 清理：** 删除 OpenAPI 规范会从站点中移除其生成的资源。 + - **自定义字体：** 设置自定义正文字重时，粗体文本保持粗体。 + - **代码反馈：** 代码片段反馈弹出层会显示在目录面板之上。 + - **已关闭的横幅：** 已关闭的横幅不再在页面加载时闪现。 + - **编辑器修复：** 引用式链接和 `Link` 组件可正确渲染，带 `colspan` 或 class 的 HTML 表格往返编辑不再产生变化，编辑页面不再重新格式化未改动的内容，切换 branch 不再导致重定向循环。 + + +
diff --git a/zh/cli/commands.mdx b/zh/cli/commands.mdx index 99e070e14..2a2e87041 100644 --- a/zh/cli/commands.mdx +++ b/zh/cli/commands.mdx @@ -776,7 +776,7 @@ mint format `mint format` 会就地重写文件。运行前请先提交或暂存你的更改，以便审查 diff。 -命令完成后，会打印重新格式化了多少个 MDX 文件以及有多少文件解析失败。如果有任何文件失败，命令将以退出码 `1` 结束，并打印文件路径和错误信息，这样你就可以在 CI 中运行它以强制执行一致的格式。 +命令完成后，会打印重新格式化了多少个 MDX 文件以及有多少文件解析失败。如果有任何文件失败，命令将以退出码 `1` 结束，并打印文件路径和错误信息，这样你就可以在 CI 中运行它以强制执行一致的格式。示例流水线请参见 [在 CI 中安装](/zh/cli/install#install-in-ci)。 --- diff --git a/zh/cli/install.mdx b/zh/cli/install.mdx index deda9bd1e..7b6b69e0b 100644 --- a/zh/cli/install.mdx +++ b/zh/cli/install.mdx @@ -1,6 +1,6 @@ --- title: "安装 CLI" -description: "安装 Mintlify CLI 并配置本地文档开发环境，使用 npm 或 pnpm 管理全局安装，创建新项目、更新 CLI、格式化 MDX 文件，以及在发布前排查权限和构建问题。本文还说明 Node.js 版本要求、主题与模板选项、常用命令、交互式设置方式，以及本地预览异常和客户端下载失败时的处理方法。" +description: "安装 Mintlify CLI 并配置本地文档开发环境：使用 npm 或 pnpm 全局安装、更新 CLI、在 CI 中运行检查，并排查安装和构建问题。" keywords: ["CLI", "npm", "安装", "Node.js", "pnpm", "mint"] --- @@ -24,6 +24,10 @@ keywords: ["CLI", "npm", "安装", "Node.js", "pnpm", "mint"] ``` + + CLI 在 npm 上以 [`mint`](https://www.npmjs.com/package/mint) 包的形式发布。请勿在安装脚本或 CI 流水线中安装旧版 `mintlify` 包。如果你同时安装了这两个包，请参见 [mintlify 与 mint 包](#troubleshooting)。 + + 如果用户要求你设置 Mintlify，而不仅仅是安装 CLI，请继续完成身份验证、项目创建、预览、验证和部署。请遵循[快速入门中的 agent 设置工作流](/zh/quickstart#set-up-mintlify-for-the-user)。`mint --version` 成功后不要停止。 @@ -121,6 +125,41 @@ mint update ``` +
+ ## 在 CI 中安装 +
+ +要在持续集成流水线中运行 CLI 检查，请全局安装 `mint` 包，然后运行你需要的命令。例如，下面这个 GitHub Actions 作业使用 [`mint format`](/zh/cli/commands#mint-format) 检查格式，并使用 [`mint validate`](/zh/cli/commands#mint-validate) 验证构建： + +```yaml +name: Docs checks + +on: + pull_request: + paths: + - "**/*.mdx" + - "docs.json" + +jobs: + docs-checks: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - name: Install the Mintlify CLI + run: npm i -g mint + - name: Check formatting + run: | + mint format + if [ -n "$(git status --porcelain)" ]; then + echo "Files are not formatted. Run 'mint format' locally and commit the changes." + exit 1 + fi + - name: Validate the build + run: mint validate +``` + +`mint format` 会就地重写文件，并在任何文件解析失败时以退出码 `1` 结束，因此该作业会在其运行后检查是否存在 diff。`mint validate` 在出现任何警告或错误时都会以错误退出，无需额外检查。 +
## 编辑器支持
diff --git a/zh/cli/mdx-extension.mdx b/zh/cli/mdx-extension.mdx index ec14a21f8..96bccc380 100644 --- a/zh/cli/mdx-extension.mdx +++ b/zh/cli/mdx-extension.mdx @@ -71,7 +71,7 @@ code --install-extension mintlify.mintlify-snippets ## 跳转到定义
-按住 CMD（macOS）或 CTRL（Windows）并点击，即可跳转到以下内容的定义： +按住 Cmd（macOS）或 Ctrl（Windows）并点击，即可跳转到以下内容的定义： - Snippet 组件。 - 导入路径。 diff --git a/zh/components/accordions.mdx b/zh/components/accordions.mdx index cef998452..d18fea897 100644 --- a/zh/components/accordions.mdx +++ b/zh/components/accordions.mdx @@ -69,7 +69,7 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx"; -````mdx Accordion Group Example +````mdx Accordion group example 您可以在折叠面板内放置其他组件。 diff --git a/zh/contact-support.mdx b/zh/contact-support.mdx index aafe49d98..d314b1198 100644 --- a/zh/contact-support.mdx +++ b/zh/contact-support.mdx @@ -7,7 +7,7 @@ description: "联系 Mintlify 支持团队，获取文档站点的技术支持 ## 询问我们的文档
-使用键盘快捷键 Command + I（macOS）或 Ctrl + I（Windows/Linux）启动与基于我们文档训练的 AI 助手的聊天。 +使用键盘快捷键 Cmd + I（macOS）或 Ctrl + I（Windows/Linux）启动与基于我们文档训练的 AI 助手的聊天。
## 观看视频教程 diff --git a/zh/create/reusable-snippets.mdx b/zh/create/reusable-snippets.mdx index eae1a5837..7f6d3f372 100644 --- a/zh/create/reusable-snippets.mdx +++ b/zh/create/reusable-snippets.mdx @@ -36,7 +36,7 @@ keywords: ["content snippets", "reusable content", "variables"] 将导入的代码片段渲染为 JSX 标签时，使用的名称应以大写字母开头，例如 `MySnippet`。MDX 会将 `` 之类以小写字母开头的标签视为 HTML 元素或自定义元素的字面名称，而不是对导入代码片段的引用。按照惯例，代码片段名称应使用 PascalCase。 - 相对导入支持 IDE 导航。在编辑器中按住 CMD 并单击代码片段名称即可直接跳转到该代码片段的定义。 + 相对导入支持 IDE 导航。在编辑器中按住 Cmd 并单击代码片段名称即可直接跳转到该代码片段的定义。
diff --git a/zh/credits.mdx b/zh/credits.mdx index fea874b8c..8fdc786bb 100644 --- a/zh/credits.mdx +++ b/zh/credits.mdx @@ -1,6 +1,6 @@ --- title: "积分定价" -description: "了解每项 AI 操作的固定积分价格、组织的共享积分余额如何运作，以及 Mintlify 如何对积分套餐、超额使用和结转进行计费。" +description: "了解每项 AI 操作的固定积分价格、共享积分余额如何运作，以及 Mintlify 如何对套餐、超额使用和结转进行计费。" keywords: ["积分", "计费", "定价", "组织", "assistant", "agent", "自动化", "套餐", "超额使用", "结转", "用量", "导出", "CSV", "活动日志"] --- diff --git a/zh/guides/use-automations.mdx b/zh/guides/use-automations.mdx index a547cd362..5bdec6f12 100644 --- a/zh/guides/use-automations.mdx +++ b/zh/guides/use-automations.mdx @@ -112,7 +112,7 @@ For each broken link, either fix the path or remove the link if no replacement e 每次更新文档的自动化运行都消耗 250 个积分，无论 agent 读取多少内容或更改多少页面。未发现需要更新内容的运行不消耗积分。要了解自动化的实际消耗，请查看 [Usage](https://app.mintlify.com/settings/organization/usage) 页面上的 Activity log。 -为 cron 任务安排在特定时间运行可以让你更精确地控制积分使用量。例如，让自动化每天或每周运行一次，以限定它每月最多能进行多少次更新，并将多个源变更批量合并为一次更新，而无需为每个变更单独付费。基于推送触发的自动化在每月之间可能差异更大，因为它们取决于内容或代码变更的频率。 +为 cron 任务安排在特定时间运行可以让你更精确地控制积分使用量。例如，让自动化每天或每周运行一次，以限定它每月最多能进行多少次更新。定时安排还会将多个源变更批量合并为一次更新，因此你无需为每个变更单独付费。基于推送触发的自动化在每月之间可能差异更大，因为它们取决于内容或代码变更的频率。
## 审查并改进自动化结果 diff --git a/zh/help-center/configure-oauth-with-auth0.mdx b/zh/help-center/configure-oauth-with-auth0.mdx index bb6f65b1c..780b9784a 100644 --- a/zh/help-center/configure-oauth-with-auth0.mdx +++ b/zh/help-center/configure-oauth-with-auth0.mdx @@ -51,7 +51,7 @@ OAuth 2.0 身份验证在 Enterprise 方案中可用。 - **令牌声明（推荐）。** 使用 [Auth0 Action](https://auth0.com/docs/customize/actions) 在 ID 令牌或访问令牌中添加 groups 声明，并配置 Mintlify 读取它。参见[使用 OAuth 令牌声明中的用户组](/zh/deploy/authentication-setup#use-groups-from-oauth-token-claims)。如果你从 ID 令牌中获取用户组，请在 scopes 中保留 `openid`。 - **Info API URL。** 让 Mintlify 指向 `https://YOUR_AUTH0_DOMAIN/userinfo` 或你自己的端点，该端点需按[用户数据格式](/zh/deploy/authentication-setup#user-data-format)返回用户数据。端点必须接受 `Authorization: Bearer `，并在响应中返回用户组。 -然后为页面或导航分组标记匹配的 `groups` 值，这样只有属于该分组的成员才能看到它们。 +然后在你想限制访问的每个页面的 frontmatter 中添加匹配的 `groups` 值，这样只有属于该分组的成员才能看到它。
## 疑难解答 diff --git a/zh/help-center/tailwind-classes-not-applying-in-editor-preview.mdx b/zh/help-center/tailwind-classes-not-applying-in-editor-preview.mdx index fab9192c1..b5f350853 100644 --- a/zh/help-center/tailwind-classes-not-applying-in-editor-preview.mdx +++ b/zh/help-center/tailwind-classes-not-applying-in-editor-preview.mdx @@ -1,6 +1,6 @@ --- title: "Tailwind 类在编辑器实时预览中不生效" -description: "诊断为什么使用 Tailwind CSS 类设置样式的页面（例如自定义模式的落地页）在 Web 编辑器的实时预览中看起来没有样式，但在部署环境和 mint dev 中能正常渲染。" +description: "Web 编辑器的实时预览会跳过为 Tailwind 类生成 CSS 的构建步骤。请使用 mint dev 或预览部署检查样式。" keywords: ["tailwind 不生效", "tailwind 类未应用", "自定义页面显示异常", "编辑器预览无样式", "实时预览缺少样式", "自定义模式没有样式"] --- diff --git a/zh/search-index/connect.mdx b/zh/search-index/connect.mdx index e6d91973e..29a9ebb46 100644 --- a/zh/search-index/connect.mdx +++ b/zh/search-index/connect.mdx @@ -83,7 +83,7 @@ npx mint index --claude --cursor - 1. 使用 Command + Shift + P（Windows 上为 Ctrl + Shift + P）打开命令面板。 + 1. 使用 Cmd + Shift + P（Windows 上为 Ctrl + Shift + P）打开命令面板。 2. 搜索**打开 MCP 设置**。 3. 选择**添加自定义 MCP**，打开 `mcp.json`。