Typemark Documentation

Ramas en el editor

Trabaja en una rama en el editor de Typemark, previsualízala y fusiónala cuando esté lista, sin tocar tu sitio en producción. Disponible en Pro y Enterprise.

Actualizado el 19 nov 20264 min de lectura

Crea una rama en el editor para los cambios que los lectores no deberían ver a medio hacer: una reescritura, una sección nueva, una nueva estructura. Los guardados en una rama se quedan en esa rama, tiene su propia vista previa, y tu sitio en producción solo cambia cuando se fusiona la rama. Las ramas están disponibles en Pro y Enterprise, siguen el plan del propietario del proyecto, y funcionan tanto para proyectos alojados por Typemark como para proyectos conectados a GitHub.

Crear una rama

  1. Abre el menú de ramas

    La barra superior del editor muestra la rama en la que estás, como main. Haz clic en ella.

  2. Crea la rama

    Elige Create branch…, escribe un nombre como rewrite-quickstart y haz clic en Create branch. Parte de la última versión de tu rama de despliegue.

  3. Edita

    El editor se recarga en la nueva rama. Una franja debajo de la barra superior indica en qué rama estás editando.

El nombre de una rama sigue las reglas de Git para nombres de rama, y no puede ser la rama de despliegue ni una rama que el proyecto ya tenga.

Para cambiar de rama, abre el mismo menú y elige una. Tu rama de despliegue es la marcada como (live). Typemark recuerda en qué rama estás para cada proyecto.

Qué ocurre en una rama

  • Los guardados van solo a la rama. Tu sitio en producción, sus páginas y su historial de publicaciones no cambian.
  • Todo lo del editor funciona en la rama: crear y reordenar páginas, subir imágenes y ediciones con IA en varias páginas.
  • Una página se guarda en la rama en la que se abrió. Una pestaña que dejaste abierta antes de cambiar de rama sigue guardando en su propia rama.
  • Quién está editando y el estado de la compilación son por rama, así que solo ves a las personas que están en la misma rama.
  • La configuración cambia el sitio en producción. Settings, el código personalizado y la conexión con GitHub siempre se aplican a la rama de despliegue, esté donde esté el editor.
  • En un proyecto conectado a GitHub, la rama se envía a GitHub como una rama con el mismo nombre. Los commits que alguien suba a esa rama en GitHub se incorporan la próxima vez que se compile su vista previa.
  • Las traducciones con IA no se ejecutan en las ramas. Una rama empieza con las traducciones del sitio en producción, y el selector de idioma no muestra el estado de la IA ni Re-translate allí.

Previsualizar la rama

Haz clic en Preview en la franja debajo de la barra superior para abrir la vista previa propia de la rama, en una dirección formada a partir del nombre de la rama:

https://acme-docs--rewrite-quickstart.typemark.dev

Funciona como una vista previa de pull request: un banner indica qué rama muestra, los buscadores no la indexan y las herramientas de IA no pueden leerla. A diferencia de las vistas previas de pull requests, la vista previa de una rama permanece hasta que se elimina la rama, sin importar cuánto tiempo pase sin cambios. El botón Preview de la barra superior sigue abriendo la página en tu sitio en producción.

Publicar tus cambios

Haz clic en Open pull request en la franja. Typemark envía la rama y abre un pull request hacia tu rama de despliegue, con el título "Docs changes from" seguido del nombre de la rama. La franja muestra entonces View pull request.

Revísalo y fusiónalo en GitHub. Al fusionarlo se publica el cambio, igual que cualquier push a la rama de despliegue. El pull request usa la vista previa de la rama, que se actualiza con cada guardado. La rama se queda en el editor después de cerrar el pull request, así que elimínala cuando termines.

El propietario del proyecto hace clic en Merge into seguido del nombre de la rama de despliegue, como Merge into main. Typemark fusiona la rama con un commit del propietario y recompila tu sitio en producción.

Si la rama y la rama de despliegue modificaron las mismas líneas, no se fusiona nada y el mensaje indica los archivos. Edita esos archivos en la rama para que coincidan con la versión en producción, y vuelve a fusionar.

Eliminar una rama

Haz clic en Delete branch en la franja y confirma. Se eliminan las ediciones de la rama, su vista previa y sus páginas en Typemark. Los cambios que ya se fusionaron en la rama de despliegue se conservan, y en un proyecto conectado la rama en GitHub también se conserva.

Quién puede hacer qué

AcciónQuién
Cambiar de rama y leerlasTodos en el proyecto
Crear una rama, guardar en ella, abrir un pull requestEditores y el propietario
Fusionar una rama, en un proyecto alojado por TypemarkEl propietario
Eliminar una ramaEl propietario, o quien la creó

Consulta Miembros del equipo para ver los roles.

Planes

Las ramas siguen el plan del propietario del proyecto. En Free, el botón de ramas de la barra superior muestra una etiqueta Pro y abre la página de facturación. Si el propietario pasa a Free, el editor vuelve a la rama de despliegue y las ramas no se pueden modificar, pero se conservan: si vuelves a mejorar el plan, todas siguen ahí.

Una rama que está abierta en el editor no puede convertirse en la rama de despliegue de tu sitio. Elimínala primero en el editor.