Del dit open source-projekt via GitHub

Denne artikel dukkede først op i Opgave 216 af .net magazine - verdens bedst sælgende magasin til webdesignere og udviklere.

Når mange mennesker hører Git, tror de GitHub. GitHub er den populære online Git-hostingtjeneste, der har bragt styrken af ​​sociale netværk til open source-kodningssamfundet. Og da flere og flere projekter skifter til Git, og et stigende antal virksomheder og individuelle udviklere flytter derhen for at være vært for deres open og closed source-projekter, bliver det stadig vigtigere at vide, hvordan man deltager i dette samfund.



GitHub har over 650.000 udviklere registreret på webstedet og er vært for mere end 500.000 unikke open source-projekter og 1,8 millioner samlede arkiver. Virksomheder som Twitter, Facebook, Yahoo og Rackspace, blandt tusinder af andre, bruger GitHub til at dele deres open source-projekter og tage bidrag fra det større open source-samfund. Mange flere virksomheder bruger GitHub til at outsource deres behov for kodehosting eller finde udviklere til at ansætte - at lære webstedet kan være, hvordan du får dit næste job, eller hvad du bruger, når du kommer dertil.



Sidste uge introducerede vi Git Version Control-værktøjet og i dag ser vi på at bruge GitHub. Vi ser, hvordan du opretter en konto, tilføjer et eksisterende projekt til Git og skubber det til GitHub for at dele med det bredere samfund. Endelig lærer vi, hvordan vi kan bidrage til en andens open source-projekt på GitHub. Ved afslutningen af ​​denne vejledning skal du føle dig komfortabel med at åbne sourcing af nye projekter på GitHub såvel som at bidrage til eksisterende projekter, som du opdager på GitHub.

1. Download tårnet

Hvis du endnu ikke bruger Git, kan du downloade den gratis kommandolinjeklient på git-scm.com , eller du kan få en af ​​GUI'erne. Her bruger vi Tower, en kommerciel Mac GUI-klient med en 30-dages prøveperiode, som du kan downloade fra git-tower.com .



gør dig selv til en eventyrtidskarakter

2. Importer og begå kode

Download filerne ovenfra. Pak filen ud, og initialiser biblioteket som et Git-arkiv. Klik på i Tower Opret lokalt lager vælg derefter din sti. Du kan derefter foretage din første forpligtelse ved at klikke på Stage All og derefter Begå knap.



3. Opret en konto

Vores første mål vil være at skubbe denne kode op til GitHub for at dele med folk. For at gøre dette skal du oprette en konto på GitHub, hvis du endnu ikke har en. Gå til GitHub.com/plans og klik på Opret en gratis konto udfyld derefter den enkle formular.

4. Opret et nyt lager

For at dele dit projekt er vi nødt til at oprette et lager på GitHub. Du skal se en knap med titlen Nyt arkiv på instrumentbrættet, du lander på efter oprettelse af en konto. Klik på det, og angiv et projektnavn i den næste form for at oprette dit nye lager.

5. Tilføj GitHub som en ekstern repo

Vælg i Tower Refs> Tilføj nyt eksternt lager og indsæt HTML-URL'en, der findes på projektsiden, i URL-feltet i den form, der kommer op. Indtast derefter din GitHub-adgangskode, og klik Okay .

6. Skub din kode til GitHub

I Tower skal du højreklikke på mastergrenen i sidepanelet og vælge Publicer filial . Dette skubber dit arbejde til GitHub, så du kan gå til din projektside og se dit offentliggjorte arbejde. Fra nu af kan du bare klikke Skubbe for at dele yderligere opdateringer.

7. Gaffel et lager

Vi har delt noget kode, så nu skal vi bidrage til et projekt. Det første skridt til at arbejde på et projekt i GitHub er at forkaste det, dvs. få din egen skrivbare kopi. Gå til GitHub.com/schacon/eksempel og klik på Gaffel knappen for at opnå dette.

skjul html-kode fra visningskilde

8. Klon det arkiv

For at forbedre dette projekt er vi nødt til at få en kopi lokalt til redigering. Vælg HTTP-URL fra projektsiden, og bed Tower om at klone den for os. Gå til siden Lagre (kommando + D), klik på Klon Remote Repository og indsæt HTTP-URL'en.

