Szybki start

Zakładamy, że Wyrm jest zainstalowany i że jesteś zalogowany. Skróty dotyczą macOS.

1. Otwórz repozytorium

Po zalogowaniu Wyrm pokazuje Otwórz repozytorium, aby rozpocząć z trzema przyciskami:

• Otwórz… (⌘O): folder, który już masz, z Gitem lub jj.
• Klonuj… (⌘⇧O): skopiuj na swojego Maca repozytorium z GitHuba, GitLaba lub dowolnego adresu URL Git.
• Nowe repozytorium… (⌘⇧N): utwórz nowe repozytorium w pustym lub istniejącym folderze.

Twoje istniejące repozytorium Git

Gdy otworzysz zwykły folder Git, Wyrm najpierw zapyta w oknie Wykryto repozytorium Git: „To jest repozytorium Git. Wyrmflow zainicjuje jujutsu obok Gita, dzięki czemu będziesz mógł korzystać z obu narzędzi.” Kliknij Otwórz repozytorium.

Co to robi:

• Tworzy folder .jj/ obok .git/. Twój .git/, gałęzie i historia pozostają bez zmian.
• .jj/ ukrywa się przed git status za pomocą własnego pliku ignore. Plik .gitignore Twojego projektu nie jest zmieniany, więc nie ma nic nowego do zacommitowania.
• Dla Twoich współpracowników nic się nie zmienia. Nadal używają Gita; to, co wypychasz, to zwykłe commity i gałęzie Git.
• W tym samym folderze nadal możesz uruchamiać git. Spodziewaj się, że git status zgłosi odłączony HEAD: tak jj i Git dzielą jeden folder.

2. Odczytaj log

Log to Twoja historia w postaci grafu, z najnowszymi commitami na górze. Każdy wiersz to commit: jego change ID, opis, autor i wiek. Wiersz z zieloną poświatą to @, Twoja kopia robocza. W jj pliki, które edytujesz, zawsze są commitem, więc nie ma osobnego obszaru „niezacommitowanych zmian”.

Kliknij wiersz, aby zobaczyć jego zmiany w panelu rewizji. Klawiszami ↑ / ↓ poruszasz się po logu, a G wraca do @. Więcej w Grafie logu.

3. Wprowadź zmianę

Edytuj plik w swoim edytorze i zapisz go. Wyrm wciąga zmianę do @; wiersz się aktualizuje, a plik pojawia się wśród jego zmian. Nie ma niczego do dodawania do stage.

4. Opisz ją

Zaznacz @ i wpisz komunikat w pole Opisz tę zmianę… w panelu rewizji, a potem naciśnij ↩, aby go zapisać. D otwiera to samo jako okno dialogowe Edytuj opis.

Gdy zmiana jest gotowa, naciśnij ⌘↩ (albo kliknij Zakończ zmianę). To uruchamia jj commit: zachowuje Twój komunikat w tym commicie i tworzy na wierzchu nowe, puste @ na kolejną porcję pracy. Aby rozpocząć nowy commit na wierzchu dowolnego innego commita, zaznacz go i naciśnij N (albo ⌘N, Nowe dziecko).

5. Wypchnij ją z podglądem

Na zdalne repozytoria Git wypycha się bookmarki (tak jj nazywa gałęzie).

1. Zaznacz commit, który właśnie zakończyłeś, i naciśnij B (Utwórz zakładkę…). Nadaj bookmarkowi nazwę, np. fix-typo.
2. Kliknij Push na górnym pasku. Jeszcze nic nie zostaje wysłane: Wyrm otwiera Wypchnij do origin i wypisuje każdy bookmark z informacją, co się z nim stanie: Nowa, Aktualizacja, Usunięcie albo Rozbieżna, jeśli Twój bookmark i zdalny rozeszły się w różne strony.
3. Przeczytaj to, a potem kliknij Wypchnij 1 zakładkę.

Podgląd porównuje stan z ostatnim fetchem, więc jeśli współpracownicy mogli coś wypchnąć, najpierw kliknij Fetch. Szczegóły w Podglądzie push. Aby otworzyć pull request z tego bookmarka, zobacz Pull i merge requesty.

6. Cofnij

Kliknij Undo na górnym pasku albo naciśnij ⌘Z. W jj cofanie działa na operacjach: opisaniu, rebase, porzuceniu. Cofanie nie wycofuje commitów, które są już na zdalnym repozytorium. Każde cofnięcie sięga o krok dalej, a ⌘⇧Z ponawia. Panel Operacje na pasku ikon wypisuje każdą operację i możesz przywrócić repozytorium do dowolnej z nich. Zobacz Cofanie i log operacji.

Kolejne kroki

• Git → jj, krok po kroku: każdy nawyk z Gita obok jego odpowiednika w jj.
• Edycja historii: dziel, rób squash, absorb i przenoś zmiany.
• Skróty klawiszowe: naciśnij ? w aplikacji, aby zobaczyć tę samą listę.