Натисніть Account, потім Account settings. У розділі Project synchronisation знайдіть Gitea і натисніть Link.
Gitea у налаштуваннях облікового запису
2
Авторизуйтеся на Gitea
Відкриється Gitea. Увійдіть, якщо буде потрібно, потім авторизуйте застосунок.
3
Перевірте прив'язку
Ви повернетеся до налаштувань облікового запису. Зелене повідомлення повідомить, що ваш обліковий запис Gitea прив’язано, а на кнопці тепер написано Unlink.
Ваш обліковий запис Gitea прив'язано
Якщо ваш обліковий запис ще не прив’язано, Import from Gitea і картка Gitea у редакторі спершу попросять його прив’язати. Натисніть Link to your Gitea account. Ви також опинитеся в налаштуваннях облікового запису, у новій вкладці, якщо почали в редакторі. Потім поверніться й почніть знову.
Підказка, якщо обліковий запис не прив'язано
Імпорт репозиторію
Так створюється новий проєкт із репозиторію Gitea, уже прив’язаний до нього.
1
Відкрийте діалог імпорту
На сторінці проєктів натисніть New project, потім Import from Gitea.
Меню New project
2
Виберіть репозиторій
Натисніть Import to Overleaf поруч із репозиторієм. У списку є ваші репозиторії та репозиторії ваших організацій. Порожній репозиторій не відображається: у ньому має бути хоча б один коміт.
Ваші репозиторії Gitea
3
Перевірте проєкт
Новий проєкт відкриється з файлами репозиторію.
Імпортований проєкт
Експорт проєкту в новий репозиторій
Так із проєкту створюється репозиторій, і вони прив’язуються. Проєкт можна прив’язати лише цим способом або імпортом: прив’язати його до вже наявного репозиторію не можна.
1
Відкрийте Gitea в редакторі
Відкрийте проєкт. На лівій панелі натисніть Integrations, потім Gitea.
Панель Integrations
2
Заповніть дані репозиторію
Виберіть Owner: це можете бути ви або одна з ваших організацій. Якщо ви вибираєте організацію, це поле називається Organization. Repository Name спочатку збігається з назвою проєкту: якщо в назві є пробіли, змініть її, бо Gitea їх не приймає. Опис необов’язковий, а Private вибрано за замовчуванням. Натисніть Create a Gitea repository.
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 і вказано репозиторій.
Проєкт прив'язано
Синхронізація
1
Відкрийте діалог синхронізації
Відкрийте прив’язаний проєкт. На лівій панелі натисніть Integrations, потім Gitea.Recent commits in Gitea перелічує те, що потрапить у проєкт.
Новий коміт очікує в Gitea
2
Опишіть свої зміни
Якщо ви щось змінили в проєкті, з’явиться поле для повідомлення коміту. Воно необов’язкове: якщо залишити його порожнім, коміт називатиметься Updates from Overleaf.
Повідомлення коміту для ваших змін
3
Натисніть Sync
Натисніть Sync. Нові коміти з Gitea потрапляють у проєкт, а ваші зміни надсилаються до гілки репозиторію за замовчуванням. Якщо обидві сторони змінили різні місця, зміни об’єднуються автоматично через pull request, який залишається на Gitea як запис.
4
Перевірте результат
У діалоговому вікні з’явиться No new commits in Gitea since last merge., а поле повідомлення коміту зникне. Файли в редакторі та коміти на Gitea актуальні.
Усе синхронізовано
Якщо ті самі рядки змінилися з обох боків
Діалогове вікно повідомляє, що зміни не вдалося об’єднати, і називає нову гілку overleaf-YYYY-MM-DD-HHMMSS, у якій містяться ваші зміни. Overleaf також відкриває на Gitea pull request із цієї гілки.
Конфлікт
Об’єднайте цю гілку з гілкою за замовчуванням за допомогою Git і усуньте конфлікт. Тим часом діалог можна закрити: під час повторного відкриття він покаже те саме повідомлення.
git clone <repository-address>cd <repository-name>git merge origin/overleaf-YYYY-MM-DD-HHMMSS# fix the conflict in the file Git namesgit add <file>git commitgit push
Натисніть I have manually merged. Continue. Об’єднаний результат потрапить у проєкт. Якщо натиснути кнопку до злиття гілки, діалог залишиться без змін.
Гілка залишається на Gitea, а її pull request лишається відкритим. Закрийте pull request і видаліть гілку, коли вони стануть непотрібними.
Те саме діалогове вікно з’являється, коли правило захисту гілки затримує pull request, наприклад якщо потрібне схвалення, навіть якщо конфліктних рядків немає. Щойно правило дозволить, виконайте злиття pull request на Gitea і натисніть I have manually merged. Continue. Див. Як працює синхронізація з Gitea.
Відв’язування проєкту
Зробіть це, якщо більше не хочете синхронізувати проєкт.
1
Натисніть Unlink
У діалозі синхронізації натисніть Unlink.
2
Підтвердьте
Натисніть Confirm. Це лише видаляє прив’язку: під’єднання до репозиторію, власником якого ви є, згадане в попередженні, залишається можливістю на майбутнє, а не відбувається зараз.
Підтвердження відв'язування
3
Перевірте результат
Тепер у діалоговому вікні відображається Export Project to Gitea. І проєкт, і репозиторій зберігають свій вміст. Щоб знову синхронізувати, експортуйте проєкт у новий репозиторій або імпортуйте репозиторій у новий проєкт.
Відв’язування облікового запису Gitea
В Account settings, у розділі Gitea, натисніть Unlink, потім ще раз Unlink у діалоговому вікні.
Відв'язування облікового запису
Ваші проєкти залишаються прив’язаними до своїх репозиторіїв. Синхронізувати їх не можна, доки ви знову не прив’яжете обліковий запис.