Saltar al contenido principal
Las implementaciones de vista previa están disponibles en los planes Pro y Custom.
Las implementaciones de vista previa te permiten ver cómo se verán los cambios en tu documentación antes de fusionarlos en producción. Cada vista previa crea una URL para compartir que se actualiza automáticamente a medida que haces push de nuevos cambios. De forma predeterminada, las URLs de vista previa son públicas. Comparte un enlace de vista previa con quien necesite revisar tus cambios.

Crear implementaciones de vista previa

Las implementaciones de vista previa se crean automáticamente mediante solicitudes de extracción o manualmente desde tu dashboard.

Vistas previas automáticas

Las vistas previas automáticas solo se crean para las solicitudes de extracción dirigidas a tu rama de implementación.
Cuando creas una solicitud de extracción, el bot de Mintlify agrega automáticamente un enlace para ver la implementación de la vista previa en tu solicitud de extracción. La vista previa se actualiza cada vez que haces push de nuevas confirmaciones a la rama.
Enlace para ver la implementación en la línea de tiempo de la solicitud de extracción

Vistas previas manuales

Puedes crear manualmente una vista previa para cualquier branch.
  1. Ve a tu dashboard.
  2. Selecciona Previews.
  3. Selecciona Create custom preview.
  4. Ingresa el nombre del branch que quieres previsualizar.
  5. Selecciona Create deployment.

Volver a implementar una vista previa

Vuelve a implementar una vista previa para actualizar el contenido o intentarlo de nuevo después de una implementación fallida.
  1. Selecciona la vista previa en tu dashboard.
  2. Selecciona Volver a implementar.
El menú Previews con el botón de implementación resaltado con un rectángulo naranja.

Restringir el acceso a las implementaciones de vista previa

De forma predeterminada, las implementaciones de vista previa son accesibles públicamente para cualquiera que tenga la URL. Puedes restringir el acceso a los miembros autenticados de tu organización en Mintlify.
  1. Ve a la sección Previews en la página de Add-ons de tu dashboard.
  2. Haz clic en el interruptor Preview authentication para habilitar o deshabilitar la autenticación de la vista previa.
El interruptor de autenticación de vista previa en la página Add-ons

Solución de problemas de despliegues de vista previa

Si tu despliegue de vista previa falla, prueba estos pasos de solución de problemas.
  • Ver los registros de compilación: En tu dashboard, ve a Previews y haz clic en la vista previa fallida. Los registros del despliegue muestran los errores que provocaron el fallo.
  • Revisar tu configuración:
    • Sintaxis no válida en docs.json
    • Rutas de archivos que faltan o son incorrectas en tu navegación
    • Frontmatter no válido en archivos MDX
    • Enlaces de imágenes rotos o archivos de imagen inexistentes
  • Validar localmente: Ejecuta mint dev localmente para detectar errores de compilación antes de hacer push a tu repositorio.
  • Revisar cambios recientes: Revisa los commits más recientes en tu rama para identificar qué cambios hicieron que la compilación fallara.