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

Підключіть GitHub за кодом пристрою або токеном, опублікуйте проєкт як новий чи наявний репозиторій, надсилайте й отримуйте зміни між комп’ютерами та дізнайтеся, як захищається ваш токен.

Синхронізація з GitHub — це необов’язкове резервне копіювання поза комп’ютером і передавання роботи між комп’ютерами, побудоване на [справжньому репозиторії Git](/docs/git-history/), яким кожен проєкт уже є. Локальні коміти працюють без GitHub. Коли ви підключаєтеся, облікового запису Oleafly у цій схемі все одно немає: лише ваш GitHub.

## Підключення облікового запису

Налаштування, **Інтеграції**, **GitHub**, потім будь-який із двох шляхів:

- **Підключити GitHub** (рекомендовано): потік із кодом пристрою. Oleafly показує короткий код, ваш браузер відкриває `github.com/login/device` (з кнопкою **Копіювати** для коду), ви підтверджуєте, і застосунок виявляє це за кілька секунд. Підключення запитує лише права `repo` і `read:user`.
- **Особистий токен доступу**: розкрийте «Додатково: використати особистий токен доступу» і вставте PAT, якщо волієте створювати власні облікові дані.

Після підключення ваш аватар і ім’я користувача з’являються в Налаштуваннях і в меню GitHub на верхній панелі. **Відключити** забуває токен.

### Як захищається ваш токен

Токен зберігається в зашифрованому AES-256-GCM локальному файлі, доступному лише власнику, і ніколи не передається шару інтерфейсу застосунку; інтерфейс дізнається щонайбільше «підключено як @ви». Коли Git потребує автентифікації, токен упроваджується через допоміжну програму облікових даних у пам’яті, тож він ніколи не з’являється в командному рядку, в `.git/config` чи в історії вашої оболонки. Старіші збірки, що вбудовували токени в URL віддалених репозиторіїв, очищаються автоматично під час запуску.

## Публікація проєкту

На панелі «Контроль версій» клацніть **Опублікувати на GitHub**:

- **Створити новий репозиторій**: виберіть назву (попередньо заповнена з проєкту), лишіть **Приватний** (рекомендовано) позначеним чи ні і натисніть **Створити і надіслати**. Oleafly створює репозиторій, комітить файли проєкту, під’єднує `origin` і надсилає.
- **Зв’язати з наявним**: виберіть зі списку своїх репозиторіїв із пошуком (приватні показані із замком) і натисніть **Зв’язати і надіслати**.

Після публікації меню GitHub на верхній панелі пропонує **Відкрити в GitHub** і **Копіювати посилання на репозиторій**.

### Файли, схожі на секрети, лишаються локальними

Публікація ніколи не комітить файли, що зазвичай містять ключі або паролі, як-от `.env`, `*.pem`, приватні ключі SSH чи `credentials.json`. Вони лишаються в папці проєкту непідготовленими, і діалог називає їх. Щоб усе одно опублікувати такий файл, підготуйте й закомітьте його самі в Контролі версій. Шаблони на кшталт `.env.example`, відкриті ключі та файли Keynote `.key` публікуються як завжди.

Надсилання вивантажує всю історію. Якщо файл із однією з цих назв коли-небудь комітився, Oleafly перелічує його й чекає на **Скасувати** або **Усе одно опублікувати**, перш ніж щось створювати на GitHub.

## Щоденна синхронізація

Кнопки **Надіслати** і **Отримати** панелі «Контроль версій» роблять саме те, що обіцяють, працюючи з `origin` на вашій поточній гілці. **Отримати (Fetch)** і **Синхронізувати** — в меню **Більше дій контролю версій**, а **Закомітити і надіслати** та **Закомітити і синхронізувати** — у меню біля **Закомітити**. Індикатор **попереду/позаду** (↑ ↓) біля плашки гілки підказує, коли є що надіслати або отримати.

### Два комп’ютери

1. На комп’ютері A: опублікуйте проєкт, попрацюйте, натисніть **Надіслати**.
2. На комп’ютері B: підключіть той самий обліковий запис GitHub, потім виберіть **Імпортувати проєкт → GitHub** і вкажіть репозиторій. Див. [посібник з імпорту](/docs/import-project/#import-from-github). Далі — **Отримати**, попрацювати, **Надіслати**.
3. Знову на A: спершу **Отримати**. Індикатор вам нагадає.

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

## Як передумати

Коли віддалений репозиторій задано, меню **Більше дій контролю версій** має ще два пункти:

- **Змінити репозиторій** знову відкриває діалог публікації, щоб спрямувати `origin` в інше місце.
- **Від’єднати** вилучає віддалений репозиторій; локальний проєкт та його історію не зачіпаються.

## Конфлікти та гілки

Якщо отримання натикається на конфлікт злиття, Контроль версій перелічує конфліктні файли. Для кожного виберіть **Узяти поточну** або **Узяти вхідну**, або відредагуйте файл і виберіть **Позначити розв’язаним**, потім **Завершити злиття**. **Перервати злиття** повертає файли в попередній стан. Надсилання та отримання працюють на гілці, яку ви витягнули, а меню гілок угорі панелі перемикає або створює гілки. Див. [Git і контроль версій](/docs/git-history/#branches-and-stashes).

## Обмеження, викладені просто

Oleafly автентифікує віддалені репозиторії HTTPS. Публікація налаштовує такий репозиторій для вас правильно.

## Якщо щось не працює

- «Немає віддаленого `origin`»: спершу опублікуйте; Надсиланню й Отриманню потрібен віддалений репозиторій.
- Надсилання відхилено, бо віддалений репозиторій має коміти: спершу отримайте, потім надішліть.
- «Не задано токен GitHub»: підключіться у Налаштування, Інтеграції, GitHub.

Більше — у [частих питаннях](/docs/faq/#history-and-collaboration).
