> ## 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.

# Integrace s Gitem

> Vytvořte přístupový token, naklonujte projekt pomocí Gitu a poté provádějte pull a push.

Pracujte na projektu na svém vlastním počítači pomocí Gitu. Změny se přenášejí pouze tehdy, když spustíte `git pull` nebo `git push`.

> [!NOTE]
>
> Správce musí nejprve zapnout [integraci s Gitem](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).

## Vytvoření tokenu

Git se přihlašuje pomocí ověřovacího tokenu Gitu, nikoli heslem k vašemu účtu.

**1. Otevřete nastavení účtu**

Klikněte na **Account** a poté na **Account settings**. V části **Git integration** klikněte na **Generate token**. Jakmile máte token, toto tlačítko se jmenuje **Add another token**.

![Část Git integration v nastavení účtu s tlačítkem 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)

Integrace s Gitem v nastavení účtu

**2. Zkopírujte token**

Klikněte na **Copy** a uložte token na bezpečné místo. Uvidíte ho jen jednou. Poté klikněte na **Close**.

![Dialog ověřovacího tokenu Gitu s tlačítkem Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

Váš nový token

**3. Zkontrolujte token**

Seznam teď ukazuje začátek tokenu, kdy byl vytvořen a kdy byl naposledy použit. Platnost vyprší po jednom roce. Můžete mít až 10 tokenů.

![Seznam tokenů s jedním tokenem](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

Vaše tokeny

## Klonování projektu

**1. Otevřete integraci s Gitem v editoru**

Otevřete projekt. V levém panelu klikněte na **Integrations** a poté na **Git integration**.

![Panel Integrations s kartou 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)

Panel Integrations

**2. Zkopírujte příkaz**

Dialog **Clone with Git** zobrazuje příkaz s adresou vašeho webu a ID projektu. Klikněte na **Copy**. Pokud ještě nemáte token, **Go to settings** otevře nastavení účtu na nové kartě.

![Dialog Clone with Git s příkazem 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)

Příkaz pro klonování

**3. Spusťte ho**

Vložte příkaz do terminálu. Když Git požádá o heslo, vložte svůj 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>
```

Složka pojmenovaná podle ID projektu teď obsahuje soubory projektu ve větvi `main`. Chcete-li zvolit název složky, přidejte ho na konec příkazu.

Git žádá o token pokaždé, když se připojuje k webu. Aby si ho zapamatoval, zapněte credential helper: Git se zeptá ještě jednou a pak token uchová. Helper `store` ho ukládá nešifrovaně do `~/.git-credentials`.

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

## Stažení změn z editoru

Ve složce spusťte:

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

Git vypíše změněné soubory. Změny provedené v editoru přicházejí jako commity s názvem `Update on Overleaf.`.

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

## Odeslání změn

Commitněte své změny a poté je odešlete:

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

Poslední řádek výstupu ukazuje větev, která se posunula:

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

Změny se objeví v editoru a otevřený editor se aktualizuje sám. Nové soubory, složky a přejmenování se zobrazí ve stromu souborů. V **History** je vaše změna označena jako **You (via Git)**. Vaše zpráva commitu se tam nezobrazuje.

![Historie projektu s odeslaným řádkem označeným 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)

Push v historii projektu

### Pokud Git push odmítne

Pokud se projekt mezitím změnil, Git push odmítne:

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

Nejprve tyto změny stáhněte a pak odešlete znovu:

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

Obyčejný `git pull` se může zastavit se zprávou `fatal: Need to specify how to reconcile divergent branches.` Volba `--no-rebase` výše to řeší: sloučí obě strany.

Pokud se na obou stranách změnily stejné řádky, pull se zastaví se zprávou `CONFLICT (content): Merge conflict in main.tex`. Opravte soubor a poté spusťte:

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

Web nepřijímá dvě věci:

* Jiné větve: `! [remote rejected] feature -> feature (wrong branch)`. Existuje pouze `main`, takže práci odesílejte tam.
* Vynucený push: `! [remote rejected] main -> main (forced push prohibited)`. Místo toho umístěte své změny na aktuální `main`.

### Pokud Git hlásí 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>/'
```

Token je nesprávný nebo byl smazán, případně jste zadali heslo k účtu. Pokud token už nemáte, vytvořte nový, protože existující token nelze znovu zobrazit.

## Smazání tokenu

V **Account settings** v části **Git integration** klikněte na ikonu smazání vedle tokenu a poté v dialogu na **Delete**. Od té chvíle Git na tento token odpovídá `Authentication failed`.

![Dialog 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)

Smazání tokenu

> [!NOTE]
>
> Co mohou dělat spolupracovníci s přístupem jen pro čtení, najdete v Q\&A na stránce [integrace s Gitem](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


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