Obținerea Hang of GitHub

Un proiect este întotdeauna mai distractiv când aveți prieteni care lucrează cu dvs., dar cum se poate face acest lucru atunci când lucrați la un proiect de codificare? Îmi voi păstra tastatura pentru mine, mulțumesc.

Introduceți GitHub. Cu acest serviciu web, vă puteți împărtăși proiectele de codificare și puteți colabora cu ușurință!

act de renunțare

Acest tutorial va presupune că sunteți familiarizat cu Git, probabil cel mai bine distribuit software de control al versiunilor. Ai pierdut deja? Nu vă faceți griji: citiți-mi introducerea la Git pentru a te ridica și a alerga. Apoi, reveniți aici și aflați totul despre GitHub, rețeaua socială pentru dezvoltatori!

Noțiuni de bază

Bineînțeles, veți avea nevoie de un cont GitHub dacă vreți să experimentezi oricare din bunătatea codării sociale. Să facem asta acum. Mergeți pe site-ul web GitHub și faceți clic pe "Pricing and Signup" din partea de sus.

Crearea unui cont

Există mai multe planuri diferite pe care le puteți utiliza, în funcție de nevoile dvs. În acest moment, contul liber "sursă deschisă" este tot ce ne dorim; așa că să faceți clic pe "Înscrieți-vă". Este pagina dvs. standard de înscriere; introduceți-vă numele, adresa de e-mail și parola. Veți avea nevoie, de asemenea, de o cheie publică SSH; I-am explicat cum să obțin una în articolul meu anterioară:

Deschideți terminalul și tastați acesta: ssh-keygen -t rsa-C "[email protected]". Opțiunea t atribuie un tip, iar opțiunea C adaugă un comentariu, în mod tradițional adresa dvs. de e-mail. Veți fi întrebat de unde să salvați cheia; doar lovirea enter va face (care salvează fișierul la locația implicită). Apoi, introduceți o expresie de pass, de două ori. Acum aveți o cheie; să-i dăm lui GitHub.

Mai întâi, obțineți cheia din fișier; terminalul vă va spune unde a fost stocată cheia; deschideți fișierul, copiați cheia (aveți grijă să nu adăugați nicio linie nouă sau spațiu alb).

Odată ce aveți cheia, trebuie doar să o lipiți în câmpul corect. După cum se spune, nu trebuie să faceți acest lucru acum; puteți adăuga o cheie mai târziu. Apoi faceți clic pe butonul pentru a vă de acord și a vă înscrie.

Încălzirea la Interfață

Când vă conectați pentru prima oară, veți vedea tabloul de bord; este ceva de genul:

În colțul din dreapta sus, puteți vedea o bară de instrumente cu opțiuni pentru controlul contului dvs. Există, de asemenea, câteva linkuri pentru a ajunge în jurul GitHub, precum și caseta de căutare.

Panoul principal oferă o serie de acțiuni; ulterior, acesta va fi folosit pentru a vă ține la curent cu proiectele care vă interesează. Și în dreapta acestui lucru, vor fi listate propriile dvs. depozite. Rețineți că, în Git, depozitele sunt containerele care dețin întregul cod și istoric legate de un proiect.
Când aveți o șansă, răsfoiți în jurul setărilor contului, este tot ceea ce v-ați aștepta, așa că nu voi trece peste el; dar dacă intenționați să fiți un avid githubber, ar trebui să completați profilul dvs. și să vedeți ce mai este acolo.

Totul e despre Repos

Într-adevăr, întregul scop al GitHub face ca depozitele Git să fie disponibile în lume; prin urmare, rezultă că lucrul cu depozitele (sau repo, așa cum se numesc adesea) este ceva cu care ar trebui să fiți confortabil.

Crearea unui depozit este destul de simplă. Pe tabloul de bord, faceți clic pe "Depozit nou" deasupra listei dvs. de repo (care este în prezent gol).

Trei casete de text vă așteaptă aici; depozitul dvs. va avea nevoie de un nume de proiect, o descriere și adresa URL a site-ului proiectului. Dacă ați făcut upgrade la unul dintre planurile plătite, puteți alege dacă acesta să fie disponibil publicului sau nu. Când ați terminat, apăsați pe "Creare depozit".
GitHub vă va oferi acum instrucțiuni pentru conectarea depozitului GitHub la unul dintre locațiile dvs. locale Git. Dacă sunteți familiarizați cu Git, aceasta ar trebui să fie o pălărie destul de veche pentru tine. Partea importantă este ultimele două linii ale "Următorilor pași" sau "Git Repo existent?"

 git remote adăugați originea [email protected]: aburgess / My-First-GitHub-Repo.git

