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

# Integracja z Git

> Utwórz token dostępu, sklonuj projekt za pomocą Git, a następnie wykonuj pull i push.

Pracuj nad projektem na własnym komputerze za pomocą Git. Zmiany są przesyłane tylko wtedy, gdy uruchomisz `git pull` lub `git push`.

> [!NOTE]
>
> Administrator musi najpierw włączyć [integrację z Git](https://ayakaleaf-pro.mintlify.site/pl/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).

## Tworzenie tokenu

Git loguje się za pomocą tokenu uwierzytelniania Git, a nie hasła do konta.

**1. Otwórz ustawienia konta**

Kliknij **Account**, a następnie **Account settings**. W sekcji **Git integration** kliknij **Generate token**. Gdy masz już token, ten przycisk nazywa się **Add another token**.

![Sekcja Git integration w ustawieniach konta z przyciskiem 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)

Integracja z Git w ustawieniach konta

**2. Skopiuj token**

Kliknij **Copy** i przechowuj token w bezpiecznym miejscu. Widzisz go tylko raz. Następnie kliknij **Close**.

![Okno dialogowe tokenu uwierzytelniania Git z przyciskiem Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

Twój nowy token

**3. Sprawdź token**

Lista pokazuje teraz początek tokenu, datę utworzenia i ostatniego użycia. Token wygasa po roku. Możesz mieć do 10 tokenów.

![Lista tokenów z jednym tokenem](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

Twoje tokeny

## Klonowanie projektu

**1. Otwórz integrację z Git w edytorze**

Otwórz projekt. Na lewym pasku kliknij **Integrations**, a następnie **Git integration**.

![Panel Integrations z kartą 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. Skopiuj polecenie**

Okno dialogowe **Clone with Git** pokazuje polecenie z adresem Twojej witryny i ID projektu. Kliknij **Copy**. Jeśli nie masz jeszcze tokenu, **Go to settings** otworzy ustawienia konta w nowej karcie.

![Okno dialogowe Clone with Git z poleceniem 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)

Polecenie klonowania

**3. Uruchom je**

Wklej polecenie do terminala. Gdy Git poprosi o hasło, wklej swó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>
```

Folder nazwany identyfikatorem projektu zawiera teraz pliki projektu na gałęzi `main`. Aby wybrać nazwę folderu, dodaj ją na końcu polecenia.

Git prosi o token za każdym razem, gdy łączy się z witryną. Aby go zapamiętać, włącz credential helper: Git zapyta jeszcze raz, a potem zachowa token. Helper `store` przechowuje go bez szyfrowania w `~/.git-credentials`.

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

## Pobieranie zmian z edytora

W folderze uruchom:

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

Git wyświetli listę zmienionych plików. Zmiany wprowadzone w edytorze przychodzą jako commity o nazwie `Update on Overleaf.`.

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

## Wysyłanie zmian

Zatwierdź zmiany, a następnie je wyślij:

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

Ostatni wiersz wyniku pokazuje gałąź, która się przesunęła:

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

Zmiany pojawiają się w edytorze, a otwarty edytor aktualizuje się sam. Nowe pliki, foldery i zmiany nazw pojawiają się w drzewie plików. W **History** Twoja zmiana jest oznaczona jako **You (via Git)**. Komunikat commita nie jest tam wyświetlany.

![Historia projektu z wysłanym wierszem oznaczonym 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 w historii projektu

### Jeśli Git odrzuci push

Jeśli projekt w międzyczasie się zmienił, Git odrzuca push:

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

Najpierw pobierz te zmiany, a następnie wyślij ponownie:

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

Zwykłe `git pull` może zatrzymać się z komunikatem `fatal: Need to specify how to reconcile divergent branches.` Opcja `--no-rebase` powyżej to rozwiązuje: scala obie strony.

Jeśli te same wiersze zmieniły się po obu stronach, pull zatrzymuje się z komunikatem `CONFLICT (content): Merge conflict in main.tex`. Popraw plik, a następnie uruchom:

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

Są dwie rzeczy, których witryna nie akceptuje:

* Inne gałęzie: `! [remote rejected] feature -> feature (wrong branch)`. Istnieje tylko `main`, więc wysyłaj tam swoją pracę.
* Wymuszony push: `! [remote rejected] main -> main (forced push prohibited)`. Zamiast tego umieść swoje zmiany na bieżącej gałęzi `main`.

### Jeśli Git zgłasza 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 jest nieprawidłowy lub został usunięty albo wpisano hasło do konta. Utwórz nowy token, jeśli już go nie masz, ponieważ istniejącego tokenu nie można ponownie wyświetlić.

## Usuwanie tokenu

W **Account settings**, w sekcji **Git integration**, kliknij ikonę usuwania obok tokenu, a następnie **Delete** w oknie dialogowym. Od tej pory Git odpowiada `Authentication failed` na ten token.

![Okno dialogowe 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)

Usuwanie tokenu

> [!NOTE]
>
> Informacje o tym, co mogą robić współpracownicy z dostępem tylko do odczytu, znajdziesz w Q\&A na stronie [integracji z Git](https://ayakaleaf-pro.mintlify.site/pl/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


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