Saltar al contenido principal
Conecte un proyecto a un repositorio de GitLab. Los cambios van en ambos sentidos, y solo cuando hace clic en Sync: nada se sincroniza por sí solo.
Un administrador tiene que activar primero la sincronización con GitLab.
Esto se hace una sola vez.
1

Abrir la configuración de su cuenta

Haga clic en Account y luego en Account settings. En Project synchronisation, busque GitLab y haga clic en Link.
La sección GitLab de la configuración de la cuenta con un botón Link

GitLab en la configuración de la cuenta

2

Autorizar en GitLab

Se abre GitLab. Inicie sesión si se le pide y luego autorice la aplicación.
3

Comprobar el vínculo

Vuelve a la configuración de la cuenta. Un mensaje verde indica que su cuenta de GitLab está vinculada, y el botón ahora dice Unlink.
La sección GitLab de la configuración de la cuenta con un botón Unlink

Su cuenta de GitLab está vinculada

Si su cuenta aún no está vinculada, Import from GitLab y la tarjeta GitLab del editor le piden que la vincule primero. Haga clic en Link to your GitLab account. También llegará a la configuración de la cuenta, en una pestaña nueva si empezó en el editor. Después vuelva atrás y empiece de nuevo.
El diálogo Import from GitLab con un botón Link to your GitLab account

El aviso cuando su cuenta no está vinculada

Importar un repositorio

Esto crea un proyecto nuevo a partir de un repositorio de GitLab, ya vinculado a él.
1

Abrir el diálogo de importación

En la página de proyectos, haga clic en New project y luego en Import from GitLab.
El menú New project con Import from GitLab

El menú New project

2

Elegir el repositorio

Haga clic en Import to Overleaf junto al repositorio. La lista incluye sus repositorios y los de sus grupos.
El diálogo Import from GitLab con cuatro repositorios

Sus repositorios de GitLab

3

Comprobar el proyecto

El proyecto nuevo se abre con los archivos del repositorio.
El editor con el proyecto importado, sus archivos y el PDF compilado

El proyecto importado

Exportar un proyecto a un repositorio nuevo

Esto crea un repositorio a partir de un proyecto y los vincula. Un proyecto solo se puede vincular de esta forma o importándolo: no puede vincularlo a un repositorio que ya existe.
1

Abrir GitLab en el editor

Abra el proyecto. En la barra izquierda, haga clic en Integrations y luego en GitLab.
El panel Integrations con la tarjeta GitLab

El panel Integrations

2

Completar el repositorio

Elija el Owner, que puede ser usted o uno de sus grupos. Cuando elige un grupo, este campo se llama Organization. Repository Name empieza con el nombre del proyecto. La descripción es opcional y Private está seleccionado de forma predeterminada. Haga clic en Create a GitLab repository.
El formulario Export Project to GitLab completado

Export Project to GitLab

Si el nombre ya está en uso, el diálogo dice Please check that the repository name is valid, and that you have permission to create the repository. Cambie el nombre y vuelva a hacer clic en el botón.
3

Comprobar el vínculo

El diálogo ahora dice This project is linked to y nombra el repositorio.
El diálogo Sync with GitLab después de la exportación

El proyecto está vinculado

Sincronizar

1

Abrir el diálogo de sincronización

Abra un proyecto vinculado. En la barra izquierda, haga clic en Integrations y luego en GitLab.Recent commits in GitLab enumera lo que llegará al proyecto.
El diálogo Sync with GitLab con un commit nuevo

Un commit nuevo esperando en GitLab

2

Describir sus cambios

Si cambió algo en el proyecto, aparece un cuadro para el mensaje de commit. Es opcional: si lo deja vacío, el commit se llama Updates from Overleaf.
El diálogo Sync with GitLab con un mensaje de commit escrito

El mensaje de commit de sus cambios

3

Hacer clic en Sync

Haga clic en Sync. Los commits nuevos de GitLab llegan al proyecto, y sus cambios van a la rama predeterminada del repositorio. Si ambos lados cambiaron cosas distintas, se fusionan por usted.
4

Comprobar el resultado

El diálogo muestra No new commits in GitLab since last merge. y el cuadro del mensaje de commit desaparece. Los archivos del editor y los commits de GitLab están al día.
El diálogo Sync with GitLab después de sincronizar, sin commits nuevos

Todo está sincronizado

Si las mismas líneas cambiaron en ambos lados

El diálogo indica que los cambios no se pudieron fusionar y nombra una rama nueva, overleaf-YYYY-MM-DD-HHMMSS, que contiene sus cambios. Overleaf también abre una merge request desde esa rama en GitLab.
El diálogo Sync with GitLab con una advertencia de conflicto de fusión

Un conflicto

  1. Fusione esa rama en la rama predeterminada en GitLab o con Git. Mientras tanto puede cerrar el diálogo: muestra el mismo mensaje cuando lo vuelve a abrir.
  2. Haga clic en I have manually merged. Continue. El resultado fusionado llega al proyecto. Si hace clic antes de fusionar la rama, el diálogo no cambia.
  3. La rama permanece en GitLab, salvo que la haya eliminado al fusionar. Elimínela cuando ya no la necesite.
El mismo diálogo aparece cuando las reglas de fusión del repositorio retienen la merge request, por ejemplo porque necesita una aprobación, aunque no haya líneas en conflicto. Cuando la regla lo permita, fusione la merge request en GitLab y haga clic en I have manually merged. Continue. Consulte Cómo funciona la sincronización con GitLab. Hágalo cuando ya no quiera que el proyecto se sincronice.
1

Hacer clic en Unlink

En el diálogo de sincronización, haga clic en Unlink.
2

Confirmar

Haga clic en Confirm. Esto solo elimina el vínculo: la conexión a un repositorio de su propiedad, que menciona la advertencia, es una opción que tendrá después, no algo que ocurra ahora.
El diálogo Sync with GitLab pidiendo confirmar la desvinculación

Confirmar la desvinculación

3

Comprobar el resultado

El diálogo ahora muestra Export Project to GitLab. El proyecto y el repositorio conservan su contenido. Para volver a sincronizar, exporte el proyecto a un repositorio nuevo o importe el repositorio en un proyecto nuevo.
En Account settings, en GitLab, haga clic en Unlink y luego de nuevo en Unlink en el diálogo.
El diálogo Unlink GitLab Account

Desvincular su cuenta

Sus proyectos siguen vinculados a sus repositorios. No puede sincronizarlos hasta que vuelva a vincular su cuenta.
Para saber quién puede hacer qué en un proyecto compartido, consulte Quién puede vincular y sincronizar.
Última modificación el 20 de noviembre de 2026