# Git і контроль версій

Переглядайте відмінності, готуйте файли та зберігайте віхи у звичайному репозиторії Git.

Використовуйте Git для версій, які хочете назвати: завершений розділ, редагування, надіслане вашому керівнику, або код, що стоїть за поданням. Він працює локально, без облікового запису GitHub.

![Контроль версій у LLaMA. Відкрийте змінений файл, щоб переглянути його, потім підготуйте файли, які хочете бачити в наступному коміті.](https://cdn.oleafly.com/images/screenshots/desktop/docs/source-control-dark-window-v2.png#view=0,45,344,513)

![Порівняння змін поруч переглянуто, підготовлено й закомічено.](https://cdn.oleafly.com/images/gifs/desktop/git-commit.gif?v=2)

## Відкрийте контроль версій

Відкрийте **Контроль версій** на лівій панелі проєкту. Панель показує поточну гілку, підготовлені файли та робочі зміни.

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

Провідник позначає змінені файли тими самими літерами, що й Контроль версій: M для змінених, A для доданих, D для видалених і U для не відстежуваних. Назви файлів зберігають звичайний колір, а папка зі змінами отримує крапку. Див. [Файли і папки](/docs/files/).

## Перший коміт

Коли Oleafly створює або імпортує проєкт, він налаштовує репозиторій Git і записує файли проєкту одним комітом під назвою «Create project». Контроль версій тоді показує справжні відмінності з самого початку. Git-хуки та підписування комітів для цього коміту ніколи не запускаються, тож глобальний хук або запит на підпис не можуть заблокувати створення проєкту.

Oleafly пропускає той перший коміт, коли:

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

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

Відкриття проєкту без репозиторію лише запускає `git init`; комітів він ніколи не робить. Після першого коміту Oleafly комітить лише на ваше прохання. Папку, відкриту на її місці, не чіпають, як і ту, що вже лежить усередині іншого репозиторію.

Щоб усе це вимкнути, зніміть **Ініціалізувати Git для кожного проєкту** у **Налаштування → Інтеграції → GitHub**. Контроль версій тоді запускається лише коли ви тиснете **Ініціалізувати репозиторій** або публікуєте на GitHub.

## Коли Git не встановлено

Oleafly використовує Git, встановлений на вашому комп’ютері. Без нього проєкти все одно відкриваються й компілюються. Контроль версій показує **Git не встановлено** і пояснює, як дістати Git для вашої системи, замість показу кнопок, що не спрацювали б:

- **Windows**: виберіть **Завантажити Git for Windows**, установіть Git, потім перезапустіть Oleafly.
- **macOS**: виконайте `xcode-select --install` у Terminal, щоб установити інструменти командного рядка Apple, до яких входить Git. **Копіювати команду** копіює його для вас. Потім оновіть панель.
- **Linux**: встановіть пакунок `git` своїм менеджером пакунків, потім оновіть панель.

## Збережіть віху

![Заголовок коміту, необов’язковий опис і керування «Закомітити», «Надіслати» й «Отримати» розташовані під списком змінених файлів.](https://cdn.oleafly.com/images/screenshots/desktop/docs/source-control-dark-window-v2.png#view=0,815,344,260)

1. Перегляньте змінені файли.
2. Підготуйте файли, які хочете включити в коміт.
3. Напишіть повідомлення, що описує результат, як-от `Revise methods and add calibration figure`.
4. Закомітьте.

Меню біля **Закомітити** пропонує також **Виправити останній коміт**, **Закомітити і надіслати** та **Закомітити і синхронізувати**. Це звичайні коміти Git. Той самий репозиторій можна оглянути іншим клієнтом Git або командним рядком.

## Гілки і stash

Клацніть назву гілки угорі панелі, щоб перемкнути гілки або вибрати **Створити гілку…**. У меню **Більше дій контролю версій** є **Отримати (Fetch)**, **Отримати (Pull)**, **Надіслати**, **Синхронізувати**, **Відкласти зміни** та **Застосувати останній stash**.

Коли отримання або відкладення змін стикається з конфліктами, панель перелічує конфліктні файли. Для кожного виберіть **Узяти поточну**, **Узяти вхідну** або відредагуйте файл і виберіть **Позначити розв’язаним**. Під час злиття **Завершити злиття** стає доступним, щойно кожен файл розв’язано, а **Перервати злиття** повертає файли до стану перед початком злиття.

## Відновіть коміт

Відкрийте **Версіонування → Історія Git**, виберіть коміт і перегляньте підтвердження відновлення. Відновлення замінює відстежуваний вміст проєкту тією версією і перезавантажує відкриті буфери редактора. Ваша гілка лишається на поточному коміті.

Скористайтеся [Збереженими контрольними точками](/docs/checkpoints/), коли вам потрібні знімки, що захоплюються автоматично після успішних компіляцій. Ті знімки зберігаються окремо; вони не створюють комітів Git.

## Додайте віддалений репозиторій

Підключіть GitHub, коли хочете копію поза комп’ютером або переносити роботу між комп’ютерами. **Опублікувати на GitHub**, **Надіслати** та **Отримати** живуть на панелі «Контроль версій».

[Налаштуйте синхронізацію з GitHub →](/docs/github-sync/)
