3.4 KiB
GIT to narzędzie do współpracy nad plikami. Pozwala na wygodne współdzielenie, aktualizowanie i komentowanie pomysłów. Oto instrukcja pracy:
1. Pierwsze logowanie
- Otwórz przeglądarkę internetową i przejdź na adres:
http://150.254.88.90:3000 - Zaloguj się swoim adresem uczelnianym (np. pawkle1@st.amu.edu.pl) jako login.
- Hasło początkowe (do zmiany przy pierwszym logowaniu):
HakerzyZnają - Po zalogowaniu ustaw swoje imię, nazwisko oraz avatar w ustawieniach profilu.
2. Repozytoria
- Po zalogowaniu kliknij Odkrywaj.
- Otwórz repozytorium.
- Możesz edytować i przeglądać pliki, README, literaturę lub materiały przez stronę www.
3. Pierwsze pobieranie repozytorium na komputer
Repozytorium możesz obsługiwać w terminalu lub przez aplikację graficzną (np. GitHub Desktop lub Sourcetree).
Terminal (macOS/Linux/Windows PowerShell):
# wejdż w terminalu do katalogu na swoim komputerze w którym chcesz mieć repozytorium np.:
cd <tutaj_ścieżka_do_katalogu>
# wykonaj polecenie:
git clone http://150.254.88.90:3000/PKleka/Metaanaliza_JiM.git
# jeśli pojawi sie info o braku uwierzytelnienia - zaloguj sie do repozytorium w przeglądarce
# jesli nie masz programu git ściągnij go ze strony https://git-scm.com/install/
4. Wprowadzanie zmian
Proces codziennej pracy wygląda następująco:
-
Aktualizuj katalog przed rozpoczęciem pracy:
git pullTo pozwala pobrać wszystkie najnowsze zmiany dodane przez innych. Jeśli pojawi się konflikt, Git poinformuje, które pliki wymagają ręcznej poprawy.
-
Edytuj lub dodaj plik (np. swój nowy pomysł w oddzielnym pliku
.md, możesz też uzupełnić istniejący plik). -
Skopiuj wybrane pliki (np. notatki, dane, skrypt R) do lokalnego katalogu repozytorium.
-
Dodaj pliki do zapisu:
git add NAZWA-TWOJEGO-PLIKU.md
Możesz dodać wiele plików na raz lub użyć git add . żeby dodać wszystkie zmienione pliki w katalogu.
git add . # dodaje wszystkie pliki na listę do wysyłki
git commit -m "Dodano pierwszą wersję pliku" # ustala komentarz
git push origin main # wysyła pliki do repozytorium na główną gałąź
-
Zatwierdź (zapisz) zmiany z komentarzem:
git commit -m "Opis zmiany, np. Dodano pomysł X" -
Wyślij zmiany do wspólnego repozytorium:
git push origin main -
Sprawdź na stronie (zakładka Code), czy plik pojawił się w repozytorium.
5. Sprawdzanie statusu pracy
Pokazuje zmodyfikowane lokalnie pliki oraz pliki oczekujące na zatwierdzenie:
git status
Historia commitów:
git log --oneline
6. Typowe błędy
- Merge conflict – dwie osoby edytowały ten sam plik; Git wyświetli różnice i pozwoli je rozwiązać.
- Brak zmian w Git po
git push– sprawdź, czy jesteś w odpowiednim katalogu repozytorium oraz na właściwej gałęzi (git branch).
7. Dobre praktyki
- Przed edycją zawsze wykonaj
git pull. - Używaj opisowych wiadomości commitów.
- Nie wysyłaj plików tymczasowych (.Rhistory, .RData) ani dużych plików binarnych.
- W pliku README regularnie zapisuj postępy i refleksje dotyczące projektu.
Wskazówka:
Jeśli zapomnisz hasła lub napotkasz problem techniczny, skontaktuj się z prowadzącym.