Git i GitHub — od zera

Część 1 — GitHub przez przeglądarkę

Na start nie potrzebujesz żadnego programu na komputerze — wszystko idzie przez stronę github.com, w przeglądarce. Instalowanie i używanie samego Gita z terminala to część 2 tego dokumentu, wraca później w roku.

Krok 1: Załóż konto

1. Wejdź na github.com.
2. Kliknij Sign up w prawym górnym rogu.
3. Podaj adres e-mail, hasło i nazwę użytkownika (username) — ta nazwa będzie widoczna publicznie i będzie częścią twojego adresu, więc wybierz coś, czego nie będzie ci wstyd pokazać. Nie musi to być twoje imię i nazwisko.
4. Potwierdź konto przez link wysłany na maila.

Krok 2: Skopiuj repo-szablon

Nauczyciel poda ci link do repozytorium-szablonu (np. github.com/mpeciakk/budul-o-mnie).

1. Wejdź pod ten link.
2. Zobaczysz zielony przycisk Use this template (nad listą plików, po prawej). Kliknij go, potem Create a new repository.
3. Na stronie tworzenia: jako Owner zostaw swoje konto, jako Repository name wpisz cokolwiek sensownego (np. o-mnie).
4. Zostaw zaznaczone Public (nie Private) — chcesz, żeby twoja strona była widoczna.
5. Kliknij zielony przycisk Create repository.

Od tej chwili to jest twoje własne repozytorium, pod twoim kontem — nikt inny nie może w nim nic zmienić bez twojej zgody.

Krok 3: Włącz GitHub Pages (żywy adres)

Zanim zaczniesz edytować plik, włącz publiczny adres dla swojej strony — to jednorazowa czynność.

1. W swoim repozytorium wejdź w zakładkę Settings (na górze, obok Code/Issues/Pull requests).
2. Po lewej znajdź Pages.
3. Przy Source wybierz Deploy from a branch, a przy Branch wybierz main i folder / (root).
4. Kliknij Save.

Po minucie-dwóch twoja strona będzie dostępna pod adresem w formacie:

https://twoja-nazwa-uzytkownika.github.io/nazwa-repo/o-mnie.html

Ten adres nie zmieni się już do końca roku — możesz go zapisać i wysyłać znajomym.

Krok 4: Edytuj plik przez przeglądarkę

1. W repozytorium kliknij na plik o-mnie.html.
2. Kliknij ikonę ołówka (Edit this file) w prawym górnym rogu podglądu pliku.
3. Zmień treść pliku wprost w oknie przeglądarki.
4. Zjedź na sam dół strony. Zobaczysz pole Commit changes — możesz tam wpisać krótki opis zmiany (np. “dodałem nagłówki”), ale nie musisz.
5. Kliknij zielony przycisk Commit changes.

To jest push — twoja zmiana trafia od razu na GitHuba i (po chwili) na twój żywy adres z Kroku 3.

Sprawdzenie efektu

Po każdej zmianie odśwież stronę pod adresem z Kroku 3 (czasem trzeba poczekać do minuty, zanim GitHub Pages się zaktualizuje). To jest realny, publiczny adres — dokładnie to, co widzi każdy, kto go otworzy, nie tylko ty.

---

Część 2 — Git na własnym komputerze (na później)

Ta część wraca w roku później, kiedy zaczniemy pracować z plikami lokalnie, nie tylko przez przeglądarkę. Zostaje tu jako punkt odniesienia, nie coś do zrobienia teraz.

Czym różni się to od Części 1

W Części 1 GitHub sam pilnował historii zmian za ciebie — każdy “Commit changes” w przeglądarce robił to, co robi Git na twoim komputerze. Tutaj robisz te same kroki ręcznie, komendami.

Podstawowe komendy

Komenda	Co robi
git clone <adres-repo>	Ściąga repozytorium z GitHuba na twój dysk, do nowego folderu
git status	Pokazuje, co się zmieniło od ostatniego zapisania
git add <plik> (albo git add . dla wszystkiego)	Oznacza plik jako gotowy do zapisania
git commit -m "opis zmiany"	Zapisuje oznaczone zmiany, z opisem, lokalnie na dysku
git push	Wysyła zapisane zmiany z twojego dysku na GitHuba
git pull	Ściąga zmiany z GitHuba, jeśli coś się zmieniło zdalnie

Typowy cykl pracy

1. git pull — upewnij się, że masz najnowszą wersję.
2. Zmień pliki w swoim edytorze.
3. git add .
4. git commit -m "co zmieniłem"
5. git push

Częsty błąd na start

git push odrzucony z komunikatem o rozbieżnej historii — zwykle znaczy, że zapomniałeś zrobić git pull przed zmianami. Rozwiązanie i szczegóły: na zajęciach, kiedy ta część faktycznie wchodzi do programu.