mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
15d9eaf50c
* docs: document download-pdf contextual menu option * Document contextual PDF download option (#6075) * Document contextual PDF download option * Tighten contextual PDF docs update * Remove contextual docs formatting change * add enterprise gate * add link in pdf-exports page * Update pdf-exports.mdx --------- Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> * docs: remove duplicate VS Code keyword in zh contextual menu frontmatter (#6082) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> * docs: translate contextual PDF download updates to es and fr (#6083) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> * docs: use sentence case for Expandable title in i18n guide (#6067) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> * docs: tighten slack agent description length for SEO (#6078) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> * docs: document download-pdf contextual menu option * Update ai/contextual-menu.mdx --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Leyland Yang <yangleyland@gmail.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
204 lines
9.4 KiB
Plaintext
204 lines
9.4 KiB
Plaintext
---
|
|
title: "Menú contextual"
|
|
description: "Agrega un menú contextual a tu documentación con integraciones de IA en un clic para ChatGPT, Claude, Perplexity y más."
|
|
keywords: ["Herramientas de IA", "ChatGPT", "Claude", "Perplexity", "MCP", "Grok", "Cursor", "vscode", "vs code", "Google AI Studio", "aistudio", "Devin", "Windsurf", "pdf"]
|
|
---
|
|
|
|
import { PreviewButton } from "/snippets/previewbutton.jsx"
|
|
import IconsRequired from "/snippets/es/icons-required.mdx";
|
|
|
|
El menú contextual ofrece acceso rápido a contenido optimizado con IA e integraciones directas con herramientas de IA populares. Cuando los usuarios seleccionan el menú contextual en cualquier página, pueden copiar contenido como contexto para herramientas de IA o abrir conversaciones en ChatGPT, Claude, Perplexity, Google AI Studio, Grok, Devin, Windsurf o una herramienta personalizada de su elección, con su documentación ya cargada como contexto.
|
|
|
|
<Tip>
|
|
Combina el menú contextual con tu archivo [`skill.md`](/es/ai/skillmd) alojado y tu [servidor MCP](/es/ai/model-context-protocol) para que los usuarios puedan instalar todas las capacidades de tu producto en sus herramientas de IA, no solo la página que están leyendo.
|
|
</Tip>
|
|
|
|
<div id="menu-options">
|
|
## Opciones del menú
|
|
</div>
|
|
|
|
El menú contextual incluye varias opciones preconfiguradas que puedes habilitar agregando su identificador a tu configuración.
|
|
|
|
| Opción | Identificador | Descripción |
|
|
| :------------------------------------------------- | :------------ | :------------------------------------------------------------------------------------ |
|
|
| **Copiar página** | `copy` | Copia la página actual como Markdown para pegarla como contexto en herramientas de IA |
|
|
| **Ver como Markdown** | `view` | Abre la página actual como Markdown |
|
|
| **Preguntar a assistant** | `assistant` | Abre el [assistant](/es/assistant/index) con la página actual como contexto |
|
|
| **Descargar PDF** | `download-pdf` | Descarga la página actual como PDF. Disponible en los [planes Enterprise](https://mintlify.com/pricing). |
|
|
| **Abrir en ChatGPT** | `chatgpt` | Crea una conversación en ChatGPT con la página actual como contexto |
|
|
| **Abrir en Claude** | `claude` | Crea una conversación en Claude con la página actual como contexto |
|
|
| **Abrir en Perplexity** | `perplexity` | Crea una conversación en Perplexity con la página actual como contexto |
|
|
| **Abrir en Grok** | `grok` | Crea una conversación en Grok con la página actual como contexto |
|
|
| **Abrir en Google AI Studio** | `aistudio` | Crea una conversación en Google AI Studio con la página actual como contexto |
|
|
| **Abrir en Devin** | `devin` | Crea una sesión de Devin con la página actual como contexto |
|
|
| **Abrir en Windsurf** | `windsurf` | Abre Windsurf Cascade con la página actual como contexto |
|
|
| **Copiar URL del servidor MCP** | `mcp` | Copia la URL de tu servidor MCP al portapapeles |
|
|
| **Copiar comando de instalación del servidor MCP** | `add-mcp` | Copia el comando `npx add-mcp` para instalar el servidor MCP |
|
|
| **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. |
|
|
| **Descargar PDF** | `download-pdf` | Descarga la página actual como un PDF |
|
|
| **Opciones personalizadas** | Object | Agrega opciones personalizadas al menú contextual |
|
|
|
|
<Frame>
|
|
<img src="/images/contextual-menu/contextual-menu.png" alt="El menú contextual expandido que muestra los elementos del menú Copiar página, Ver como Markdown, Abrir en ChatGPT y Abrir en Claude." />
|
|
</Frame>
|
|
|
|
<Note>
|
|
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.
|
|
</Note>
|
|
|
|
<div id="enabling-the-contextual-menu">
|
|
## Activar el menú contextual
|
|
</div>
|
|
|
|
Añade el campo `contextual` a tu archivo `docs.json` y especifica qué opciones quieres incluir.
|
|
|
|
```json
|
|
{
|
|
"contextual": {
|
|
"options": [
|
|
"copy",
|
|
"view",
|
|
"assistant",
|
|
"download-pdf",
|
|
"chatgpt",
|
|
"claude",
|
|
"perplexity",
|
|
"grok",
|
|
"aistudio",
|
|
"devin",
|
|
"windsurf",
|
|
"mcp",
|
|
"cursor",
|
|
"vscode",
|
|
"devin-mcp",
|
|
"downloadApiSpec",
|
|
"download-pdf"
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
<div id="display-location">
|
|
## Ubicación de visualización
|
|
</div>
|
|
|
|
De forma predeterminada, el menú contextual aparece en el encabezado de la página. Puedes configurarlo para que se muestre en la barra lateral de la tabla de contenidos mediante la opción `display`.
|
|
|
|
```json
|
|
{
|
|
"contextual": {
|
|
"options": ["copy", "view", "chatgpt", "claude"],
|
|
"display": "toc"
|
|
}
|
|
}
|
|
```
|
|
|
|
| Valor | Descripción |
|
|
|:------|:------------|
|
|
| `header` | Muestra las opciones en el menú contextual de la parte superior de la página (predeterminado) |
|
|
| `toc` | Muestra las opciones en la barra lateral de la tabla de contenidos |
|
|
|
|
<div id="adding-custom-options">
|
|
## Agregar opciones personalizadas
|
|
</div>
|
|
|
|
Crea opciones personalizadas en el menú contextual agregando un objeto al arreglo `options`. Cada opción personalizada requiere estas propiedades:
|
|
|
|
<ResponseField name="title" type="string" required>
|
|
El título de la opción.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="description" type="string" required>
|
|
La descripción de la opción. Se muestra debajo del título cuando el menú contextual se expande.
|
|
</ResponseField>
|
|
|
|
<IconsRequired />
|
|
|
|
<ResponseField name="href" type="string | object" required>
|
|
El href de la opción. Usa una cadena para enlaces simples o un objeto para enlaces dinámicos con parámetros de búsqueda.
|
|
|
|
<Expandable title="href object">
|
|
<ResponseField name="base" type="string" required>
|
|
La URL base de la opción.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="query" type="object" required>
|
|
Los parámetros de búsqueda de la opción.
|
|
|
|
<Expandable title="query object">
|
|
<ResponseField name="key" type="string" required>
|
|
La key del parámetro de búsqueda.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="value" type="string" required>
|
|
El value del parámetro de búsqueda. Mintlify reemplaza los siguientes marcadores de posición por los valores correspondientes:
|
|
|
|
* Usa `$page` para insertar el contenido de la página actual en Markdown.
|
|
* Usa `$path` para insertar la ruta de la página actual.
|
|
* Usa `$mcp` para insertar la URL del servidor MCP alojado.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
Ejemplo de opción personalizada:
|
|
|
|
```json {9-14} wrap
|
|
{
|
|
"contextual": {
|
|
"options": [
|
|
"copy",
|
|
"view",
|
|
"chatgpt",
|
|
"claude",
|
|
"perplexity",
|
|
{
|
|
"title": "Solicitar una funcionalidad",
|
|
"description": "Únete a la discusión en GitHub para solicitar una nueva funcionalidad",
|
|
"icon": "plus",
|
|
"href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
<div id="custom-option-examples">
|
|
### Ejemplos de opciones personalizadas
|
|
</div>
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="Enlace simple">
|
|
```json
|
|
{
|
|
"title": "Solicitar una función",
|
|
"description": "Únete a la conversación en GitHub",
|
|
"icon": "plus",
|
|
"href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
|
|
}
|
|
```
|
|
</Accordion>
|
|
|
|
<Accordion title="Enlace dinámico con contenido de la página">
|
|
```json
|
|
{
|
|
"title": "Compartir en X",
|
|
"description": "Comparte esta página en X",
|
|
"icon": "x",
|
|
"href": {
|
|
"base": "https://x.com/intent/tweet",
|
|
"query": [
|
|
{
|
|
"key": "text",
|
|
"value": "Consulta esta documentación: $page"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
</Accordion>
|
|
</AccordionGroup> |