kleka
104 lines
3.4 KiB
Markdown
104 lines
3.4 KiB
Markdown
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
|
||
|
||
1. Otwórz przeglądarkę internetową i przejdź na adres:
|
||
**http://150.254.88.90:3000**
|
||
2. Zaloguj się swoim adresem uczelnianym (np. **pawkle1@st.amu.edu.pl**) jako login.
|
||
3. Hasło początkowe (do zmiany przy pierwszym logowaniu):
|
||
**HakerzyZnają**
|
||
4. Po zalogowaniu ustaw swoje imię, nazwisko oraz avatar w ustawieniach profilu.
|
||
|
||
***
|
||
### 2. Repozytoria
|
||
|
||
1. Po zalogowaniu kliknij **Odkrywaj.**
|
||
2. Otwórz repozytorium.
|
||
3. 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):**
|
||
|
||
```bash
|
||
# 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:
|
||
|
||
1. **Aktualizuj katalog przed rozpoczęciem pracy**:
|
||
```bash
|
||
git pull
|
||
```
|
||
To pozwala pobrać wszystkie najnowsze zmiany dodane przez innych. Jeśli pojawi się konflikt, Git poinformuje, które pliki wymagają ręcznej poprawy.
|
||
|
||
2. **Edytuj lub dodaj plik** (np. swój nowy pomysł w oddzielnym pliku `.md`, możesz też uzupełnić istniejący plik).
|
||
3. Skopiuj wybrane pliki (np. notatki, dane, skrypt R) do lokalnego katalogu repozytorium.
|
||
|
||
4. **Dodaj pliki do zapisu**:
|
||
```bash
|
||
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.
|
||
```bash
|
||
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łąź
|
||
```
|
||
|
||
5. **Zatwierdź (zapisz) zmiany z komentarzem**:
|
||
```bash
|
||
git commit -m "Opis zmiany, np. Dodano pomysł X"
|
||
```
|
||
|
||
6. **Wyślij zmiany do wspólnego repozytorium**:
|
||
```bash
|
||
git push origin main
|
||
```
|
||
|
||
7. 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:
|
||
|
||
```bash
|
||
git status
|
||
```
|
||
|
||
Historia commitów:
|
||
|
||
```bash
|
||
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. |