Jagage oma avatud lähtekoodiga projekti GitHubi kaudu

See artikkel ilmus esmakordselt väljaanne 216 of .net ajakiri - maailma enimmüüdud ajakiri veebidisaineritele ja -arendajatele.

Kui paljud inimesed kuulevad Giti, mõtlevad nad GitHubi. GitHub on populaarne veebipõhine Giti hostimisteenus, mis on toonud sotsiaalsete võrgustike jõu avatud lähtekoodiga kodeerimiskogukonda. Ja kui üha rohkem projekte läheb üle Gitile ning üha rohkem ettevõtteid ja üksikuid arendajaid kolib sinna oma avatud ja suletud lähtekoodiga projektide võõrustamiseks, on üha olulisem teada, kuidas selles kogukonnas osaleda.

GitHubil on saidil registreeritud üle 650 000 arendaja, kes korraldavad rohkem kui 500 000 ainulaadset avatud lähtekoodiga projekti ja kokku 1,8 miljonit hoidlat. Sellised ettevõtted nagu Twitter, Facebook, Yahoo ja Rackspace kasutavad tuhandete teiste seas GitHubi oma avatud lähtekoodiga projektide jagamiseks ja suurema avatud lähtekoodiga kogukonna panuse saamiseks. Paljud teised ettevõtted kasutavad GitHubi oma koodimajutuse vajaduste sisseostmiseks või arendajate leidmiseks - saidi õppimine võib olla see, kuidas saate oma järgmise töö või mida kasutate sinna jõudes.

Eelmisel nädalal tutvustasime tööriista Git Version Control ja täna vaatame GitHubi kasutamist. Näeme, kuidas luua konto, lisada Gitile olemasolev projekt ja lükata see GitHubi laiema kogukonnaga jagamiseks. Lõpuks õpime, kuidas panustada kellegi teise avatud lähtekoodiga projekti GitHubis. Selle õpetuse lõpuks peaksite end mugavalt avama uute projektide hankimisel GitHubis ning panustama GitHubis avastatud olemasolevatesse projektidesse.

1. Laadige alla torn

Kui te veel Gitit ei kasuta, saate tasuta käsurea kliendi alla laadida aadressilt git-scm.com või võite hankida ühe GUI-d. Siin kasutame 30-päevase prooviversiooniga kaubanduslikku Mac GUI klienti Tower, millest saate alla laadida git-tower.com .

2. Impordi ja kinnita kood

Laadige failid ülalt alla. Pakkige fail lahti ja vormindage kataloog Giti hoidlana. Tornis klõpsake nuppu Looge kohalik hoidla siis vali oma tee. Seejärel saate oma esimese kohustuse teha klõpsates Etapp Kõik ja siis Pühendu nuppu.

3. Looge konto

Meie esimene eesmärk on lükata see kood GitHubi juurde, et seda inimestega jagada. Selleks looge GitHubis konto, kui teil seda veel pole. Minema GitHub.com/plans ja klõpsake nuppu Looge tasuta konto seejärel täitke lihtne vorm.

4. Looge uus hoidla

Teie projekti jagamiseks peame GitHubis looma hoidla. Peaksite nägema nuppu pealkirjaga Uus hoidla armatuurlaual, millele pärast konto loomist maandute. Uue hoidla loomiseks klõpsake seda ja esitage järgmisel kujul projekti nimi.

5. Lisage GitHub kaugrepo

Tornis valige Refs> Lisa uus kaughoidla ja kleepige projekti lehelt leitud HTML URL ilmuva vormi URL-i kasti. Seejärel sisestage oma GitHubi parool ja klõpsake nuppu Okei .

6. Lükake kood GitHubi

Tornis paremklõpsake külgribal peaharul ja valige Avalda haru . See viib teie töö GitHubi, et saaksite minna oma projekti lehele ja vaadata oma avaldatud tööd. Nüüdsest saate lihtsalt klõpsata Lükake edasiste värskenduste jagamiseks.

7. Kahvli hoidla

Oleme jaganud mõnda koodi, nii et nüüd peaksime projekti panustama. Esimene samm GitHubis projekti kallal töötamiseks on selle hargistamine, st hankige oma kirjutatav koopia. Minema GitHub.com/schacon/example ja klõpsake nuppu Kahvel selle saavutamiseks nuppu.

8. Kloonige see hoidla

Selle projekti täiustamiseks peame muutmiseks hankima koopia kohapealt. Valige projekti lehelt HTTP URL ja käskige Toweril see meie jaoks kloonida. Minge lehele Hoidlad (käsk + D), klõpsake nuppu Kloonige kaughoidla ja kleepige HTTP URL.

