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