Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions es/api-playground/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -62,15 +62,16 @@ Si sus páginas de la API no se muestran correctamente, revise estos problemas d
</Accordion>

<Accordion title="Las solicitudes del área de pruebas de la API no funcionan">
Si tienes un domain personalizado configurado, esto podría deberse a un problema con tu proxy inverso. De forma predeterminada, las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la
Si tienes un domain personalizado configurado, esto podría deberse a un problema con tu proxy inverso. De forma predeterminada,
las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la
ruta `/_mintlify/api/request` en el sitio de documentación. Si tu proxy inverso está configurado para permitir únicamente solicitudes `GET`
entonces todas estas solicitudes fallarán. Para solucionarlo, configura tu proxy inverso para
permitir solicitudes `POST` a la ruta `/_mintlify/api/request`.

Como alternativa, si tu proxy inverso impide aceptar solicitudes `POST`, puedes configurar Mintlify para enviar solicitudes directamente a tu backend con el ajuste `api.playground.proxy` en el `docs.json`, como se describe en la [documentación de configuración](/es/organize/settings#param-proxy). Al usar esta configuración, deberás configurar CORS en tu servidor, ya que las solicitudes llegarán directamente desde los navegadores de los usuarios en lugar de pasar por tu proxy.
</Accordion>

<Accordion title="Las entradas de navigation de OpenAPI no están generando páginas">
<Accordion title="Las entradas de navigation de OpenAPI no generan páginas">
Si usas una configuración de navigation de OpenAPI, pero las páginas no se generan, revisa estos problemas comunes:

1. **Falta la especificación de OpenAPI predeterminada**: Asegúrate de tener definido un campo `openapi` en el elemento de navigation:
Expand Down Expand Up @@ -98,14 +99,14 @@ Si sus páginas de la API no se muestran correctamente, revise estos problemas d
<Accordion title="Algunas operaciones de OpenAPI aparecen en navigation, pero otras no">
1. **Operaciones ocultas**: Las operaciones marcadas con `x-hidden: true` en tu especificación de OpenAPI no aparecerán en la navigation generada automáticamente.
2. **Operaciones no válidas**: Las operaciones con errores de validación en la especificación de OpenAPI pueden omitirse. Revisa tu documento de OpenAPI para detectar errores de sintaxis.
3. **Inclusión manual vs. automática**: Si haces referencia a endpoints de una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecerán en la navigation. No se agregarán otras páginas automáticamente. Esto incluye operaciones referenciadas en elementos secundarios de la navigation.
3. **Inclusión manual vs. automática**: Si haces referencia a endpoints de una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecen en la navigation. No se agregan otras páginas automáticamente. Esto incluye operaciones referenciadas en elementos secundarios de la navigation.
</Accordion>

<Accordion title="La navigation combinada (páginas de OpenAPI y MDX) no funciona correctamente">
Al combinar operaciones de OpenAPI con páginas de documentación estándar en navigation:

1. **Conflictos de archivos**: No puedes tener a la vez un archivo `MDX` y una entrada en navigation para la misma operación. Por ejemplo, si tienes `get-users.mdx`, no incluyas también `"GET /users"` en tu navigation. Si necesitas un archivo que comparta nombre con una operación, usa la extensión `x-mint` del endpoint para que el href apunte a otra ubicación.
2. **Resolución de rutas**: Las entradas en navigation que no coincidan con operaciones de OpenAPI se tratarán como rutas de archivo. Asegúrate de que tus archivos `MDX` existan en las ubicaciones esperadas.
3. **Distinción entre mayúsculas y minúsculas**: La coincidencia de operaciones de OpenAPI distingue mayúsculas y minúsculas. Asegúrate de que los métodos HTTP estén en mayúsculas en las entradas de navigation.
2. **Resolución de rutas**: Las entradas en navigation que no coincidan con operaciones de OpenAPI se tratan como rutas de archivo. Asegúrate de que tus archivos `MDX` existan en las ubicaciones esperadas.
3. **Distinción entre mayúsculas y minúscculas**: La coincidencia de operaciones de OpenAPI distingue mayúsculas y minúsculas. Asegúrate de que los métodos HTTP estén en mayúsculas en las entradas de navigation.
</Accordion>
</AccordionGroup>
8 changes: 5 additions & 3 deletions es/components/mermaid-diagrams.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -48,13 +48,14 @@ Para ver la lista completa de tipos de diagramas compatibles y su sintaxis, cons
```
````


<div id="elk-layout-support">
## Compatibilidad con diseño ELK
## Compatibilidad con el diseño ELK
</div>

Mintlify es compatible con el motor de diseño [ELK (Eclipse Layout Kernel)](https://www.eclipse.org/elk/) para diagramas de Mermaid. ELK optimiza la disposición para reducir superposiciones y mejorar la legibilidad, lo cual es útil para diagramas grandes o complejos.
Mintlify es compatible con el motor de diseño [ELK (Eclipse Layout Kernel)](https://www.eclipse.org/elk/) para diagramas Mermaid. ELK optimiza la disposición para reducir solapamientos y mejorar la legibilidad, lo cual es especialmente útil para diagramas grandes o complejos.

Para usar el diseño ELK en tus diagramas de Mermaid, agrega la directiva `%%{init: {'flowchart': {'defaultRenderer': 'elk'}}}%%` al comienzo de tu diagrama:
Para utilizar el diseño ELK en tus diagramas Mermaid, añade la directiva `%%{init: {'flowchart': {'defaultRenderer': 'elk'}}}%%` al principio de tu diagrama:

````mdx ELK layout example
```mermaid
Expand All @@ -68,6 +69,7 @@ flowchart LR
```
````


<div id="interactive-controls">
## Controles interactivos
</div>
Expand Down
2 changes: 1 addition & 1 deletion es/customize/custom-404-page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,5 +42,5 @@ Configura la página 404 en la sección `errors.404` de tu archivo `docs.json`:
</ResponseField>

<ResponseField name="description" type="string">
Descripción personalizada para la página de error 404. Admite formato Markdown.
Descripción personalizada para la página de error 404. Admite formato MDX, incluidos enlaces, texto en negrita y en cursiva, y componentes personalizados.
</ResponseField>
4 changes: 2 additions & 2 deletions es/deploy/ci.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -437,7 +437,7 @@ Este texto es ignorado por Vale
Vale reconoce y respeta automáticamente estos comentarios en los archivos MDX sin necesidad de configuración adicional. Usa los comentarios para omitir líneas o secciones que el linter deba ignorar.

<Warning>
No coloques `{/* vale off */}` u otros comentarios de expresión MDX similares como hijos directos de un componente JSX entre elementos hermanos. Por ejemplo, entre dos elementos `<Step>` dentro de un componente `<Steps>`.
No coloques `{/* vale off */}` o comentarios de expresión MDX similares como hijos directos de un componente JSX entre elementos hermanos. Por ejemplo, entre dos elementos `<Step>` dentro de un componente `<Steps>`.

Coloca los comentarios dentro del contenido de un elemento específico o reestructura el contenido para evitar la necesidad de comentarios.
</Warning>
4 changes: 2 additions & 2 deletions es/editor/keyboard-shortcuts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -69,9 +69,9 @@ Usa estos atajos de teclado al editar en modo visual.
### Sustituciones inteligentes
</div>

El editor convierte automáticamente ciertas secuencias de caracteres en símbolos tipográficos mientras escribes. El editor omite las sustituciones dentro de bloques de código y código en línea.
El editor convierte automáticamente ciertas secuencias de caracteres en símbolos tipográficos a medida que escribes. El editor omite las sustituciones en los bloques de código y en el código en línea.

| Escribe | Resultado |
| Tipo | Resultado |
| :--- | :--- |
| `->` | → |
| `<-` | ← |
Expand Down
2 changes: 1 addition & 1 deletion es/guides/understand-your-audience.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,4 +45,4 @@ Hablar directamente con usuarios ayuda a anclar tu redacción en su perspectiva,
2. **Incorpora mecanismos de retroalimentación.** Ya sea con pulgares arriba/abajo o campos de texto simples, ofrece a los usuarios la oportunidad de enviar comentarios mientras leen tu documentación.
3. **Usa Analytics para guiarte.** Revisa los comentarios y las conclusiones para entender dónde tienen dificultades los usuarios y dónde tienen éxito. Actualiza la documentación con la que la gente tiene problemas o la más directamente relacionada con las tareas clave de tu producto.

Siempre habrá casos extremos que no estén cubiertos por tu documentación. Prioriza las páginas de mayor impacto para ayudar al mayor número de personas. Un exceso de contenido se vuelve difícil de navegar y mantener, por lo que intentar documentar todos los escenarios posibles puede ser contraproducente.
Los casos extremos que no están cubiertos por tu documentación siempre existen. Prioriza las páginas de mayor impacto para ayudar al mayor número de personas. Un exceso de contenido se vuelve difícil de navegar y mantener, por lo que intentar documentar todos los escenarios posibles puede ser contraproducente.
2 changes: 1 addition & 1 deletion es/guides/windsurf.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ El assistant Cascade de IA de Windsurf se puede ajustar para redactar documentac
* **Reglas del espacio de trabajo**: se almacenan en tu repositorio de documentación y se comparten con tu equipo.
* **Memorias**: proporcionan contexto individual que se acumula con el tiempo.

Recomendamos configurar reglas del espacio de trabajo para unificar los estándares de documentación. Puedes desarrollar memorias a medida que trabajas, pero como no se comparten, no serán consistentes entre los miembros del equipo.
Recomendamos configurar reglas del espacio de trabajo para unificar los estándares de documentación. Puedes desarrollar memorias a medida que trabajas, pero como no se comparten, no son consistentes entre los miembros del equipo.

Crea reglas del espacio de trabajo en el directorio `.windsurf/rules` de tu repositorio de documentación. Consulta [Memories &amp; Rules](https://docs.windsurf.com/windsurf/cascade/memories) en la documentación de Windsurf para obtener más información.

Expand Down
2 changes: 1 addition & 1 deletion es/installation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -306,7 +306,7 @@ Si usas JetBrains, recomendamos el [plugin MDX para IntelliJ IDEA](https://plugi
<Accordion title="Error: permiso denegado">
Esto se debe a no tener los permisos necesarios para instalar paquetes de Node de forma global.

**Solución**: Intenta ejecutar `sudo npm i -g mint`. Se te pedirá tu contraseña, la misma que usas para desbloquear tu computadora.
**Solución**: Intenta ejecutar `sudo npm i -g mint`. Cuando se te solicite, introduce la contraseña que usas para desbloquear tu computadora.
</Accordion>

<Accordion title="La vista previa local no se ve igual que mi documentación en la web">
Expand Down
12 changes: 6 additions & 6 deletions es/integrations/analytics/adobe.mdx
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
---
title: "Adobe Analytics"
description: "Realiza un seguimiento del uso de la documentación con Adobe Analytics a través de Adobe Experience Platform Launch."
keywords: ["Adobe Analytics", "Adobe Launch", "Adobe Experience Platform", "site analytics"]
keywords: ["Adobe Analytics", "Adobe Launch", "Adobe Experience Platform", "analítica del sitio"]
---

Agrega lo siguiente a tu archivo `docs.json` para enviar analytics a Adobe Analytics.
Agrega lo siguiente a tu archivo `docs.json` para enviar datos de Analytics a Adobe Analytics.

<CodeGroup>

```json Analytics options in docs.json
```json Opciones de Analytics en docs.json
"integrations": {
"adobe": {
"launchUrl": "required"
}
}
```

```json Example
```json Ejemplo
"integrations": {
"adobe": {
"launchUrl": "https://assets.adobedtm.com/launch-EN93497c30fdf0424eb678d5f4ffac66dc.min.js"
Expand All @@ -27,9 +27,9 @@ Agrega lo siguiente a tu archivo `docs.json` para enviar analytics a Adobe Analy
</CodeGroup>

<div id="get-your-launch-url">
## Obtén tu URL de Launch
## Obtén la URL de Launch
</div>

1. Inicia sesión en [Adobe Experience Platform Data Collection](https://experience.adobe.com/#/data-collection/).
2. Abre tu propiedad de Launch y ve a la pestaña **Environments**.
3. Copia la URL del script de tu entorno de producción.
3. Copia la URL del script de tu entorno de producción.
2 changes: 1 addition & 1 deletion es/integrations/analytics/google-analytics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Añade tu Measurement ID a tu archivo `docs.json` de la siguiente manera:

Google Analytics tarda entre dos y tres días en mostrar tus datos.

Puedes usar el [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) para comprobar que Analytics está habilitado correctamente. La extensión registrará en la consola de tu navegador cada vez que GA4 haga una solicitud.
Puedes usar el [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) para comprobar tu configuración de Analytics. La extensión registra en la consola de tu navegador cada vez que GA4 hace una solicitud.

<Note>

Expand Down
33 changes: 16 additions & 17 deletions es/integrations/analytics/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ keywords: ["third-party analytics", "engagement tracking", "analytics platforms"

Realiza un seguimiento de cómo los usuarios interactúan con tu documentación conectando plataformas de Analytics de terceros. Mintlify envía eventos de interacción a los proveedores de Analytics que hayas configurado.

<div id="how-analytic-integrations-work">
## Cómo funcionan las integraciones de analítica
<div id="how-analytics-integrations-work">
## Cómo funcionan las integraciones de Analytics
</div>

Cuando agregas integraciones de Analytics a tu sitio de documentación, Mintlify registra interacciones de los usuarios como vistas de página, consultas de búsqueda, solicitudes en el área de pruebas de la API y envíos de comentarios, y las envía a tus proveedores de Analytics. Puedes conectar cualquier cantidad de proveedores de Analytics compatibles agregando tus claves de API al archivo `docs.json`. Los eventos de Analytics se envían a tus proveedores tan pronto como los agregas a tu configuración, sin necesidad de configuración adicional.
Expand All @@ -22,18 +22,18 @@ Cuando agregas integraciones de Analytics a tu sitio de documentación, Mintlify
href="/es/integrations/analytics/adobe"
horizontal
icon={
<svg
className="h-6 w-6"
width="16"
height="16"
viewBox="0 0 133 118"
fill="none"
xmlns="http://www.w3.org/2000/svg"
>
<rect width="133" height="118" fill="#fff"/>
<path fill="#FA0F00" d="m0,0v118L49,0m35,0 49,118V0M67,44l32,74H78L68,94H45" />
</svg>
}
<svg
className="h-6 w-6"
width="16"
height="16"
viewBox="0 0 133 118"
fill="none"
xmlns="http://www.w3.org/2000/svg"
>
<rect width="133" height="118" fill="#fff"/>
<path fill="#FA0F00" d="m0,0v118L49,0m35,0 49,118V0M67,44l32,74H78L68,94H45" />
</svg>
}
/>

<Card
Expand Down Expand Up @@ -640,7 +640,6 @@ Configura las credenciales de tu proveedor de Analytics en el objeto `integratio
}
```


<div id="example-configuration">
### Ejemplo de configuración
</div>
Expand Down Expand Up @@ -678,7 +677,7 @@ Todos los eventos de seguimiento utilizan el prefijo `docs.`.
| `docs.content.md.view` | Cuando un usuario ve la versión en Markdown de una página. |
| `docs.navitem.click` | Cuando un usuario hace clic en un elemento de navegación del encabezado. |
| `docs.navitem.cta_click` | Cuando un usuario hace clic en un botón de llamada a la acción. |
| `docs.footer.powered_by_mintlify_click` | Cuando un usuario hace clic en el enlace "Powered by Mintlify". |
| `docs.footer.powered_by_mintlify_click` | Cuando un usuario hace clic en el enlace &quot;Powered by Mintlify&quot;. |

<div id="search">
### Búsqueda
Expand Down Expand Up @@ -721,7 +720,7 @@ Todos los eventos de seguimiento utilizan el prefijo `docs.`.
| `docs.assistant.completed` | Cuando se completa una sesión de chat. |
| `docs.assistant.source_click` | Cuando un usuario hace clic en una cita en una respuesta de chat. |
| `docs.assistant.suggestion_click` | Cuando un usuario hace clic en una pregunta sugerida. |
| `docs.assistant.ask_ai_on_text_selection` | Cuando un usuario selecciona texto y hace clic en "Ask AI". |
| `docs.assistant.ask_ai_on_text_selection` | Cuando un usuario selecciona texto y hace clic en &quot;Ask AI&quot;. |
| `docs.assistant.shared` | Cuando un usuario comparte una conversación de chat. |
| `docs.assistant.thumbs_up` | Cuando un usuario hace clic en el botón de comentarios positivos en una respuesta del Asistente de IA. |
| `docs.assistant.thumbs_down` | Cuando un usuario hace clic en el botón de comentarios negativos en una respuesta del Asistente de IA. |
Expand Down
9 changes: 5 additions & 4 deletions es/organize/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -927,10 +927,11 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>
</Expandable>
</ResponseField>
<ResponseField name="spec" type="object">
Configuraciones para la especificación OpenAPI.

<Expandable title="Spec">
<ResponseField name="especificación" type="object">
Configuración para la especificación OpenAPI.

<Expandable title="Especificación">
<ResponseField name="download" type="boolean">
Indica si se muestra un botón de descarga para la especificación OpenAPI en las páginas de referencia de la API. El valor predeterminado es `false`.
</ResponseField>
Expand Down Expand Up @@ -1246,7 +1247,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="description" type="string">
Descripción personalizada para la página de error 404. Admite formato MDX básico, incluyendo enlaces, texto en negrita y en cursiva. No se admiten componentes personalizados.
Descripción personalizada para la página de error 404. Admite formato MDX, incluyendo enlaces, texto en negrita, en cursiva y componentes personalizados.
</ResponseField>
</Expandable>
</ResponseField>
Expand Down
2 changes: 1 addition & 1 deletion es/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -161,7 +161,7 @@ Encuentra tu URL exacta en la página **Overview** de tu [Dashboard de Mintlify]
</div>

<Card title="Usar el editor web" icon="mouse-pointer-2" horizontal href="/es/editor/index">
Edita la documentación en tu navegador y obtén una vista previa de cómo se verán tus páginas al publicarlas.
Edita la documentación en tu navegador y obtén una vista previa de cómo se ven tus páginas al publicarlas.
</Card>

<Card title="Explorar comandos de la CLI" icon="terminal" horizontal href="/es/installation">
Expand Down
Loading