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

# Інтеграція з Git

> Створіть токен доступу, клонуйте проєкт за допомогою Git, а потім виконуйте pull і push.

Працюйте над проєктом на власному комп'ютері за допомогою Git. Зміни передаються лише тоді, коли ви виконуєте `git pull` або `git push`.

> [!NOTE]
>
> Спочатку адміністратор має увімкнути [інтеграцію з Git](https://ayakaleaf-pro.mintlify.site/uk/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).

## Створення токена

Git входить за допомогою токена автентифікації Git, а не пароля вашого облікового запису.

**1. Відкрийте налаштування облікового запису**

Натисніть **Account**, потім **Account settings**. У розділі **Git integration** натисніть **Generate token**. Коли у вас уже є токен, ця кнопка називається **Add another token**.

![Розділ Git integration у налаштуваннях облікового запису з кнопкою 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)

Інтеграція з Git у налаштуваннях облікового запису

**2. Скопіюйте токен**

Натисніть **Copy** і збережіть токен у надійному місці. Ви бачите його лише один раз. Потім натисніть **Close**.

![Діалогове вікно токена автентифікації Git із кнопкою Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

Ваш новий токен

**3. Перевірте токен**

Тепер у списку видно початок токена, час його створення та останнього використання. Строк дії токена спливає через рік. Ви можете мати до 10 токенів.

![Список токенів з одним токеном](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

Ваші токени

## Клонування проєкту

**1. Відкрийте інтеграцію з Git у редакторі**

Відкрийте проєкт. На лівій панелі натисніть **Integrations**, потім **Git integration**.

![Панель Integrations з карткою 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)

Панель Integrations

**2. Скопіюйте команду**

Діалогове вікно **Clone with Git** показує команду з адресою вашого сайту та ID проєкту. Натисніть **Copy**. Якщо у вас ще немає токена, **Go to settings** відкриє налаштування облікового запису в новій вкладці.

![Діалогове вікно Clone with Git з командою 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)

Команда клонування

**3. Виконайте її**

Вставте команду в термінал. Коли Git запитає пароль, вставте свій токен.

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

Тепер тека з назвою, що дорівнює ID проєкту, містить файли проєкту в гілці `main`. Щоб вибрати назву теки, додайте її в кінець команди.

Git запитує токен щоразу, коли звертається до сайту. Щоб він запам'ятався, увімкніть credential helper: Git запитає ще раз, а потім збереже токен. Helper `store` зберігає його в незашифрованому вигляді в `~/.git-credentials`.

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

## Отримання змін із редактора

У теці виконайте:

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

Git перелічить змінені файли. Зміни, зроблені в редакторі, надходять як коміти з назвою `Update on Overleaf.`.

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

## Надсилання змін

Закомітьте зміни, потім надішліть їх:

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

Останній рядок виводу показує гілку, яка просунулася:

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

Зміни з'являються в редакторі, а відкритий редактор оновлюється сам. Нові файли, теки та перейменування з'являються в дереві файлів. В **History** вашу зміну позначено як **You (via Git)**. Повідомлення коміту там не показується.

![Історія проєкту з надісланим рядком, позначеним 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 в історії проєкту

### Якщо Git відхиляє push

Якщо проєкт тим часом змінився, Git відхиляє push:

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

Спочатку отримайте ці зміни, потім знову виконайте push:

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

Звичайний `git pull` може зупинитися з повідомленням `fatal: Need to specify how to reconcile divergent branches.` Параметр `--no-rebase` вище розв'язує це: він об'єднує обидві сторони.

Якщо ті самі рядки змінилися з обох боків, pull зупиняється з повідомленням `CONFLICT (content): Merge conflict in main.tex`. Виправте файл, потім виконайте:

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

Сайт не приймає двох речей:

* Інші гілки: `! [remote rejected] feature -> feature (wrong branch)`. Існує лише `main`, тож надсилайте роботу туди.
* Примусовий push: `! [remote rejected] main -> main (forced push prohibited)`. Натомість розмістіть свої зміни поверх поточної `main`.

### Якщо Git повідомляє 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>/'
```

Токен неправильний або видалений, або ви ввели пароль облікового запису. Створіть новий токен, якщо у вас його більше немає: наявний токен не можна переглянути повторно.

## Видалення токена

В **Account settings**, у розділі **Git integration**, натисніть значок видалення поруч із токеном, потім **Delete** у діалоговому вікні. Відтоді Git відповідає `Authentication failed` на цей токен.

![Діалогове вікно 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)

Видалення токена

> [!NOTE]
>
> Про те, що можуть робити співавтори з доступом лише для читання, див. Q\&A на сторінці [інтеграції з Git](https://ayakaleaf-pro.mintlify.site/uk/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


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