> ## 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/ru/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/ru/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


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