Ghid rapid pentru utilizarea Github

Acest tutorial este un ghid rapid pentru instalarea și utilizarea GitHub. Iată cum să creați un depozit local, cum să conectați acest depozit local la depozitul Github la distanță (unde toată lumea îl poate vedea), cum să comiteți modificări și, în cele din urmă, cum să împingeți tot conținutul depozitului local pe GitHub, printre alte sarcini obișnuite.

Înainte de a începe, este important de reținut că acest tutorial presupune o înțelegere de bază a termenilor folosiți în Git: push, pull, commit, repository etc. De asemenea, necesită înregistrare prealabilă în GitHub.

Instalarea Github

Pe Debian / Ubuntu și derivate:

sudo apt-get instalați git

En Fedora și derivate:

sudo yum instalează git

En Arc și derivate:

sudo pacman -s git

Configurare inițială Github

Odată ce instalarea sa finalizat cu succes, următorul pas este configurarea detaliilor de configurare a utilizatorului GitHub. Pentru a face acest lucru, utilizați următoarele comenzi, înlocuind „nume de utilizator” cu numele dvs. de utilizator GitHub și „email_id” cu adresa de e-mail utilizată pentru a crea contul GitHub.

git config --global user.name "nume de utilizator" git config --global user.email "email_id"

Creați un depozit local

Primul lucru este să creați un folder pe computer, care va servi ca depozit local. Pentru aceasta, rulați următoarea comandă:

git init mytest

Această comandă creează folderul MyTest. La rândul său, sub-folderul .init face MyTest recunoscut ca un depozit Git local.

Dacă depozitul este creat cu succes, va apărea o linie similară cu următoarea:

Depozitul Git gol inițializat în /home/tu_usuario/Mytest/.git/

Apoi, trebuie să accesați folderul MyTest:

CD MyTest

Creați un fișier README pentru a descrie depozitul

Fișierul README este utilizat în general pentru a descrie ce conține depozitul sau despre ce este proiectul. Pentru a crea una, rulați:

GEDIT README

După ce ați introdus descrierea depozitului, nu uitați să salvați modificările.

Adăugarea fișierelor depozit la un index

Acesta este un pas important. Înainte de a putea încărca modificările pe Github sau pe alt server compatibil Git, trebuie să indexați toate fișierele conținute în depozitul local. Acest index va conține noile fișiere, precum și modificările aduse fișierelor existente în depozitul local.

În cazul nostru, depozitul nostru local conține deja un fișier nou: README. Prin urmare, vom crea un alt fișier cu un program C simplu și pe care îl vom numi example.c. Conținutul său va fi:

#include int main () {printf ("hello world"); retur 0; }

Deci, acum avem 2 fișiere în depozitul nostru local: README și example.c.

Următorul pas este să adăugați aceste fișiere la index:

git add README git add smaple.c

Comanda „git add” poate fi utilizată pentru a adăuga la index orice număr de fișiere și foldere. Pentru a adăuga toate modificările, fără a specifica numele fișierelor, este posibil să executați „git add”. (cu un punct la sfârșit).

Salvați modificările aduse indexului

Odată ce toate fișierele au fost adăugate, este posibil să lăsați o evidență a acestor modificări făcând ceea ce în jargon se numește „commit”. Aceasta înseamnă că adăugarea sau modificarea fișierelor a fost finalizată și modificările pot fi încărcate în depozitul Github la distanță. Pentru a face acest lucru, trebuie să executați următoarea comandă:

git commit -m "mesaj"

„Mesaj” poate fi orice mesaj care descrie pe scurt modificările în cauză, de exemplu: „Am adăugat o astfel de funcționalitate” sau „Am corectat așa ceva” și așa mai departe.

Creați un depozit pe GitHub

Numele depozitului trebuie să fie același cu depozitul de pe sistemul local. În acest caz, va fi „MyTest”. Pentru a face acest lucru, mai întâi de toate, trebuie să vă conectați la Github. Apoi, trebuie să faceți clic pe semnul plus (+) din colțul din dreapta sus al paginii și să selectați opțiunea „creați un nou depozit”. În cele din urmă, trebuie să completați datele și să faceți clic pe butonul „creați depozit”.

Odată ce acest lucru este făcut, depozitul va fi creat și va fi posibil să încărcați conținutul depozitului local în depozitul GitHub. Pentru a vă conecta la depozitul la distanță de pe GitHub trebuie să executați comanda:

Git Remote Adăugare origine https://github.com/user_name/mytest.git

Împingeți fișierele din depozitul local în depozitul GitHub

Ultimul pas este de a împinge conținutul depozitului local la depozitul la distanță, folosind comanda:

git push master de origine

Rămâne doar să introduceți datele de conectare (nume de utilizator și parolă).

Aceasta va încărca tot conținutul folderului MyTest (depozit local) în GitHub (depozit extern). Pentru proiectele ulterioare, nu mai trebuie să urmați acești pași de la zero. În schimb, puteți începe direct de la pasul 3. În cele din urmă, nu uitați că modificările vor fi disponibile de pe site-ul Github.

Crearea unei ramuri

Atunci când dezvoltatorii doresc să remedieze erorile sau să adauge funcții noi, deseori creează o ramură sau o copie a codului, astfel încât să poată comite separat, fără a afecta proiectul original. Apoi, când au terminat, pot fuziona această ramură înapoi în ramura principală (master).

Pentru a crea o nouă ramură există două opțiuni:

Opțiune lungă:

git branch mirama # creați o nouă ramură numită mirama git checkout mirama - comutați la utilizarea ramurii mirama.

Opțiune scurtă:

git checkout -b mirama - creați și treceți la utilizarea ramurii mirama

Odată ce modificările sunt făcute, adăugați-le la indexul ramurii și efectuați validarea corespunzătoare:

git add. git commit -m "schimbări în mirama"

Apoi, trebuie să vă întoarceți la ramura principală și să luați modificările făcute în mirama:

git checkout master git merge mirama

În cele din urmă, trebuie să ștergeți mirama (deoarece modificările au fost încorporate în master):

ramură git -d mirama

Și încărcați masterul pe Github:

git push master de origine

Crearea unui depozit Git derivat (furculiță)

Datorită Git și existenței unor mari biblioteci de depozite publice, cum ar fi Github, de cele mai multe ori nu este necesar să începem programarea proiectului nostru de la zero. În aceste cazuri, este posibil să luați acest cod de bază pentru a crea un nou proiect.

Pentru a face acest lucru, primul lucru de făcut este o bifurcație a unui depozit existent, adică un proiect derivat din acesta care ia codul proiectului original ca bază. Pe Github, acest lucru se realizează făcând clic pe butonul corespunzător, așa cum se vede în captura de ecran de mai jos.

Apoi, ceea ce trebuie să facem este să clonăm depozitul acestui nou proiect pe computerul nostru. De exemplu, putem folosi depozitul meu Ankifox, o extensie pentru Firefox care permite adăugarea de cuvinte la Anki, care este disponibil pe Github:

Git Clone https://github.com/usemoslinux/ankifox.git

Nu uitați să înlocuiți https://github.com/usemoslinux/Ankifox.git cu adresa URL corespunzătoare proiectului dvs. Obținerea acestei adrese este foarte ușoară, așa cum se vede în imaginea de mai jos.

Această comandă va crea un director numit «Ankifox», va inițializa directorul .git din cadrul acestuia și va descărca toate datele din acel depozit, pentru a lucra cu cea mai recentă versiune.