> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Git

> Cree un token de acceso, clone un proyecto con Git y luego haga pull y push.

Trabaje en un proyecto desde su propio ordenador con Git. Los cambios solo se transfieren cuando ejecuta `git pull` o `git push`.

> [!NOTE]
>
> Un administrador tiene que activar primero la [integración con Git](https://ayakaleaf-pro.mintlify.site/es/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).

## Crear un token

Git inicia sesión con un token de autenticación de Git, no con la contraseña de su cuenta.

**1. Abrir la configuración de su cuenta**

Haga clic en **Account** y luego en **Account settings**. En **Git integration**, haga clic en **Generate token**. Una vez que tenga un token, este botón se llama **Add another token**.

![La sección Git integration de la configuración de la cuenta con un botón Generate token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-settings.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f4ff1f16eb46266f7bf31956bf3b9d89)

La integración con Git en la configuración de la cuenta

**2. Copiar el token**

Haga clic en **Copy** y guarde el token en un lugar seguro. Solo lo verá una vez. Luego haga clic en **Close**.

![El diálogo del token de autenticación de Git con un botón Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

Su nuevo token

**3. Comprobar el token**

La lista muestra ahora el comienzo del token, cuándo se creó y cuándo se usó por última vez. Caduca al cabo de un año. Puede tener hasta 10 tokens.

![La lista de tokens con un token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

Sus tokens

## Clonar un proyecto

**1. Abrir la integración con Git en el editor**

Abra el proyecto. En la barra izquierda, haga clic en **Integrations** y luego en **Git integration**.

![El panel Integrations con la tarjeta Git integration](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-panel.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=3fb82c63ba8d205191eadb5015bdefb5)

El panel Integrations

**2. Copiar el comando**

El diálogo **Clone with Git** muestra el comando, con la dirección de su sitio y el ID del proyecto. Haga clic en **Copy**. Si todavía no tiene un token, **Go to settings** abre la configuración de su cuenta en una pestaña nueva.

![El diálogo Clone with Git con el comando git clone](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-clone.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f6d69046df7caf4cbee07f49e8dd6540)

El comando de clonación

**3. Ejecutarlo**

Pegue el comando en una terminal. Cuando Git le pida una contraseña, pegue su token.

```text theme={null}
$ git clone https://git@<your-site>/git/<project-id>
Cloning into '<project-id>'...
Password for 'https://git@<your-site>': <your-token>
```

Una carpeta con el nombre del ID del proyecto contiene ahora los archivos del proyecto, en la rama `main`. Para elegir el nombre de la carpeta, añádalo al final del comando.

Git pide el token cada vez que se conecta con el sitio. Para que lo recuerde, active un credential helper: Git lo pide una vez más y después lo conserva. El helper `store` lo guarda sin cifrar en `~/.git-credentials`.

```bash theme={null}
git config --global credential.helper store
```

## Traer los cambios del editor

Dentro de la carpeta, ejecute:

```bash theme={null}
git pull
```

Git enumera los archivos que cambiaron. Los cambios hechos en el editor llegan como commits llamados `Update on Overleaf.`.

```text theme={null}
Updating db007e3..c3e6332
Fast-forward
 main.tex | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
```

## Enviar sus cambios

Haga commit de sus cambios y luego envíelos con push:

```bash theme={null}
git add main.tex
git commit -m "Add a line from Git"
git push
```

La última línea de la salida muestra la rama que avanzó:

```text theme={null}
   53aca61..db007e3  main -> main
```

Los cambios aparecen en el editor, y un editor abierto se actualiza solo. Los archivos nuevos, las carpetas y los cambios de nombre aparecen en el árbol de archivos. En **History**, su cambio aparece marcado como **You (via Git)**. Su mensaje de commit no se muestra allí.

![El historial del proyecto con la línea enviada, marcada como You (via Git)](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-history.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f4d5575612ebd75db3656cac1ea495)

Un push en el historial del proyecto

### Si Git rechaza su push

Si el proyecto cambió mientras tanto, Git rechaza el push:

```text theme={null}
 ! [rejected]        main -> main (fetch first)
```

Traiga primero esos cambios y luego vuelva a hacer push:

```bash theme={null}
git pull --no-rebase --no-edit
git push
```

Un `git pull` simple puede detenerse con `fatal: Need to specify how to reconcile divergent branches.` La opción `--no-rebase` de arriba lo resuelve: fusiona ambos lados.

Si las mismas líneas cambiaron en ambos lados, el pull se detiene con `CONFLICT (content): Merge conflict in main.tex`. Corrija el archivo y luego:

```bash theme={null}
git add main.tex
git commit -m "Merge the changes from the editor"
git push
```

Hay dos cosas que el sitio no acepta:

* Otras ramas: `! [remote rejected] feature -> feature (wrong branch)`. Solo existe `main`, así que envíe su trabajo allí.
* Force push: `! [remote rejected] main -> main (forced push prohibited)`. En su lugar, coloque sus cambios encima de la `main` actual.

### Si Git dice Authentication failed

```text theme={null}
remote: Enter your Git authentication token when prompted for a password.
fatal: Authentication failed for 'https://<your-site>/git/<project-id>/'
```

El token es incorrecto o se eliminó, o usted escribió la contraseña de su cuenta. Cree un token nuevo si ya no lo tiene, porque no puede volver a ver uno existente.

## Eliminar un token

En **Account settings**, en **Git integration**, haga clic en el icono de eliminar junto al token y luego en **Delete** en el diálogo. A partir de entonces, Git responde `Authentication failed` a ese token.

![El diálogo Delete Authentication token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-delete-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=1708062228778239c6465b0369614a18)

Eliminar un token

> [!NOTE]
>
> Para saber qué pueden hacer los colaboradores con acceso de solo lectura, consulte el Q\&A de la [integración con Git](https://ayakaleaf-pro.mintlify.site/es/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.