Comanda git-remote vă permite să urmăriți alte depozite și să le păstrați "sincronizate" cu cele locale. În cazul nostru, urmărim depozitul de pe GitHub de la depozitul nostru local. Deci, această primă linie adaugă o telecomandă; îl numim "origine" și îi oferim o adresă URL. Aceasta este o adresă URL privată pe care numai dvs. o puteți utiliza pentru a citi și a scrie în repo GitHub.

În al doilea rând, folosim comanda git-push pentru a trimite totul în ramura master către origine (depozitul nostru GitHub). Observați că niciunul dintre lucrările de codificare sau de proiect (crearea fișierelor etc.) nu este realizat pe GitHub. Asta-i treaba locală; ar trebui să lucrați la proiectul dvs. la fel cum ați face un repo local de vanilie. Cu toate acestea, îl veți împinge în mod regulat la GitHub cu acea a doua linie.

Deci, să presupunem că ați lucrat la un proiect de ceva vreme și v-ați împins comitetele la un repo GitHub. Ce metadate de proiect putem explora pe GitHub? Să ne uităm la depozitul jQuery.

A se vedea bara de instrumente din partea de sus, chiar sub numele proiectului? Aceste opțiuni ne permit să analizăm câteva din informațiile Git pe care le-am descoperit ultima dată în linia de comandă. În momentul de față, suntem pe fila sursă. Începe cu drop-uri pentru ramurile și etichetele repo; utilizați-le pentru a vedea diferite ramuri sau etichete. Există, de asemenea, unele metadate de proiect; avem numele URL al proiectului, URL-ul și clonarea URL-urilor (Aceste adrese URL sunt doar pentru citire).

Apoi, puteți vedea informațiile despre ultimul angajament: autor, timp, comentariu și hashes. Sub aceasta, aveți un browser de fișiere, care vă arată ultimele versiuni ale tuturor fișierelor din proiect, precum și vârsta și mesajul ultimei comiteri în care au fost modificate.

Dacă proiectul are un fișier readme, acesta este afișat sub browserul de fișiere.

încredințarile

Să trecem la fila de angajamente din partea de sus și să vedem ce păstrează.

Așa cum v-ați putea aștepta, putem vedea un restante de angajamente pe acest proiect. Dacă faceți clic pe comanda hash (din partea dreaptă a intrării de comitet), veți vedea ce a fost modificat în comitet.

Linile verzi (prefixate cu '+') sunt adăugiri, iar liniile roșii (prefixate cu '-') sunt ștergeri.
Puteți să vă abonați la feed-ul RSS al istoricului de comitete al oricărui repo dacă doriți să îl urmăriți.

Reţea

Următoarea filă este fila de rețea; aceasta vă arată o reprezentare grafică a istoriei depozitului. Acest grafic este extras din perspectiva jquery-ului comisarului. Fiecare comitet apare doar o singură dată, astfel încât angajamentele nu pe linia jQuery nu sunt în repo-ul jQuery. În acest fel, putem vedea ce angajamente au făcut alți oameni pe care nu le avem. Este incredibil de util, dar într-o oarecare măsură confuză dacă nu vă faceți griji pe tot parcursul. Dacă doriți să aflați mai multe, consultați postarea pe blog a lui GitHub.
Fișa de rețea oferă, de asemenea, o listă de membri (persoane care au vizat repo) și o hrănire, de asemenea.

Grafice

Fila grafice vă oferă o vedere diferită a proiectului dvs. dintr-o perspectivă grafică. Este într-adevăr doar meta-date, dar poate oferi câteva informații interesante:

Fara de coarne

Dacă vizionați un depozit pe care îl dețineți, veți vedea o altă filă Fork Queue. Aceasta vă arată aceleași informații pe care le-ați văzut în graficul de rețea, dar în mod diferit. De aici puteți alege care se angajează să se aplice în depozitul dvs., pe oricare dintre filialele pe care le doriți. Pentru mai multe informații despre coada de furcă, consultați acest post și videoclipul pe blogul GitHub.

Puteți activa alte trei file din panoul de administrare repo: Wiki, Probleme și Descărcări. Acestea vă permit să creați un wiki, să urmăriți bug-uri în proiectul dvs. și să oferiți copii descărcate ale repo-ului dvs. Toate sunt destul de intuitive.

