Differences
This shows you the differences between two versions of the page.
|
irva:resurse:gitguide [2024/10/07 13:49] andrei.lapusteanu typos |
irva:resurse:gitguide [2025/10/07 00:23] (current) andrei.lapusteanu Fixed typos |
||
|---|---|---|---|
| Line 3: | Line 3: | ||
| Pentru a vă ușura munca în cadrul laboratoarelor de IRVA, vă recomandăm să lucrați cu Git & GitHub. | Pentru a vă ușura munca în cadrul laboratoarelor de IRVA, vă recomandăm să lucrați cu Git & GitHub. | ||
| - | Laboratoarele de AR și VR for avea fiecare un repository pe GitHub - întrucât este posibil ca repo-urile să mai primească actualizări pe parcursul semestrului, ar fi ideal să urmați pașii descriși în acest ghid pentru a nu fi nevoie să va clonați / descărcați de multiple ori proiectul. | + | Laboratoarele de AR și VR for avea un repository pe GitHub - întrucât este posibil ca repo-urile să mai primească actualizări pe parcursul semestrului, ar fi ideal să urmați pașii descriși în acest ghid pentru a nu fi nevoie să vă clonați / descărcați de multiple ori proiectul. |
| - | Link-uri către repo-uri: | + | <note>Link către [[https://github.com/UPB-Graphics/IRVA|Git repo]]</note> |
| - | * Repo AR: <LINK> (link_repo_original_ar) | + | |
| - | * Repo VR: <LINK> (link_repo_original_vr) | + | |
| - | ===== Instalare Git ===== | ||
| Înainte de toate, asigurați-vă că aveți Git instalat, acesta se poate descărca de [[https://git-scm.com|aici]]. | Înainte de toate, asigurați-vă că aveți Git instalat, acesta se poate descărca de [[https://git-scm.com|aici]]. | ||
| Line 17: | Line 14: | ||
| De asemenea, asigurați-vă că aveți un cont de GitHub creat. | De asemenea, asigurați-vă că aveți un cont de GitHub creat. | ||
| + | |||
| + | Nu uitați să vă instalați și [[https://git-lfs.com|Git LFS]]. | ||
| ===== Setup repo local (fork) ===== | ===== Setup repo local (fork) ===== | ||
| - | Procedura recomandată pentru a putea lucra într-un singur repo este următoarea: | + | Procedura recomandată pentru a putea lucra într-un singur repo clonat pe sistemul vostru este următoarea: |
| * Realizați un **fork** al repo-ului original / referință | * Realizați un **fork** al repo-ului original / referință | ||
| * Vă **clonați** fork-ul, pe care puteți apoi lucra pentru a rezolva laboratoarele | * Vă **clonați** fork-ul, pe care puteți apoi lucra pentru a rezolva laboratoarele | ||
| - | * În cazul unor actualizări pe repo-ul original (de ex. actualizăm noi repo-ul pentru un laborator nou), voi vă trageți (**pull**) aceste modificări în fork și în același timp mențineți modificările voastre | + | * În cazul unor actualizări pe repo-ul original (de exemplu actualizăm repo-ul pentru un laborator nou), voi vă trageți (**pull**) aceste modificări în fork și în același timp mențineți modificările voastre |
| În continuare vă prezentăm procedura pentru a face setup-ul necesar. | În continuare vă prezentăm procedura pentru a face setup-ul necesar. | ||
| Line 40: | Line 39: | ||
| De pe repo-ul forked copiați link-ul către repo (butonul verde ''Code''). | De pe repo-ul forked copiați link-ul către repo (butonul verde ''Code''). | ||
| - | În Git Bash, rulați comanda (atenție, schimbați voi comanda după necesitate) | + | În Git Bash, rulați comanda: |
| <code> | <code> | ||
| + | git clone https://github.com/UPB-Graphics/IRVA.git | ||
| + | </code> | ||
| - | // Repo AR | + | <note tip> |
| - | git clone https://github.com/<username>/<nume_repo_ar_WIP> | + | * Puteți să clonați via SSH ''git@github.com:UPB-Graphics/IRVA.git'' |
| - | + | * [[https://medium.com/@kyledeguzmanx/quick-step-by-step-guide-to-generating-an-ssh-key-in-github-d3c6f7e185bb|Setup Git SSH]] | |
| - | // Repo VR | + | </note> |
| - | git clone https://github.com/<username>/<nume_repo_vr_WIP> | + | |
| - | + | ||
| - | </code> | + | |
| == 3. Adăugare upstream către repo-ul original == | == 3. Adăugare upstream către repo-ul original == | ||
| - | Acest pas este necesar pentru a putea primi actualizări în fork-ul vostru. Pentru a urmări repo-ul original, rulați urmatoarea comanda Git (atenție, schimbați voi comanda după necesitate): | + | Acest pas este necesar pentru a putea primi actualizări în fork-ul vostru. Pentru a urmări repo-ul original, rulați urmatoarea comanda Git: |
| <code> | <code> | ||
| - | git remote add upstream <link_repo_original_ar_sau_vr> | + | git remote add upstream https://github.com/UPB-Graphics/IRVA.git |
| </code> | </code> | ||
| Line 64: | Line 62: | ||
| == 4. Cum pot lucra pe fork și să aplic schimbările mele (local)? == | == 4. Cum pot lucra pe fork și să aplic schimbările mele (local)? == | ||
| - | Puteți lucra în mod obișnui pe repo-ul forked (local). În cazul în care doriți să-l actualizați, de exemplu în urma rezolvării unui laborator, puteți rula: | + | Puteți lucra în mod obișnuit pe repo-ul forked (local). În cazul în care doriți să-l actualizați, de exemplu în urma rezolvării unui laborator, faceți referire la următorii pași. |
| Pentru a face staging - anume, pentru a specifica fișierele pe care dorim să le supunem unui commit: | Pentru a face staging - anume, pentru a specifica fișierele pe care dorim să le supunem unui commit: | ||
| Line 106: | Line 104: | ||
| Fie comanda | Fie comanda | ||
| <code> | <code> | ||
| - | git merge upstream/master | + | git merge upstream/main |
| </code> | </code> | ||
| Line 112: | Line 110: | ||
| <code> | <code> | ||
| - | git pull upstream master | + | git pull upstream main |
| </code> | </code> | ||
| Line 118: | Line 116: | ||
| <code> | <code> | ||
| - | git pull upstream master | + | git pull upstream main |
| </code> | </code> | ||
| Line 127: | Line 125: | ||
| Pentru a ieși din acest mod rulați '':q''. | Pentru a ieși din acest mod rulați '':q''. | ||
| - | Dacă acum rulați comanda ''git status'' ar trebui să primiți un mesaj care va informează că varianta voastra locală este în urmă. Pentru a aplica modificările, rulați: | + | Dacă acum rulați comanda ''git status'' ar trebui să primiți un mesaj care vă informează că varianta voastră locală este în urmă. Pentru a aplica modificările, rulați: |
| <code> | <code> | ||
| Line 139: | Line 137: | ||
| </code> | </code> | ||
| - | În mod alternativ, există tool-uri vizuale ce vă ajută să studiați aceast istoric, noi recomandăm: | + | În mod alternativ, există tool-uri vizuale ce vă ajută să studiați acest istoric, noi recomandăm: |
| * GitKraken | * GitKraken | ||
| * JetBrains Rider | * JetBrains Rider | ||