9. Foretag en ændring

Nu vil vi tilføje en funktion, så vi skal oprette en gren for at udføre ændringerne i. Opret en ny gren (kommando + B) med navnet ny funktion og tjek det ud. Kopier derefter de to filer fra det originale eksempelprojekt til dette forked-arkiv, og begiv de nye ændringer.

10. Udgiv din emnegren

Højreklik på ny funktion gren i sidepanelet, og vælg Publicer filial at udgive det til GitHub. Dette opretter en ny filial med navnet ny funktion på GitHub, at den oprindelige forfatter af den kode, du forked, nu kan se med alt dit nye arbejde.

11. Start en anmodning om træk

Da vores arbejde nu er offentligt og på GitHub, vil vi fortælle den oprindelige projektforfatter at inkorporere det i deres projekt. Dette kaldes en pull-anmodning. Gå til den forgrenede projektside
og klik på Træk anmodning knap for at åbne formularen.

Brug iPhone som tegnetablet til pc

12. Udfyld og inspicer din anmodning om træk

Udfyld en overbevisende titel og beskrivelse af, hvorfor dit arbejde skal indarbejdes. I Forpligter sig fanen kan du se listen over unikke forpligtelser, du sender. I Filer ændret fane kan du se den samlede forskel på det, du sender.

13. Se billedforskelle

Når et billede er ændret, giver GitHub dig mulighed for at bruge flere visninger som f.eks side om side , stryg , løgskind og forskel så du kan se, hvordan det blev ændret. Når du er tilfreds med ændringen, skal du sende en anmodning om træk.

14. Kommentar til ændret linje

Pull-anmodninger fungerer som en proces til gennemgang af kode, og GitHub lader dig føre en samtale om ændringerne, inden de accepteres. Gå til Filer ændret visning af den anmodning, du lige har sendt, og kommentere en linje kode.

15. Se diskussion om pull-anmodning

Når du har kommenteret, kan du se kommentaren og alle andre relaterede oplysninger til pull-anmodningen på hovedsiden for pull-anmodning. Klik på Diskussion fanen for at se, hvordan din kommentar og kodekontekst nu er på hoveddiskussionslisten.

16. Se grenliste

Nu hvor du har mere end en gren skubbet til dit projekt, kan du sammenligne dem med Grenliste udsigt. Hvis du klikker på Grenliste under Kilde fane får du en god visualisering af alle dine grene, og hvor mange forpligtelser, der er unikke for hver.

17. Se sammenligningsside

Hvis du er interesseret i en af ​​filialerne og vil se, hvordan den sammenlignes med din hovedfilial, skal du klikke på knappen Sammenlign på Grenliste side ved siden af ​​den gren. Dette vil give et overblik over dine ændrede filer, en samlet diff og en liste over forpligtelser.

18. Dine pull-anmodninger

For at holde styr på status for dine sendte og afventende trækanmodninger til projekter, du har på GitHub, kan du klikke på Træk anmodninger fanen fra din Dashboard . Nu hvor du deltager i et socialt kodningsnetværk, er det vigtigt.

wacom cintiq 13hd kreativ pen og touch tablet

19. Din profil

Nu hvor du er et aktivt og uddannet medlem af GitHub-samfundet, skal du sørge for, at du er repræsenteret korrekt. Din profilside, der findes på GitHub.com/ [brugernavn], er, hvordan folk kan se, hvem du er og kontakte dig. Sørg for at uploade en avatar på Gravatar.com og udfyld din profil.

Ekspert tip: GitHub-brugergrænsefladen er meget flot, men hvis du har brug for at gøre noget andet eller gentagne gange, har GitHub også en dejlig lille API, der giver dig mulighed for at gøre med et script næsten alt hvad du kan gøre via webbrugergrænsefladen. Besøg udvikle.GitHub.com for at lære mere om, hvordan du scripter nogen af ​​dine GitHub-interaktioner, herunder eksisterende biblioteker, for at gøre det let at gøre det i Java, JavaScript, PHP, Perl, Python, Ruby og mere. Hvis GitHub ikke gør præcis, hvad du vil, er det muligt, at du kan bøje det til din vilje.