Partea socială

La fel cum spune și sloganul, GitHub este vorba de codificare socială. Deși am văzut deja câțiva dintre ei, este timpul să verificăm restul caracteristicilor sociale ale GitHub.

Explorarea altor depozite

Dacă aveți vreun timp liber și doriți să vă grăbiți pentru un timp un proiect de codificare, GitHub este locul ideal pentru a merge. Să vedem cum putem găsi proiecte interesante.
Începeți făcând clic pe "Explorați GitHub" din dreapta casetei de căutare. Avem câteva file pentru a alege de aici:

  • Repozitorii
  • Căutare
  • Cronologie
  • Limbile
  • changelog

Pentru mine, cel mai interesat este fila limbi; alegeți limba dvs. și verificați cele mai vizionate și cele mai vizionate proiecte pentru acea limbă.

Deci, să presupunem că ați găsit un proiect care vă interesează; ce urmează?

Interacționează cu alte depozite

Când vizualizați un repo, instrumentele sociale sunt sub bara de căutare. Începând din dreapta, puteți vedea câte persoane au vizat proiectul și câte persoane îl urmăresc. Am discutat despre frământare și urmărire, dar este timpul să avem niște definiții formale pe masă.

  • Forking un proiect înseamnă că veți obține o copie a depozitului pe care îl puteți juca cu tot ce doriți.
  • Vizionarea unui proiect înseamnă că orice acțiune pe care o faceți va apărea în fluxul dvs. de știri, pe tabloul de bord.

Iau un traseu de iepure, dar poți să faci mai mult decât să urmărești proiectele; dacă găsiți dezvoltatori deosebit de talentați, le puteți urmări pentru a le urmări fiecare apăsare de taste. Doar faceți clic pe butonul "Urmărire" de pe pagina de profil.

De asemenea, puteți să le trimiteți un mesaj dacă doriți. Acum vorbim despre rețeaua socială!

Înapoi pe bara de instrumente socială, următorul buton (în mișcare stânga) vă permite să descărcați codul sursă al proiectului. Următorul buton vă permite să vă reporniți, iar ultima să o urmăriți (ați văzut că vine).

Dacă vă uitați la un depozit propriu, vor exista două butoane în rând: "Trageți solicitarea" și "Admin." Vom reveni la "Trageți cererea" într-un minut; nu ezitați să priviți în jurul panoului de administrare.

Ar trebui să fie evident că cele mai multe dintre caracteristicile de bază sunt:

  • schimbați sucursala implicită
  • creați o pagină a proiectului (vom reveni la aceasta)
  • transforma aceste file suplimentare (wiki, descărcări, probleme) on / off
  • redenumiți sau ștergeți repo

Când ați terminat, faceți clic pe numele proiectului din partea de sus pentru a reveni la vizualizarea sursă.

Scenariul nostru înainte de a introduce instrumentele sociale a fost că ați găsit un repo pe care doriți să lucrați. Primul lucru pe care trebuie sa-l faceti este sa desfasurati proiectul; trebuie doar să faceți clic pe butonul "furculiță". Acum aveți o copie a repo-ului în contul dvs. Hai să clonăm repo-ul pe computer, folosind URL-ul clonei private. Făcând acest lucru, se stabilește automat o origine numită la distanță, așa cum am discutat mai devreme. Această origine nu este proiectul original pe care l-ați forțat (nu îl puteți scrie), ci o copie furcată a acestuia. Totuși, trebuie să configurați o telecomandă pentru proiectul inițial; faceți asta cu această comandă:

 git adăugați la distanță în amonte [URL-ul clonei proiectului inițial al proiectului aici] git fetch upstream

Ultima linie primește cele mai recente ramuri de la telecomanda din amonte și le stochează în ramuri de urmărire.
Acum este momentul să începeți codarea. Pe măsură ce faceți comitete, ele vor afișa graficul de rețea inițial al proiectului, deoarece nu se află în repo. Vor apărea și în coada de reparații a repo-ului, astfel încât proprietarul le poate atrage dacă îi place. Cu toate acestea, puteți solicita să fie tras înăuntru. Asta este motivul pentru care este solicitat butonul de solicitare: puteți trimite proprietarului repo-ului original un mesaj.

