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

# Синхронизация с GitHub

> Привяжите учётную запись GitHub, импортируйте или экспортируйте проект, синхронизируйте изменения в обе стороны и отвяжите.

Подключите проект к репозиторию GitHub. Изменения передаются в обе стороны и только тогда, когда вы нажимаете **Sync**: ничего не синхронизируется само по себе.

> [!NOTE]
>
> Если вы не видите параметра GitHub в **Account settings** или в редакторе, попросите администратора включить [синхронизацию с GitHub](https://ayakaleaf-pro.mintlify.site/ru/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md).

## Привязка учётной записи GitHub

Это делается один раз.

**1. Откройте настройки учётной записи**

Нажмите **Account**, затем **Account settings**. Прокрутите до **GitHub** и нажмите **Link**.

![Раздел GitHub в настройках учётной записи с кнопкой Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8812ab1604914a8aa6c1f0937f0e1b2e)

GitHub в настройках учётной записи

**2. Авторизуйтесь на GitHub**

Откроется GitHub. Войдите, если потребуется, затем авторизуйте приложение.

**3. Проверьте привязку**

Вы вернётесь в настройки учётной записи, а на кнопке теперь написано **Unlink**.

![Раздел GitHub в настройках учётной записи с кнопкой Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=910b756aa0adea66bda5bb2e5776214e)

Ваша учётная запись GitHub привязана

Если ваша учётная запись ещё не привязана, **Import from GitHub** и карточка **GitHub** в редакторе сначала попросят её привязать. Нажмите **Link to your GitHub account**. Вы также окажетесь в настройках учётной записи, в новой вкладке, если начали в редакторе. Затем вернитесь и начните заново.

![Диалоговое окно Import from GitHub с кнопкой Link to your GitHub account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=05546893169a57f837a8938f904db194)

Подсказка, если учётная запись не привязана

## Импорт репозитория

Так создаётся новый проект из репозитория GitHub, уже привязанный к нему.

**1. Откройте диалог импорта**

На странице проектов нажмите **New project**, затем **Import from GitHub**.

![Меню New project с пунктом Import from GitHub](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=384e6663f982016a5c295f35c4709413)

Меню New project

> [!NOTE]
>
> **New project** появляется, когда у вас есть хотя бы один проект. В меню **Create a new project** на приветственной странице нет импорта, поэтому сначала создайте пустой проект.

**2. Выберите репозиторий**

Нажмите **Import to Overleaf** рядом с репозиторием. В списке есть ваши репозитории и репозитории ваших организаций.

![Диалоговое окно Import from GitHub со списком из четырёх репозиториев](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=54a0bd11655ddbfad4ae16e5e7473b74)

Ваши репозитории GitHub

Если репозитория организации нет в списке, нажмите **Can't see what you're looking for?**, чтобы открыть справку GitHub об одобрении приложения для этой организации.

**3. Проверьте проект**

Новый проект откроется с файлами репозитория.

![Редактор с импортированным проектом, его файлами и скомпилированным PDF](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=90dfe6947c2e0ed420abfc8c81992768)

Импортированный проект

## Экспорт проекта в новый репозиторий

Так из проекта, владельцем которого вы являетесь, создаётся репозиторий, и они связываются. Проект можно привязать только этим способом или импортом: привязать его к уже существующему репозиторию нельзя.

**1. Откройте GitHub в редакторе**

Откройте проект. На левой панели нажмите **Integrations**, затем **GitHub**.

![Панель Integrations с карточкой GitHub](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=5c96ec0031a5940c337393254b06e0d3)

Панель Integrations

**2. Заполните данные репозитория**

Выберите **Owner**: это можете быть вы или одна из ваших организаций. **Repository Name** изначально совпадает с именем проекта. Описание необязательно, а **Private** выбрано по умолчанию. Нажмите **Create a GitHub repository**.

![Заполненная форма Export Project to GitHub](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=24bd26a171943d43efaa3c4aed69d1e8)

Export Project to GitHub

**3. Проверьте привязку**

В диалоговом окне теперь написано **This project is linked to** и указан репозиторий.

![Диалоговое окно Sync with GitHub после экспорта](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=93ebf2c62d4a34c7d2c41ffbca9d0740)

Проект привязан

## Синхронизация

**1. Откройте диалог синхронизации**

Откройте привязанный проект. На левой панели нажмите **Integrations**, затем **GitHub**.

**Recent commits in GitHub** перечисляет то, что попадёт в проект.

![Диалоговое окно Sync with GitHub с одним новым коммитом](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6a3c23a6993f04d0fa818bceb565ce3e)

Новый коммит ожидает в GitHub

**2. Опишите свои изменения**

Если вы что-то изменили в проекте, появится поле для сообщения коммита. Оно необязательно: если оставить его пустым, коммит будет называться `Updates from Overleaf`.

![Диалоговое окно Sync with GitHub с заполненным сообщением коммита](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b3fe2cbcae8335c7363fcd220d2b993c)

Сообщение коммита для ваших изменений

**3. Нажмите Sync**

Нажмите **Sync**. Новые коммиты из GitHub попадают в проект, а ваши изменения отправляются в ветку репозитория по умолчанию. Если обе стороны изменили разные места, изменения объединяются автоматически.

**4. Проверьте результат**

В диалоговом окне появится **No new commits in GitHub since last merge.**, а поле сообщения коммита исчезнет. Файлы в редакторе и коммиты на GitHub актуальны.

![Диалоговое окно Sync with GitHub после синхронизации, без новых коммитов](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=851a620d8601a3ebaf9260f0f1c1685a)

Всё синхронизировано

### Если одни и те же строки изменились с обеих сторон

Диалоговое окно сообщает, что изменения не удалось объединить, и называет новую ветку `overleaf-YYYY-MM-DD-HHMMSS`, в которой находятся ваши изменения.

![Диалоговое окно Sync with GitHub с предупреждением о конфликте слияния](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b67dd69bb98605672da34b3a372be582)

Конфликт

1. Объедините эту ветку с веткой по умолчанию на GitHub или с помощью Git. Тем временем диалог можно закрыть: при повторном открытии он покажет то же сообщение.
2. Нажмите **I have manually merged. Continue**. Объединённый результат попадёт в проект.
3. Ветка остаётся на GitHub. Удалите её, когда она станет не нужна.

## Отвязка проекта

Сделайте это, если больше не хотите синхронизировать проект. Это может сделать только владелец проекта.

**1. Нажмите Unlink**

В диалоге синхронизации нажмите **Unlink**.

**2. Подтвердите**

Нажмите **Confirm**. Примечание о подписке не мешает снова привязать проект.

![Диалоговое окно Sync with GitHub с запросом подтвердить отвязку](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f2e541c2e9e8d000baa0dacd28a328)

Подтверждение отвязки

**3. Проверьте результат**

Теперь в диалоговом окне отображается **Export Project to GitHub**. И проект, и репозиторий сохраняют своё содержимое. Чтобы снова синхронизировать, экспортируйте проект в новый репозиторий или импортируйте репозиторий в новый проект.

## Отвязка учётной записи GitHub

В **Account settings**, в разделе **GitHub**, нажмите **Unlink**, затем ещё раз **Unlink** в диалоговом окне.

![Диалоговое окно Unlink GitHub Account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=94ce090cb4d8b98231886319d6e6d903)

Отвязка учётной записи

Ваши проекты остаются привязанными к своим репозиториям. Синхронизировать их нельзя, пока вы снова не привяжете учётную запись.

> [!NOTE]
>
> О том, кто что может делать в общем проекте, см. [Кто может привязывать и синхронизировать](https://ayakaleaf-pro.mintlify.site/ru/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md#who-can-link-and-sync). Каждый соавтор, который выполняет синхронизацию, привязывает свою учётную запись GitHub.


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