zanimljiv

Kako, dovraga, koristim GitHub?

Poštovani Goldavelez.com,

Naučio sam šifrirati i želim početi koristiti GitHub za upravljanje svojim projektima. Unatoč uvodnoj lekciji koju oni pružaju, još uvijek ne razumijem kako to uopće funkcionira. Možeš li mi pomoći?

Iskreno,

Git Help

Poštovani GH

GitHub je odličan alat, ali definitivno je malo zbunjujući prvi put (i, možda, nekoliko puta nakon toga). To je vjerojatno razlog zašto je GitHub kreirao softver (za OS X i Windows) kako bi proces malo olakšao. Ipak, dobro je naučiti staromodan način, jer u protivnom vaše mogućnosti u pojednostavljenom softveru neće imati smisla. Započnimo hodanjem kroz osnove.

Prvi korak: prijavite se za GitHub

Evo jednostavnog dijela: napravite sebi GitHub račun na naslovnoj stranici. Nakon ispunjavanja obrasca, GitHub će vas prijaviti i odvesti do vašeg pravog feeda vijesti. Na sredini stranice vidjet ćete kamp za podizanje sustava (na slici desno). Proći ćemo ga kako bismo postavili vaš račun i, kasnije, stvorili prvo spremište. Kliknite "Postavi Git" za početak.

Drugi korak: instalirajte Git

GitHub postoji zbog aplikacije za kontrolu verzija nazvane git . Stranica se temelji na tome kako git djeluje, a git je prilično star. Pokreće se putem naredbenog retka i nema maštovito grafičko korisničko sučelje. Budući da je napravljeno za upravljanje zapisanim kodom, to ne bi trebalo zvučati previše zastrašujuće. (Naravno, kao što je prethodno spomenuto, GitHub je napravio divan softver koji vam omogućava korištenje njihovih usluga bez naredbenog retka, ali to vam neće previše pomoći ako ne znate osnove.)

Git funkcionira tako što na vašem računalu čita lokalno skladište koda (samo mapa koja sadrži kôd za vaš projekt) i zrcali taj kôd drugdje (u ovom slučaju poslužitelje GitHub-a). U početku ćemo obvezati (tj. Poslati) cijelo vaše lokalno skladište u GitHub, ali to je samo jednokratna afera. Dok nastavite raditi na kodu, jednostavno ćete izvršiti promjene. GitHub će pratiti promjene koje ste napravili stvarajući različite verzije datoteka tako da ih možete vratiti na stare ako želite (ili samo pratiti te promjene iz drugih razloga). To je prvenstveno razlog zašto biste željeli samostalno koristiti sustav kontrole verzija poput gita, ali dodatnu prednost kada koristite git za upravljanje kodom s drugim ljudima koji rade na vašem projektu. Kada više programera izvrši kod s gitom, GitHub postaje središnje spremište u kojem sav kôd na kojem rade svi mogu ostati u sinkronizaciji. Obvezati ćete svoje promjene, a drugi programeri će ih povući (tj. Sinkronizirati ih u njihovo lokalno spremište). To ćete učiniti s njihovim kodom.

Git omogućuje da se sve ovo dogodi, pa morate preuzeti najnoviju verziju i instalirati je. Na OS X jednostavno ćete instalirati aplikaciju naredbenog retka. U sustavu Windows dobit ćete još nekoliko predmeta. U sljedećem ćemo koraku razgovarati o tome kako funkcioniraju.

Treći korak: Postavljanje Gita

Da biste postavili git, morate se upustiti u naredbeni redak. U OS X to znači pokretanje aplikacije Terminal (Tvrdi disk -> Aplikacije -> Uslužni programi -> Terminal) i na Windows-u što znači pokretanje Git Bash aplikacije koju ste upravo instalirali - Windows naredbeni redak. Kad ste spremni, recite git svoje ime ovako:

git config --global user.name "Your Name Here"

Na primjer, moj bi izgledao ovako jer za ovaj primjer koristim testni račun:

git config --global user.name "Adam Dachis"

Možete unijeti bilo koje ime koje želite, ali kasnije ćete trebati unijeti svoju e-poštu i ta e-pošta koju ste koristili prilikom prijave za GitHub:

git config --global user.email " "

Ako ste se iz bilo kojeg razloga prijavili za GitHub s pogrešnom adresom e-pošte, morat ćete je promijeniti.

