diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx index b1a75dbff9..31a964a1a5 100644 --- a/ai/contextual-menu.mdx +++ b/ai/contextual-menu.mdx @@ -34,6 +34,7 @@ The contextual menu includes several pre-built options that you can enable by ad | **Connect to Cursor** | `cursor` | Installs your hosted MCP server in Cursor | | **Connect to VS Code** | `vscode` | Installs your hosted MCP server in VS Code | | **Connect to Devin** | `devin-mcp` | Installs your hosted MCP server in Devin | +| **Download API spec** | `download-spec` | Downloads your deployment's OpenAPI spec. If there are multiple specs, downloads them as a zip archive. Only appears on API reference pages. | | **Custom options** | Object | Add custom options to the contextual menu | @@ -64,7 +65,8 @@ Add the `contextual` field to your `docs.json` file and specify which options yo "mcp", "cursor", "vscode", - "devin-mcp" + "devin-mcp", + "download-spec" ] } } diff --git a/es/ai/contextual-menu.mdx b/es/ai/contextual-menu.mdx index b7847da170..a8907208f2 100644 --- a/es/ai/contextual-menu.mdx +++ b/es/ai/contextual-menu.mdx @@ -36,12 +36,17 @@ El menú contextual incluye varias opciones preconfiguradas que puedes habilitar | **Conectar con Cursor** | `cursor` | Instala tu servidor MCP alojado en Cursor | | **Conectar con VS Code** | `vscode` | Instala tu servidor MCP alojado en VS Code | | **Conectar con Devin** | `devin-mcp` | Instala tu servidor MCP alojado en Devin | +| **Descargar especificación de API** | `downloadApiSpec` | Descarga la especificación OpenAPI de tu despliegue. Si hay varias especificaciones configuradas, las descarga como un archivo zip. Solo aparece en páginas de referencia de API. | | **Opciones personalizadas** | Object | Agrega opciones personalizadas al menú contextual | El menú contextual expandido que muestra los elementos del menú Copiar página, Ver como Markdown, Abrir en ChatGPT y Abrir en Claude. + + La opción `downloadApiSpec` solo aparece en páginas de referencia de API (páginas cuyo frontmatter declara `api`, `openapi` o `asyncapi`). En despliegues con autenticación o autenticación de usuario habilitada, solo los lectores autenticados pueden descargar la especificación. + +
## Activar el menú contextual
@@ -65,7 +70,8 @@ Añade el campo `contextual` a tu archivo `docs.json` y especifica qué opciones "mcp", "cursor", "vscode", - "devin-mcp" + "devin-mcp", + "downloadApiSpec" ] } } diff --git a/fr/ai/contextual-menu.mdx b/fr/ai/contextual-menu.mdx index 21f6bfb719..6bf80f8787 100644 --- a/fr/ai/contextual-menu.mdx +++ b/fr/ai/contextual-menu.mdx @@ -36,12 +36,17 @@ Le menu contextuel comprend plusieurs options prédéfinies que vous pouvez acti | **Se connecter à Cursor** | `cursor` | Installe votre serveur MCP hébergé dans Cursor | | **Se connecter à VS Code** | `vscode` | Installe votre serveur MCP hébergé dans VS Code | | **Se connecter à Devin** | `devin-mcp` | Installe votre serveur MCP hébergé dans Devin | +| **Télécharger la spécification d'API** | `downloadApiSpec` | Télécharge la spécification OpenAPI de votre déploiement. Si plusieurs spécifications sont configurées, les télécharge dans une archive zip. N'apparaît que sur les pages de référence d'API. | | **Options personnalisées** | Objet | Ajoutez des options personnalisées au menu contextuel | Le menu contextuel développé affichant les éléments Copier la page, Afficher en Markdown, Ouvrir dans ChatGPT et Ouvrir dans Claude. + + L'option `downloadApiSpec` n'apparaît que sur les pages de référence d'API (pages dont le frontmatter déclare `api`, `openapi` ou `asyncapi`). Sur les déploiements avec authentification ou authentification utilisateur activée, seuls les lecteurs authentifiés peuvent télécharger la spécification. + +
## Activer le menu contextuel
@@ -65,7 +70,8 @@ Ajoutez le champ `contextual` à votre fichier `docs.json` et indiquez les optio "mcp", "cursor", "vscode", - "devin-mcp" + "devin-mcp", + "downloadApiSpec" ] } }