Revisar cambios
Previsualice los cambios antes de publicarlos, compártalos con su equipo, solicite revisión y haga merge de pull requests desde el editor.
Previsualice sus cambios antes de que lleguen a su sitio publicado, solicite revisión sobre su pull request y haga merge desde el editor.
La vista previa en vivo representa su sitio mientras edita, sin ningún paso de compilación. En la pestaña Site, haga clic en Preview en la barra superior. La vista previa se abre a pantalla completa. Haga clic en Refresh preview para recargarla, o en Close preview para volver al editor. Para abrir la vista previa en una pestaña nueva del navegador, active Open live preview in new tab.
Para editar la configuración del sitio y ver cómo afecta a su contenido, haga clic en Site settings en la barra de herramientas de la vista previa y seleccione una sección de configuración.
Para abrir el agente junto a la vista previa, haga clic en Ask agent en la barra de herramientas de la vista previa. Solo los editors y admins pueden usar el agente en las vistas previas en vivo.
La vista previa en vivo solo está disponible en sitios públicos y en sitios protegidos con la autenticación de Mintlify.
Cuando su feature branch tiene una pull request, Mintlify compila un despliegue de vista previa: una URL temporal donde sus cambios se representan exactamente como se verán al publicarse. La vista previa se vuelve a compilar cada vez que el editor hace commit de cambios nuevos en la branch. La URL combina el subdominio de su proyecto y el nombre de la branch: <subdomain>-<branch-name>.mintlify.site. Encuentre la URL exacta en el comentario de la pull request del bot de Mintlify.
Las URLs de vista previa son accesibles públicamente de forma predeterminada. Para restringir el acceso a los miembros de su organización de Mintlify, active la autenticación de vistas previas en la sección Previews de la página General de su dashboard. Consulte Restringir el acceso a los despliegues de vista previa para más información.
| Función | Vista previa en vivo | Despliegue de vista previa |
|---|---|---|
| Velocidad | Instantánea | Requiere una compilación |
| Acceso | Dentro del editor | URL para compartir |
| Úsela cuando | Revise cambios mientras edita | Comparta con su equipo para revisión |
| Disponibilidad | Mientras el editor está abierto | Mientras exista la branch |
Para dirigir a un compañero a una página concreta de una branch, haga clic en More options en la esquina superior derecha de la página y luego en Copy link. Cualquier persona con acceso a su organización de Mintlify puede abrir el enlace en su propia sesión del editor.
Cuando su branch tiene una pull request, el menú de publicación muestra sus archivos modificados y el estado de revisión, como Draft in progress, Review required, Changes requested o Approved. Haga clic en View request para abrir la pull request en su proveedor de Git.
- Haga clic en Publish en la barra superior y luego en Request review. Esto marca la pull request como lista para revisión.
- Los revisores aprueban la pull request en su proveedor de Git.
- Haga clic en Publish y luego en Merge and publish. El editor hace merge de la pull request, despliega sus cambios y le devuelve a su deployment branch.
Si Mintlify aloja su repositorio y no se requieren aprobaciones, el menú de publicación muestra Publish en su lugar, que hace merge y despliega en un solo paso.
Configure reglas de protección de branch en su proveedor de Git para exigir pull requests. Consulte About protected branches en la ayuda de GitHub o Protected branches en la ayuda de GitLab.
Haga clic en cualquier archivo modificado del menú de publicación para abrirlo en la vista de diff frente a la versión publicada. Para salir de la vista de diff, haga clic en Viewing changes en la barra superior o presione Cmd + Shift + D (macOS) o Ctrl + Shift + D (Windows). El modo visual muestra un diff visual y el modo source muestra un diff de texto. Los archivos que no pueden mostrar un diff, como las imágenes o los archivos eliminados, aparecen en la lista pero no se pueden abrir.
Las páginas ocultas que aparecen en el diff de la branch se pueden abrir desde el menú de publicación, aunque no figuren en la navegación de su sitio.
El título de la pull request proviene del título de su branch.
Si su branch tiene hilos de comentarios abiertos, Mintlify añade un resumen de estos a la descripción de la pull request. Consulte Colaborar.
Cuando una automatización abre una pull request, puede abrir el editor en la branch de la automatización:
- Desde una notificación de Slack o un correo de notificación, haga clic en View changes. El editor se abre en la branch de la automatización en la vista de diff, y el agente se abre junto a él con contexto sobre lo que hizo la automatización.
- Desde la pestaña Runs de la página de Automatizaciones en su dashboard, abra el menú de acciones de una ejecución y seleccione Open in editor.
Para abrir en su lugar el despliegue de vista previa de la automatización, haga clic en Preview en la ejecución.