Saltar al contenido principal
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.
Publish solo aparece cuando hay una página del sitio abierta. Las páginas privadas muestran Share en su lugar y nunca se publican. Los viewers no ven Publish. Si no hay un botón Publish en una página del sitio, su proyecto 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 Show teammates’ changes para ver los cambios de todos.Si aparece Request review en lugar de Publish en su deployment branch, su proyecto requiere revisión antes de publicar.

​
Cambios pendientes

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.

​
Qué ocurre cuando publica

  • Publish: Hace commit de sus cambios pendientes en su deployment branch y los despliega en su sitio publicado.
  • Request review: En una feature branch, abre una pull request para la branch, o marca su pull request en borrador como lista para revisión. En una deployment branch que requiere revisión, pide a sus compañeros que aprueben sus cambios en el editor.
  • 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. Si su proyecto requiere revisión antes de publicar, solo los admins pueden hacer merge en su deployment branch desde el editor.
  • 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 ya está publicando en la misma branch, su publicación espera en una cola y se inicia automáticamente cuando termina la de su compañero.
Su sitio publicado se actualiza después de que Mintlify compile y despliegue sus cambios. Esto suele tardar entre 30 segundos y unos minutos. El menú Publish muestra el progreso a medida que sus cambios se hacen commit, se compilan y se despliegan, y luego enlaza a la página publicada. Si la compilación falla, haga clic en View build log.

​
El MDX no válido bloquea la publicación

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.

​
Publicar cambios concretos

Cuando varias personas tienen cambios pendientes en su deployment branch, el ajuste Show teammates’ changes controla qué cambios enumera el menú Publish. Show teammates’ changes desactivado (predeterminado): El menú Publish enumera solo sus cambios en Your changes. Eso incluye los archivos que ha editado, los archivos editados por usted y por compañeros y los archivos sin autor registrado. Los demás cambios pendientes de sus compañeros no aparecen en el menú. Cada uno de sus cambios tiene una casilla, y todas aparecen seleccionadas de inicio. Desmarque las casillas de los cambios que quiera dejar fuera y luego haga clic en Publish. Solo se publican los cambios seleccionados. Si desmarca todas las casillas, el editor deshabilita Publish. Show teammates’ changes 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 seleccionar qué cambios publicar. Cada sección tiene su propio botón Discard, que se aplica solo a los cambios de esa sección. 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 selección de cambios para publicar solo se aplica en una deployment branch sin protecciones de branch. En las feature branches, la publicación incluye todos los cambios pendientes.
  • Si su deployment branch requiere revisión y su rol no puede publicar sin revisión, el menú Publish muestra solo sus propios cambios.
  • 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.

​
Trabajar en una branch

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:
  1. 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.
  2. Opcionalmente, escriba un título para su branch en Find a branch.
  3. 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, o en una branch con una pull request abierta, 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.

​
Gestionar branches

El menú de branches enumera su deployment branch, las branches que ha creado en el editor y las branches con pull requests abiertas o en borrador, incluidas las pull requests abiertas fuera del editor. Cada branch muestra el estado de su pull request. Para encontrar una branch fusionada o cerrada, o cualquier otra branch de su repositorio, búsquela por nombre. Para enumerar todas las branches sin buscar, active Mostrar todas las branches en los ajustes del editor. 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 y luego confirme. Renombrar cambia el título que se muestra en el editor y el título de la pull request. El nombre de la branch de Git no cambia. Eliminar una branch cierra su pull request y quita permanentemente la branch de su repositorio, junto con cualquier cambio no publicado que haya en ella. Los viewers no pueden renombrar ni eliminar branches.

​
Sub-branches

Si su repositorio está en GitHub, GitLab o Azure Repos, puede trabajar en una sub-branch: una branch cuya branch principal es una branch distinta de su deployment branch, como una feature branch para una actualización grande. Una branch se convierte en sub-branch cuando la crea en el editor mientras está en otra branch que no es la deployment branch, o cuando su pull request apunta a una branch que no es la deployment branch. El menú de branches enumera las sub-branches con pull requests abiertas o en borrador, incluidas las pull requests abiertas fuera del editor. Las pull requests de las sub-branches que crea en el editor apuntan a su deployment branch de forma predeterminada. Mientras la pull request de una sub-branch está abierta, el menú de publicación muestra dos botones en lugar de Publish o Merge and publish:
  • Publish to <deployment branch>: Hace merge de la sub-branch en su deployment branch y la despliega.
  • Merge into <parent branch>: Hace merge de la sub-branch en su branch principal. Su sitio publicado no cambia hasta que la branch principal se fusione en su deployment branch.
Si hace clic en el botón de una branch a la que la pull request aún no apunta, el editor primero cambia la branch de destino de la pull request en su proveedor de Git y luego hace merge. Si no se puede cambiar el destino, el editor muestra un error y no hace merge. Después del merge, el editor le cambia a la branch en la que hizo merge. La lista de cambios de la branch en el menú de publicación compara su sub-branch con la branch de destino actual de su pull request.

​
Mostrar el selector de branch

Si su deployment branch no tiene protecciones de branch, el editor oculta el selector de branch mientras trabaja en la deployment branch. Para mostrarlo, abra una página del sitio, 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.

​
Resolver conflictos

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.

​
Firma de commits

Firme los commits con su cuenta de GitHub autorizándola en la sección Integrations de su configuración de Perfil. Sin esa autorización, la GitHub App de Mintlify firma los commits hechos en el editor.

​
Publicación automática

Si su proyecto tiene activada la publicación automática, el editor hace commit en su deployment branch aproximadamente un minuto después de que deje de editar. El selector de branch y el botón Publish quedan ocultos. No hay estado pendiente ni paso de revisión. La publicación automática y Require review before publishing no pueden estar activadas a la vez. Si un admin activa una, la otra se desactiva.