Nu este nimic fantezie; într-adevăr, le permite doar să știe că ar trebui să verifice coada lor furculiță.
Dar ce se întâmplă dacă au făcut schimbări în proiect, de când l-ai făcut? Este cea mai bună practică de a integra schimbările în repo înainte de a cere să vă tragă schimbările. Puteți obține cu ușurință actualizările prin intermediul acelei telecomenzi în amonte pe care ați făcut-o! Doar rulați această comandă:

 git preluați masterul în amonte git îmbinare upstream / master

Așa cum tocmai am văzut acum o clipă, comanda de preluare obține cel mai recent conținut de la telecomanda specificată, în acest caz telecomanda noastră din amonte. De asemenea, precizăm că dorim doar ramura master. A doua linie combină ramura specificată cu cea pe care suntem. Suntem pe ramura master a repo-ului nostru local și dorim să fuzionăm sucursala noastră de urmărire în amonte / maestru.

Notă: dacă această discuție despre ramura de urmărire vă confundă, consultați acest articol pe gitready.com. În principiu, sucursalele de urmărire sunt pur și simplu ramuri care urmăresc unde alte repo-uri cu același proiect sunt legate de repo. Pentru a vedea toate sucursalele dvs. executați comanda git branch -a. Iată ce primesc pentru un repo învârtit:

Dacă ești leneș, ai putea executa comanda git trageți în amonte maestru. Aceasta face simultan comenzile preluare și îmbinare. Cu toate acestea, acest lucru ar putea cauza probleme de îmbinare, astfel încât să nu stați departe de el!
Odată ce ați fuzionat modificările, puteți cere o tragere cu liniște, știind că furculita dvs. este la curent cu depozitul din amonte.

Pagini de utilizator și de proiect

Github vă oferă o abilitate destul de unică de a crea un site web personal dintr-un depozit GitHub. Numele meu de utilizator GitHub este andrew8088, deci dacă am creat un repo pe nume andrew8088.github.com, acesta va fi publicat la http://andrew8088.github.com. Simplu ca asta!

De asemenea, puteți crea un site pentru un proiect; acest lucru este un pic mai complicat, dar GitHub facilitează obținerea unei pagini generice, care să vă explice proiectul. Faceți clic pe acel buton de administrare din bara de instrumente socială. Apoi, faceți clic pe "Generați pagina dvs. de proiect" sub "Informații despre depozit".

Apoi, completați toate câmpurile:

Faceți clic pe "Creați o pagină".

Dacă doriți să personalizați mai mult pagina dvs. sau să adăugați pagini, puteți urma instrucțiunile avansate din Ajutor pentru pagini GitHub.

Când este doar un fragment

Ați vorbit vreodată cu un prieten online și v-ați dorit să partajați un fragment? Se întâmplă tuturor, iar GitHub oferă o cale rapidă de a face acest lucru. Este Gist. Ei spun:

Gist este o modalitate simplă de a partaja fragmente și paste cu alții. Toate gisti sunt depozite de tip git, astfel încât acestea sunt în mod automat versiuni, forcabile și utilizabile ca un depozit git.

Dați clic pe linkul Gist din stânga casetei de căutare sau accesați Gist.GitHub.com. Puteți să vă inserați pur și simplu în fragmentul dvs. sau să îl introduceți în întregime. Dați-i un nume de fișier și spuneți-i ce limbă scrieți (pentru evidențierea sintaxei). Apoi, dați clic pe "Creați Gist public". Copiați adresa URL și partajați-o!

Păstrarea în Know

Orice rețea socială poate deveni dependentă, iar GitHub nu este diferită. Dacă doriți să țineți evidența repo-urilor în mișcare, consultați iOctocat, aplicația GitHub pentru iPhone și iPod Touch.

Concluzie

Ei bine, a fost un tur de vârtej, dar sper că te simți mai familiarizat cu ceea ce ar putea fi cel mai bun site de găzduire / partajare de site-uri de pe web! Ai folosit vreodată GitHub? Aveți o opțiune mai bună? Apăsați comentariile!

Scrie un tutorial Plus

Știați că puteți câștiga până la 600 USD pentru a scrie un tutorial PLUS și / sau pentru noi? Căutăm tutoriale detaliate și bine scrise despre HTML, CSS, PHP și JavaScript. Dacă sunteți în măsură, contactați Jeffrey la [email protected].

Rețineți că o compensație reală va depinde de calitatea tutorialului final și a scenariului.

  • Urmați-ne pe Twitter sau abonați la Nettuts + RSS Feed pentru cele mai bune tutoriale de dezvoltare web de pe web.
Cod