Швидкий старт

Тут передбачається, що Wyrm встановлено і ти увійшов. Скорочення наведено для macOS.

1. Відкрий репозиторій

Після входу Wyrm показує Відкрийте репозиторій, щоб почати з трьома кнопками:

• Відкрити… (⌘O): тека, яка в тебе вже є, Git або jj.
• Клонувати… (⌘⇧O): скопіювати репозиторій із GitHub, GitLab або за будь-яким Git URL на свій Mac.
• Новий репозиторій… (⌘⇧N): створити новий репозиторій у порожній або наявній теці.

Твій наявний Git-репозиторій

Якщо відкрити звичайну Git-теку, Wyrm спершу запитає у вікні Виявлено Git-репозиторій: «Це Git-репозиторій. Wyrmflow ініціалізує jujutsu поруч із Git, щоб ви могли використовувати обидва інструменти.» Клацни Відкрити репозиторій.

Що це робить:

• Створює теку .jj/ поруч із .git/. Твої .git/, гілки й історія залишаються як є.
• .jj/ ховає себе від git status власним ignore-файлом. .gitignore твого проєкту не змінюється, тож нового для коміту нічого немає.
• Для твоїх колег нічого не змінюється. Вони й далі користуються Git; ти надсилаєш звичайні Git-коміти й гілки.
• У тій самій теці можна й далі запускати git. Очікуй, що git status повідомить про від’єднаний HEAD: так jj і Git ділять одну теку.

2. Прочитай журнал

Журнал — це твоя історія у вигляді графа, найновіше вгорі. Кожен рядок — це коміт: його change ID, опис, автор і вік. Рядок із зеленим ореолом — це @, твоя робоча копія. У jj файли, які ти редагуєш, завжди є комітом, тож окремої зони «незакомічених змін» немає.

Клацни рядок, щоб побачити його зміни на панелі ревізії. Клавішами ↑ / ↓ переміщайся журналом, а G повертає до @. Більше — у Граф журналу.

3. Внеси зміну

Відредагуй файл у своєму редакторі й збережи. Wyrm підхопить зміну в @; рядок оновиться, а файл з’явиться серед його змін. Нічого додавати в індекс (stage) не треба.

4. Опиши її

Вибери @ і введи повідомлення в поле Опишіть цю зміну… на панелі ревізії, а потім натисни ↩, щоб зберегти. D відкриває те саме у вигляді діалогу Редагувати опис.

Коли зміну завершено, натисни ⌘↩ (або клацни Завершити зміну). Це запускає jj commit: повідомлення лишається на цьому коміті, а зверху починається новий порожній @ для наступної роботи. Щоб почати новий коміт поверх будь-якого іншого, вибери його й натисни N (або ⌘N, Новий нащадок).

5. Зроби push із попереднім переглядом

На Git-віддалені надсилаються bookmarks (так у jj називаються гілки).

1. Вибери щойно завершений коміт і натисни B (Створити закладку…). Дай йому назву, наприклад fix-typo.
2. Клацни Push на верхній панелі. Поки що нічого не надсилається: Wyrm відкриває Надіслати до origin і показує кожен bookmark з тим, що з ним станеться: Нова, Оновлення, Видалення або Розбіжна, якщо твій bookmark і віддалений розійшлися.
3. Переглянь і клацни Надіслати 1 закладку.

Попередній перегляд порівнює зі станом після останнього fetch, тож спершу клацни Fetch, якщо колеги могли щось надіслати. Подробиці — у Попередній перегляд push. Щоб відкрити pull request із bookmark, дивись Pull і merge requests.

6. Скасуй

Клацни Undo на верхній панелі або натисни ⌘Z. У jj скасування працює з операціями: describe, rebase, abandon. Undo не повертає коміти, які вже є на віддаленому репозиторії. Кожне скасування відступає ще на крок назад, а ⌘⇧Z повторює. Панель Операції на панелі значків показує кожну операцію, і ти можеш відновити репозиторій до будь-якої з них. Дивись Скасування та журнал операцій.

Наступні кроки

• Git → jj, крок за кроком: кожна звичка з Git поруч із її відповідником у jj.
• Редагування історії: split, squash, absorb і перенесення змін.
• Клавіатурні скорочення: натисни ? у застосунку, щоб побачити той самий список.