Sada, kako biste izbjegli da uvijek unesete vjerodajnice za prijavu i generirate SSH ključeve, morat ćete instalirati pomoćnika vjerodajnice tako da se lozinke predmemoriraju. Ako imate Windows, preuzmite ga i instalirajte. Ako ste na OS X, trebat ćete to riješiti putem terminala. Za početak koristite ovu naredbu za preuzimanje pomoćnika vjerodajnice:

curl -s -O \

//github-media-downloads.s3.amazonaws.com/osx/git-credential-osxkeychain

Ovo će preuzeti malu malu datoteku i ne bi trebalo trajati predugo. Kada završite, unesite sljedeću naredbu kako biste bili sigurni da su dozvole ispravne na datoteci koju upravo preuzmete (i popravite ih ako nisu):

chmod u+x git-credential-osxkeychain

Sada je vrijeme da instalirate vjerodajnicu pomagača u istu mapu u kojoj instalirate git. Da biste to učinili, unesite ovu naredbu:

sudo mv git-credential-osxkeychain `dirname \`which git\``

Bit će vam zatraženo da unesete lozinku administratora jer je gornja naredba započela s sudo. Sudo je skraćenica za "super user do" i potreban je pri obavljanju zadatka koji zahtijeva pristup root-u. Naredba sudo omogućuje vam da na trenutak postanete korijenski korisnik (korisnik s dopuštenjem raditi gotovo sve) na vašem operativnom sustavu tako da možete izvršiti ovaj zadatak. Od vas se traži da unesete zaporku kako biste dokazali da ste administrator računala i trebalo bi vam dopustiti da to učini. Nakon što unesete zaporku i pomoćnik vjerodajnice je premješten, dovršite instalaciju ovom naredbom:

git config --global credential.helper osxkeychain

Sada ste spremni i možete prijeći na stvarno korištenje gita i GitHub-a!

Četvrti korak: Stvorite prvo spremište

Sada kada ste stigli do sada, zapravo možete koristiti GitHub! Kao prvi red poslovanja kreirat ćemo spremište (ili "repo" ukratko). Krenite na GitHub i kliknite gumb "Novo spremište" u gornjem desnom kutu stranice vašeg računa. (Napomena: Ako se još uvijek prikazuje odjeljak za pokretanje kampa GitHub, prikazat će se ispod njega.)

Prilikom stvaranja spremišta morate odlučiti nekoliko stvari, uključujući njegovo ime i hoće li biti javno dostupno ili ne. Odabir imena trebao bi biti prilično jednostavan, jer vjerojatno već imate naziv za svoj projekt. Ako samo pratite korake u svrhu učenja, upotrijebite "Hello-World". Zašto "Hello-World", a ne "Hello World"? Jer razmaci i posebni znakovi uzrokovat će probleme. Jednostavno i lako upišite u naredbeni redak. Ako želite uključiti složenije ime, možete ga dodati u neobavezno polje opisa ispod polja s imenom.

Ako stvarate projekt otvorenog koda, želite javno spremište. Ako želite sami kodirati ili dijeliti samo s određenim ljudima, to će učiniti privatno spremište. Napravite izbor koji najbolje odgovara vama i vašem projektu.

Kad završite, možete kliknuti gumb "Stvori spremište", ali možda biste prvo trebali učiniti još jednu stvar: potvrdite potvrdni okvir "Inicijalizirajte ovo spremište README". Zašto? Sva spremišta zahtijevaju README datoteku. U idealnom slučaju ta bi datoteka sadržavala malo informacija o vašem projektu, ali možda se sada ne biste htjeli baviti time. Inicijaliziranjem spremišta README, dobit ćete praznu README datoteku s kojom kasnije možete raditi. Za potrebe ovog vodiča, ostavit ćemo okvir jer ćemo u sljedećem odjeljku stvoriti README datoteku ispočetka kako bismo je prakticirali (poslali) na GitHub.

Peti korak: izvršite prvu obvezu

Kad datoteke pošaljete na GitHub, vi ih. Za praksu ćemo inicijalizirati vaše lokalno spremište i stvoriti README datoteku koju ćemo izvršiti kao praksu. Prije nego što započnete, morate znati gdje se nalazi vaše lokalno spremište koda na vašem računalu i kako mu pristupiti putem naredbenog retka. U ovom ćemo vodiču pretpostaviti da je u početnoj mapi vašeg računala direktorij pod nazivom "Hello-World". Ako je morate stvoriti, samo pokrenite ovu naredbu (isto za Git Bash na terminalu Windows i OS X):

