Publicar cambios
Publique cambios desde el editor en su sitio publicado. Las branches y las reglas de protección determinan qué ocurre cuando publica.
Sus cambios se guardan automáticamente mientras edita, pero solo llegan a su sitio publicado cuando los publica. Lo que ocurre al publicar depende de en qué branch trabaja y de si esa branch tiene protecciones de branch.
Si no hay un botón Publish en la barra de herramientas del editor, su deployment tiene activada la publicación automática y sus ediciones se publican automáticamente.
Si no hay un selector de branch, muestre el selector de branch.
Si solo ve sus propios cambios en el menú Publish, active la publicación granular para ver los cambios de todos.
En su deployment branch, el editor registra lo siguiente como cambios pendientes hasta que los publica:
- Ediciones de contenido en páginas
- Páginas nuevas o eliminadas
- Cambios en la estructura de navegación
- Archivos multimedia subidos
- Actualizaciones de configuración
Haga clic en Publish en la barra de herramientas para ver sus cambios pendientes. Haga clic en cualquier archivo modificado para compararlo con la versión publicada.
| Tipo de branch | Protección de branch | Acciones disponibles |
|---|---|---|
| Deployment branch | Ninguna | Publish directamente en su sitio publicado |
| Deployment branch | Requiere pull requests | Create branch para mover el trabajo a una branch nueva |
| Feature branch | Ninguna | Request review y luego Merge and publish |
| Feature branch | Protegida | Create branch para seguir editando en una branch nueva |
- Publish: Hace commit de sus cambios pendientes en su deployment branch y los despliega en su sitio publicado.
- Request review: Marca la pull request de la branch como lista para revisión.
- Merge and publish: Hace merge de la pull request en su deployment branch y la despliega. Está disponible una vez que la pull request está lista o aprobada, según los requisitos de revisión de su repositorio.
- Create branch: Crea una feature branch nueva cuando no puede publicar en la branch actual.
Solo puede realizarse una publicación a la vez por branch. Si un compañero publica en la misma branch, espere a que termine su publicación antes de volver a intentarlo.
Su sitio publicado se actualiza después de que Mintlify compile y despliegue sus cambios. Esto suele tardar entre 30 segundos y unos minutos. Consulte el estado del despliegue en su dashboard.
Si alguna página de su branch tiene MDX no válido, el editor deshabilita los botones Publish y Request review hasta que lo corrija. Pase el cursor sobre Publish para ver cuántas páginas tienen errores y luego abra cada página en el modo source para ver y corregir el error. Consulte Publish button disabled because of invalid MDX para más detalles.
Cuando varias personas tienen cambios pendientes en su deployment branch, el ajuste Granular publishing controla qué cambios muestra el menú Publish.
Granular publishing desactivado (predeterminado): El menú Publish muestra solo sus cambios. Eso incluye los archivos que ha editado, los archivos editados por usted y por compañeros y los archivos sin autor registrado. Publish y Discard all se aplican solo a esos cambios. Si sus compañeros tienen otros cambios pendientes, un aviso indica que sus cambios están ocultos.
Granular publishing activado: El menú Publish divide los cambios pendientes en Your changes y Modified by others. Sus cambios aparecen seleccionados de inicio, y los de los demás aparecen sin seleccionar. Use las casillas para elegir qué cambios publicar. Cada sección tiene su propio botón Discard.
Un icono de colaboradores marca los archivos que ha editado alguien distinto de usted. Pase el cursor sobre él para ver quién editó el archivo.
- La publicación granular solo se aplica en una deployment branch sin protecciones de branch. En las feature branches, la publicación incluye todos los cambios pendientes.
- Eliminar una carpeta elimina todas las páginas de su interior. Esas eliminaciones se publican juntas. No puede eliminar parcialmente una carpeta.
- Algunos cambios dependen entre sí, como una página y su entrada de navegación. Si su selección deja fuera un cambio del que depende un cambio seleccionado, la publicación falla con un error. Ajuste su selección para incluir la dependencia y vuelva a publicar.
Edite directamente en su deployment branch si no usa un flujo de revisión. Cree una branch si cada cambio pasa por una revisión antes de llegar a su sitio publicado.
Para crear una branch:
- Haga clic en el nombre de la branch en la barra de herramientas del editor. En su deployment branch, el nombre tiene una insignia Live.
- Opcionalmente, escriba un título para su branch en Find a branch.
- Haga clic en New branch.
Si no escribe un título, el editor nombra la branch con la fecha actual. Si tiene cambios pendientes al crear una branch, el editor le pregunta si quiere Bring them to this branch o Leave them behind. Su branch original conserva sus cambios pendientes en cualquier caso.
Las ediciones en una branch que ha creado en el editor se hacen commit en la branch automáticamente, aproximadamente 15 segundos después de que deje de editar. El primer commit abre una pull request contra su deployment branch. La pull request se abre como borrador si Create draft pull requests by default está activado.
Cuando sus cambios estén listos, haga clic en Publish y luego en Request review. Después de que su pull request cumpla los requisitos de revisión de su repositorio, haga clic en Merge and publish. El editor hace merge de la pull request y le devuelve a su deployment branch.
El menú de branches enumera su deployment branch y las branches con pull requests abiertas, incluidas las pull requests abiertas fuera del editor. Cada branch muestra el estado de su pull request. Para encontrar una branch fusionada o cerrada, búsquela por nombre.
Para renombrar o eliminar una branch, pase el cursor sobre ella en el menú de branches y haga clic en Rename branch o Delete branch. Eliminar una branch la quita permanentemente de su repositorio, junto con cualquier cambio no publicado que haya en ella.
Si su deployment branch no tiene protecciones de branch, el editor oculta el selector de branch mientras trabaja en la deployment branch. Para mostrarlo, haga clic en More options en la barra superior y active Branches. Esta preferencia se aplica solo a usted.
El selector de branch siempre aparece cuando su deployment branch tiene protecciones de branch o cuando trabaja en una feature branch.
Cuando alguien hace push a su repositorio desde fuera del editor, el editor hace merge de sus cambios en las páginas que tiene abiertas. Una notificación le indica cuántas actualizaciones se han aplicado.
Si un cambio remoto y su edición afectan a la misma parte de una página, el editor conserva ambas versiones y las resalta. Revise el contenido resaltado, conserve la versión que quiere y elimine la otra.
Firme los commits con su cuenta de GitHub autorizándola en la configuración de su cuenta. Sin esa autorización, la GitHub App de Mintlify firma los commits hechos en el editor.
Si su deployment tiene activada la publicación automática, el editor hace commit en su deployment branch poco después de que deje de escribir. El selector de branch y el botón Publish quedan ocultos. No hay estado pendiente ni paso de revisión.