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