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

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

> Прив'яжіть обліковий запис Gitea, імпортуйте чи експортуйте проєкт, синхронізуйте зміни в обидва боки та відв'яжіть.

Під'єднайте проєкт до репозиторію Gitea. Зміни передаються в обидва боки і лише тоді, коли ви натискаєте **Sync**: нічого не синхронізується саме собою.

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

## Прив'язка облікового запису Gitea

Це робиться один раз.

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

Натисніть **Account**, потім **Account settings**. У розділі **Project synchronisation** знайдіть **Gitea** і натисніть **Link**.

![Розділ Gitea у налаштуваннях облікового запису з кнопкою Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=5514bcd66b524c3dde2376db09935feb)

Gitea у налаштуваннях облікового запису

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

Відкриється Gitea. Увійдіть, якщо буде потрібно, потім авторизуйте застосунок.

**3. Перевірте прив'язку**

Ви повернетеся до налаштувань облікового запису. Зелене повідомлення повідомить, що ваш обліковий запис Gitea прив'язано, а на кнопці тепер написано **Unlink**.

![Розділ Gitea у налаштуваннях облікового запису з кнопкою Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b0eb94a11ff546a6770d4f5a8b5250de)

Ваш обліковий запис Gitea прив'язано

Якщо ваш обліковий запис ще не прив'язано, **Import from Gitea** і картка **Gitea** у редакторі спершу попросять його прив'язати. Натисніть **Link to your Gitea account**. Ви також опинитеся в налаштуваннях облікового запису, у новій вкладці, якщо почали в редакторі. Потім поверніться й почніть знову.

![Діалогове вікно Import from Gitea з кнопкою Link to your Gitea account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b9f6e8fc7d3aa2d3328423f660de5a9c)

Підказка, якщо обліковий запис не прив'язано

## Імпорт репозиторію

Так створюється новий проєкт із репозиторію Gitea, уже прив'язаний до нього.

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

На сторінці проєктів натисніть **New project**, потім **Import from Gitea**.

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

Меню New project

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

Натисніть **Import to Overleaf** поруч із репозиторієм. У списку є ваші репозиторії та репозиторії ваших організацій. Порожній репозиторій не відображається: у ньому має бути хоча б один коміт.

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

Ваші репозиторії Gitea

**3. Перевірте проєкт**

Новий проєкт відкриється з файлами репозиторію.

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

Імпортований проєкт

## Експорт проєкту в новий репозиторій

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

**1. Відкрийте Gitea в редакторі**

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

![Панель Integrations з карткою Gitea](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=12710e50eecf8f3b385565c85b4a45a4)

Панель Integrations

**2. Заповніть дані репозиторію**

Виберіть **Owner**: це можете бути ви або одна з ваших організацій. Якщо ви вибираєте організацію, це поле називається **Organization**. **Repository Name** спочатку збігається з назвою проєкту: якщо в назві є пробіли, змініть її, бо Gitea їх не приймає. Опис необов'язковий, а **Private** вибрано за замовчуванням. Натисніть **Create a Gitea repository**.

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

Export Project to Gitea

Якщо в назві є пробіли або її вже зайнято, у діалоговому вікні з'явиться **Please check that the repository name is valid, and that you have permission to create the repository.** Змініть назву й знову натисніть кнопку.

**3. Перевірте прив'язку**

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

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

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

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

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

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

**Recent commits in Gitea** перелічує те, що потрапить у проєкт.

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

Новий коміт очікує в Gitea

**2. Опишіть свої зміни**

Якщо ви щось змінили в проєкті, з'явиться поле для повідомлення коміту. Воно необов'язкове: якщо залишити його порожнім, коміт називатиметься `Updates from Overleaf`.

![Діалогове вікно Sync with Gitea із заповненим повідомленням коміту](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=014cd300d4deff341310920221c63a30)

Повідомлення коміту для ваших змін

**3. Натисніть Sync**

Натисніть **Sync**. Нові коміти з Gitea потрапляють у проєкт, а ваші зміни надсилаються до гілки репозиторію за замовчуванням. Якщо обидві сторони змінили різні місця, зміни об'єднуються автоматично через pull request, який залишається на Gitea як запис.

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

У діалоговому вікні з'явиться **No new commits in Gitea since last merge.**, а поле повідомлення коміту зникне. Файли в редакторі та коміти на Gitea актуальні.

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

Усе синхронізовано

### Якщо ті самі рядки змінилися з обох боків

Діалогове вікно повідомляє, що зміни не вдалося об'єднати, і називає нову гілку `overleaf-YYYY-MM-DD-HHMMSS`, у якій містяться ваші зміни. Overleaf також відкриває на Gitea pull request із цієї гілки.

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

Конфлікт

1. Об'єднайте цю гілку з гілкою за замовчуванням за допомогою Git і усуньте конфлікт. Тим часом діалог можна закрити: під час повторного відкриття він покаже те саме повідомлення.

   ```bash theme={null}
   git clone <repository-address>
   cd <repository-name>
   git merge origin/overleaf-YYYY-MM-DD-HHMMSS
   # fix the conflict in the file Git names
   git add <file>
   git commit
   git push
   ```
2. Натисніть **I have manually merged. Continue**. Об'єднаний результат потрапить у проєкт. Якщо натиснути кнопку до злиття гілки, діалог залишиться без змін.
3. Гілка залишається на Gitea, а її pull request лишається відкритим. Закрийте pull request і видаліть гілку, коли вони стануть непотрібними.

Те саме діалогове вікно з'являється, коли правило захисту гілки затримує pull request, наприклад якщо потрібне схвалення, навіть якщо конфліктних рядків немає. Щойно правило дозволить, виконайте злиття pull request на Gitea і натисніть **I have manually merged. Continue**. Див. [Як працює синхронізація з Gitea](https://ayakaleaf-pro.mintlify.site/uk/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md#how-syncing-works-with-gitea).

## Відв'язування проєкту

Зробіть це, якщо більше не хочете синхронізувати проєкт.

**1. Натисніть Unlink**

У діалозі синхронізації натисніть **Unlink**.

**2. Підтвердьте**

Натисніть **Confirm**. Це лише видаляє прив'язку: під'єднання до репозиторію, власником якого ви є, згадане в попередженні, залишається можливістю на майбутнє, а не відбувається зараз.

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

Підтвердження відв'язування

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

Тепер у діалоговому вікні відображається **Export Project to Gitea**. І проєкт, і репозиторій зберігають свій вміст. Щоб знову синхронізувати, експортуйте проєкт у новий репозиторій або імпортуйте репозиторій у новий проєкт.

## Відв'язування облікового запису Gitea

В **Account settings**, у розділі **Gitea**, натисніть **Unlink**, потім ще раз **Unlink** у діалоговому вікні.

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

Відв'язування облікового запису

Ваші проєкти залишаються прив'язаними до своїх репозиторіїв. Синхронізувати їх не можна, доки ви знову не прив'яжете обліковий запис.

> [!NOTE]
>
> Про те, хто що може робити в спільному проєкті, див. [Хто може прив'язувати й синхронізувати](https://ayakaleaf-pro.mintlify.site/uk/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md#who-can-link-and-sync).


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