9. Tehke muudatus

Nüüd tahame lisada funktsiooni, nii et peaksime muutuste tegemiseks looma haru. Looge uus haru (käsk + B) nimega uus_omadus ja kontrollige seda. Seejärel kopeerige kaks faili algsest näidisprojektist sellesse kahvlisse hoidlasse ja tehke uued muudatused.

10. Avaldage oma teema haru

Paremklõpsake ikooni uus_omadus haru külgribal ja valige Avalda haru avaldada see GitHubis. See loob uue filiaali nimega uus_omadus saidil GitHub, mida teie hargnenud koodi algne autor näeb nüüd kogu teie uue teosega.

11. Alustage tõmbetaotlust

Kuna meie töö on nüüd avalik ja GitHubis, tahame öelda algsele projekti autorile, et see selle oma projekti kaasataks. Seda nimetatakse tõmbetaotluseks. Minge kahvliga projekti lehele
ja klõpsake nuppu Tõmba taotlus vormi avamiseks nuppu.

12. Täitke ja kontrollige oma tõmbetaotlust

Sisestage veenev pealkiri ja kirjeldus selle kohta, miks teie tööd tuleks lisada. Aastal Pühendub vahekaardil näete saadetavate unikaalsete toimingute loendit. Aastal Failid on muudetud vahekaardil näete saadetavate andmete ühtset erinevust.

13. Vaadake piltide erinevusi

Kui pilti muudetakse, võimaldab GitHub teil kasutada mitut vaadet, näiteks kõrvuti , pühkige , sibulakoor ja erinevus nii et näete, kuidas seda muudeti. Kui olete muudatusega rahul, saatke tõmbenõue.

14. Kommenteerige muudetud rida

Tõmbetaotlused toimivad koodi ülevaatamise protsessina ja GitHub võimaldab teil muudatustest enne nende vastuvõtmist vestelda. Mine Failid on muudetud äsja saadetud päringu vaade ja koodirea kommenteerimine.

15. Vaadake tõmbenõude arutelu

Kui olete kommenteerinud, näete tõmbenõude kommentaari ja kogu muud sellega seotud teavet peamisel tõmbetaotluse lehel. Klõpsake nuppu Arutelu vahekaarti, et näha, kuidas teie kommentaar ja koodi kontekst nüüd peamises aruteluloendis on.

16. Kuva harude loend

Nüüd, kui teie projektile on lükatud rohkem kui üks haru, saate neid võrrelda programmiga Filiaalide nimekiri vaade. Kui klõpsate nuppu Filiaalide nimekiri all Allikas vahekaardil saate kena visualiseerimise kõigist oma harudest ja sellest, mitu kohustust on kummalegi ainulaadsed.

17. Vt võrdluslehte

Kui olete huvitatud ühest harust ja soovite võrrelda selle haru peamise haruga, klõpsake nupul Võrdle Filiaalide nimekiri selle haru kõrval olev leht. See avab teie muudetud failide vaate, ühtse diffi ja toimingute loendi.

18. Teie tõmbetaotlused

GitHubis olevate projektide saadetud ja ootel olevate tõmbetaotluste oleku jälgimiseks võite klõpsata nupul Tõmmisnõuded vahekaardil Armatuurlaud . Nüüd, kui osalete sotsiaalse kodeerimise võrgustikus, on see oluline.

19. Teie profiil

Nüüd, kui olete GitHubi kogukonna aktiivne ja koolitatud liige, veenduge, et olete korralikult esindatud. Teie profiilileht, mille leiate aadressilt GitHub.com/[kasutajanimi], on see, kuidas inimesed saavad näha, kes te olete, ja teiega ühendust võtta. Laadige kindlasti üles avatar aadressil Gravatar.com ja täitke oma profiil.

Eksperdi näpunäide: GitHubi kasutajaliides on väga tore, kuid kui peate tegema midagi muud või korduvalt, on GitHubil ka väike armas API, mis võimaldab teil skriptiga teha peaaegu kõike, mida saate veebi kasutajaliidese kaudu teha. Külasta arendada.GitHub.com lisateavet selle kohta, kuidas skriptida mis tahes oma GitHubi interaktsiooni, sealhulgas olemasolevaid teeke, et muuta see Java, JavaScripti, PHP, Perli, Pythoni, Ruby ja muu jaoks hõlpsaks. Kui GitHub ei tee täpselt seda, mida soovite, on võimalik, et saate selle oma tahtmise järgi painutada.