Перейти к основному содержанию
Подключите проект к репозиторию Gitea. Изменения передаются в обе стороны и только тогда, когда вы нажимаете Sync: ничего не синхронизируется само по себе.
Сначала администратор должен включить синхронизацию с Gitea.
Это делается один раз.
1

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

Нажмите Account, затем Account settings. В разделе Project synchronisation найдите Gitea и нажмите Link.
Раздел Gitea в настройках учётной записи с кнопкой Link

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

2

Авторизуйтесь на Gitea

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

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

Вы вернётесь в настройки учётной записи. Зелёное сообщение сообщит, что ваша учётная запись Gitea привязана, а на кнопке теперь написано Unlink.
Раздел Gitea в настройках учётной записи с кнопкой Unlink

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

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

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

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

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

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

На странице проектов нажмите New project, затем Import from Gitea.
Меню New project с пунктом Import from Gitea

Меню New project

2

Выберите репозиторий

Нажмите Import to Overleaf рядом с репозиторием. В списке есть ваши репозитории и репозитории ваших организаций. Пустой репозиторий не отображается: в нём должен быть хотя бы один коммит.
Диалоговое окно Import from Gitea со списком из четырёх репозиториев

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

3

Проверьте проект

Новый проект откроется с файлами репозитория.
Редактор с импортированным проектом, его файлами и скомпилированным PDF

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

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

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

Откройте Gitea в редакторе

Откройте проект. На левой панели нажмите Integrations, затем Gitea.
Панель Integrations с карточкой Gitea

Панель Integrations

2

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

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

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 после экспорта

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

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

1

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

Откройте привязанный проект. На левой панели нажмите Integrations, затем Gitea.Recent commits in Gitea перечисляет то, что попадёт в проект.
Диалоговое окно Sync with Gitea с одним новым коммитом

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

2

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

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

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

3

Нажмите Sync

Нажмите Sync. Новые коммиты из Gitea попадают в проект, а ваши изменения отправляются в ветку репозитория по умолчанию. Если обе стороны изменили разные места, изменения объединяются автоматически через pull request, который остаётся на Gitea как запись.
4

Проверьте результат

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

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

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

Диалоговое окно сообщает, что изменения не удалось объединить, и называет новую ветку overleaf-YYYY-MM-DD-HHMMSS, в которой находятся ваши изменения. Overleaf также открывает на Gitea pull request из этой ветки.
Диалоговое окно Sync with Gitea с предупреждением о конфликте слияния

Конфликт

  1. Объедините эту ветку с веткой по умолчанию с помощью Git и устраните конфликт. Тем временем диалог можно закрыть: при повторном открытии он покажет то же сообщение.
  2. Нажмите I have manually merged. Continue. Объединённый результат попадёт в проект. Если нажать кнопку до слияния ветки, диалог останется без изменений.
  3. Ветка остаётся на Gitea, а её pull request остаётся открытым. Закройте pull request и удалите ветку, когда они станут не нужны.
То же диалоговое окно появляется, когда правило защиты ветки задерживает pull request, например если требуется одобрение, даже если конфликтующих строк нет. Как только правило позволит, выполните слияние pull request на Gitea и нажмите I have manually merged. Continue. См. Как работает синхронизация с Gitea. Сделайте это, если больше не хотите синхронизировать проект.
1

Нажмите Unlink

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

Подтвердите

Нажмите Confirm. Это только удаляет привязку: подключение к репозиторию, которым вы владеете, упомянутое в предупреждении, остаётся возможностью на будущее, а не происходит сейчас.
Диалоговое окно Sync with Gitea с запросом подтвердить отвязку

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

3

Проверьте результат

Теперь в диалоговом окне отображается Export Project to Gitea. И проект, и репозиторий сохраняют своё содержимое. Чтобы снова синхронизировать, экспортируйте проект в новый репозиторий или импортируйте репозиторий в новый проект.
В Account settings, в разделе Gitea, нажмите Unlink, затем ещё раз Unlink в диалоговом окне.
Диалоговое окно Unlink Gitea Account

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

Ваши проекты остаются привязанными к своим репозиториям. Синхронизировать их нельзя, пока вы снова не привяжете учётную запись.
О том, кто что может делать в общем проекте, см. Кто может привязывать и синхронизировать.
Последнее изменение 20 ноября 2026 г.