Kratek vodnik za uporabo Githuba

Ta vadnica je kratek vodnik za namestitev in uporabo GitHub. Tukaj je opisano, kako ustvariti lokalno repozitorij, kako povezati to lokalno repozitorij z oddaljenim repozitoriju Github (kjer ga lahko vidijo vsi), kako narediti spremembe in na koncu, kako med drugimi običajnimi nalogami potisniti vso vsebino lokalnega repozitorija na GitHub. .

Pred začetkom je pomembno opozoriti, da ta vadnica predpostavlja osnovno razumevanje izrazov, uporabljenih v Gitu: push, pull, commit, repozitorij itd. Zahteva tudi predhodno registracijo pri GitHub.

Namestitev Github

Za Debian / Ubuntu in izpeljanke:

sudo apt-get namestite git

En Fedora in izvedeni finančni instrumenti:

sudo yum namestite git

En Arch in izvedeni finančni instrumenti:

sudo pacman -S git

Začetna nastavitev Githuba

Ko se namestitev uspešno zaključi, je naslednji korak konfiguriranje podrobnosti konfiguracije uporabnika GitHub. Če želite to narediti, uporabite naslednje ukaze in nadomestite "uporabniško ime" z vašim uporabniškim imenom za GitHub in "email_id" z e-poštnim naslovom, uporabljenim za ustvarjanje računa GitHub.

git config --global user.name "uporabniško ime" git config --global user.email "email_id"

Ustvarite lokalni repozitorij

Prva stvar je, da v računalniku ustvarite mapo, ki bo služila kot lokalno skladišče. Če želite to narediti, zaženite naslednji ukaz:

git init Mytest

Ta ukaz ustvari mapo MyTest. Podmapa .init pa MyTest prepozna kot lokalno shrambo Git.

Če je repozitorij uspešno ustvarjen, se prikaže vrstica, podobna naslednji:

Inicializirano prazno repozitorij Git v /home/tu_usuario/Mytest/.git/

Nato morate odpreti mapo MyTest:

cd Mytest

Ustvari datoteko README, da opišeš skladišče

Datoteka README se običajno uporablja za opisovanje, kaj vsebuje skladišče ali kaj gre za projekt. Če ga želite ustvariti, preprosto zaženite:

gedit PREBERI

Ko vnesete opis skladišča, ne pozabite shraniti sprememb.

Dodajanje datotek repozitorija v indeks

To je pomemben korak. Preden lahko svoje spremembe naložite v Github ali drug strežnik, združljiv z Git, morate indeksirati vse datoteke v lokalnem repozitoriju. Ta indeks bo vseboval nove datoteke in spremembe obstoječih datotek v lokalnem repozitoriju.

V našem primeru naš lokalni repozitorij že vsebuje novo datoteko: README. Zato bomo ustvarili novo datoteko s preprostim programom C, ki jo bomo imenovali example.c. Njegova vsebina bo:

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

Zdaj imamo v našem lokalnem repozitoriju dve datoteki: README in example.c.

Naslednji korak je dodati te datoteke v indeks:

git add README git add smaple.c

Z ukazom "git add" lahko v indeks dodate poljubno število datotek in map. Če želite dodati vse spremembe, ne da bi navedli ime datotek, lahko izvedete "git add." (s piko na koncu).

Shrani spremembe indeksa

Ko so vse datoteke dodane, lahko o teh spremembah zapišete tako, da v žargonu poimenujete "prevzem". To pomeni, da je bilo dodajanje ali spreminjanje datotek končano in spremembe lahko naložite v oddaljeno skladišče Github. Če želite to narediti, morate izvesti naslednji ukaz:

git commit -m "sporočilo"

"Sporočilo" je lahko vsako sporočilo, ki na kratko opisuje zadevne spremembe, na primer: "Dodal sem takšno funkcionalnost" ali "Takšno stvar sem popravil" itd.

Ustvarite repozitorij na GitHub

Ime repozitorija mora biti enako repozitoriju v lokalnem sistemu. V tem primeru bo "MyTest". Za to se morate najprej prijaviti GitHub. Nato v zgornjem desnem kotu strani kliknite znak plus (+) in izberite možnost "ustvari novo skladišče". Na koncu morate izpolniti podatke in klikniti na gumb "ustvari repozitorij".

Ko bo to končano, bo repozitorij ustvarjen in vsebino lokalnega repozitorija bo mogoče naložiti v repozitorij GitHub. Če se želite povezati z oddaljenim skladiščem na GitHub, morate zagnati ukaz:

git remote dodaj izvor https://github.com/user_name/Mytest.git

Potisnite datoteke iz lokalnega repozitorija v repozitorij GitHub

Zadnji korak je potiskanje vsebine lokalnega repozitorija v oddaljeno repozitorij z uporabo ukaza:

git push master master

Ostane le še vpis poverilnic za prijavo (uporabniško ime in geslo).

To bo naložilo vso vsebino mape MyTest (lokalno repozitorij) v GitHub (zunanje repozitorij). Pri nadaljnjih projektih vam ni treba več slediti tem korakom. Namesto tega lahko začnete s korakom 3 neposredno. Na koncu ne pozabite, da bodo spremembe na voljo na spletnem mestu Github.

Ustvarjanje podružnice

Ko želijo razvijalci popraviti napake ali dodati nove funkcije, pogosto ustvarijo vejo ali kopijo kode, da se lahko ločijo ločeno, ne da bi to vplivalo na prvotni projekt. Potem, ko končajo, lahko to vejo združijo nazaj v glavno vejo (master).

Obstajata dve možnosti za ustvarjanje nove veje:

Dolga možnost:

git podružnica mirama # ustvarite novo podružnico z imenom mirama git checkout mirama - preklopite na uporabo podružnice mirama.

Kratka možnost:

git checkout -b mirama - ustvarite in preklopite na uporabo podružnice mirama

Ko so spremembe izvedene, jih dodajte indeksu vej in izvedite ustrezen prevzem:

git add. git commit -m "spremembe v mirami"

Nato se morate vrniti v glavno vejo in sprejeti spremembe, narejene v mirami:

git checkout master git merge mirama

Na koncu morate izbrisati miramo (saj so bile spremembe vključene v master):

git podružnica -d mirama

In naložite master v Github:

git push master master

Ustvarjanje izpeljanega repozitorija Git (fork)

Zahvaljujoč Gitu in obstoju velikih knjižnic javnih skladišč, kot je Github, večino časa ni treba začeti programirati našega projekta iz nič. V teh primerih je mogoče to osnovno kodo uporabiti za ustvarjanje novega projekta.

Če želite to narediti, najprej naredite vilico obstoječega repozitorija, to je projekt, izpeljan iz njega, ki za osnovo vzame kodo prvotnega projekta. Na Githubu to dosežemo s klikom ustreznega gumba, kot je razvidno iz spodnjega posnetka zaslona.

Nato moramo v svojem računalniku klonirati odlagališče tega novega projekta. Kot primer lahko uporabimo moje skladišče Ankifox, razširitev za Firefox, ki omogoča dodajanje besed v Anki, ki je na voljo na Githubu:

klon git https://github.com/usemoslinux/Ankifox.git

Ne pozabite https://github.com/usemoslinux/Ankifox.git zamenjati z URL-jem, ki ustreza vašemu projektu. Pridobivanje tega naslova je zelo enostavno, kot je razvidno iz spodnje slike.

Ta ukaz bo ustvaril imenik z imenom «Ankifox», v njem bo inicializiral imenik .git in prenesel vse podatke iz tega skladišča, da bo lahko delal z najnovejšo različico.