mkdir ~/Hello-World

Sada promijenite taj direktorij pomoću naredbe cd (promjena imenika):

cd ~/Hello-World

U slučaju da se pitate, ~ predstavlja vaš kućni imenik u Git Bash i Terminalu. To je jednostavno skraćenica, tako da ne morate sve upisivati ​​(što bi više ličilo na / Korisnici / vaše ime korisnika /). Sada kada je vaše spremište spremno, utipkajte ovo:

git init

Ako ste već imali spremište za spremanje, jednostavno biste trebali ući u taj direktorij i umjesto toga pokrenuti git init naredbu. Bilo kako bilo, vaše lokalno spremište spremno je za rad i možete započeti s unosom koda. Ali čekajte, nemate se što obvezati! Pokrenite ovu naredbu za stvaranje datoteke README:

touch README

Odmorimo se na trenutak i pogledajmo što se upravo dogodilo. Idite u matičnu mapu na računalu i pogledajte mapu Hello-World (ili pogledajte mapu koju koristite za lokalno spremište). Primijetit ćete datoteku README zahvaljujući naredbi koju ste upravo izvršili. Ono što nećete vidjeti je .git mapa, ali to je zato što je nevidljivo. Git to skriva unutra, ali s obzirom na to da ste git init naredbu git init znate da postoji. Ako ste skeptični, samo pokrenite naredbu ls u Git Bash / Terminalu da biste prikazali popis svega u trenutnom direktoriju (koji je, ako slijedite zajedno, vaše lokalno spremište).

Pa kako git zna da želimo počiniti ovu README datoteku koju smo upravo stvorili? Ne mora, i to morate reći. Ova naredba će učiniti trik:

git add README

Ako želite dodati druge datoteke za počinjenje, upotrijebit ćete istu naredbu, ali zamijenite README imenom druge datoteke. Sada pokrenite ovu naredbu da je počnem:

git commit -m 'first commit'

Dok su ostale naredbe bile prilično jednostavne, naredba počinji malo više pa ćemo je raščlaniti. Kada upišete git, to samo govori naredbeni redak da želite koristiti git program. Kad upišete commit, git govorite da želite koristiti naredbu počinjenja. Sve što slijedi te dvije stvari računa se kao opcije. Prvo je ono što je poznato kao zastava. Zastava određuje da želite učiniti nešto posebno, a ne samo izvršavati naredbu počinjenja. U ovom slučaju, -m zastava znači "poruka", a ono što slijedi je vaša poruka počinjenja (na primjer, "prva obveza"). Poruka nije apsolutno potrebna (iako ćete je obično trebati navesti), već je jednostavno referenca koja će vam pomoći da razlikujete različite verzije datoteke (ili datoteke) koje obvezujete u svoje spremište.

Vaša prva obveza trebala bi proći u djeliću sekunde jer još niste ništa poslali. Da biste ovu praznu README datoteku doveli do GitHub-a, trebate je pritisnuti s nekoliko naredbi. Evo prvog:

git remote add origin //github.com/yourusername/Hello-World.git

Trebate zamijeniti "svoje ime korisnika" s - pretpostavljali ste - svojim GitHub korisničkim imenom. Za mene bi to izgledalo ovako:

git remote add origin //github.com/gittest1040/Hello-World.git

Ova naredba govori gitu gdje treba poslati vaše pohranjivanje Hello-World. Sada sve što trebate učiniti je poslati:

git push origin master

Jednom kada pokrenete ovu naredbu, sve (u ovom slučaju samo vaša README datoteka) preći će na GitHub. Čestitamo vam na prvom obvezi!

Učenje više

Korištenje GitHub-a zahtijeva više od pukog postavljanja README datoteke, ali te bi vam osnove trebale dobro razumjeti kako komunicirati s git aplikacijom i uslugom. Sada kada znate kako GitHub funkcionira u svojoj srži, umjesto toga možete koristiti GitHub aplikacije za upravljanje kôdom. Ako želite naučiti više o GitHubu, evo nekoliko sjajnih vodiča. Za početak pogledajte kako izdvojiti spremište i vodič za GitHub tvrtke LockerGnome.

Zabavite se upravljajući svojim kodom!

Ljubav,

Goldavelez.com