Jaa avoimen lähdekoodin projekti GitHubin kautta

Tämä artikkeli ilmestyi ensimmäisen kerran numero 216 of .net magazine - maailman myydyin verkkosivujen suunnittelijoille ja kehittäjille suunnattu lehti.

Kun monet ihmiset kuulevat Gitin, he ajattelevat GitHubia. GitHub on suosittu Git-verkkopalvelupalvelu, joka on tuonut sosiaalisten verkostojen voiman avoimen lähdekoodauksen yhteisöön. Ja kun yhä useammat projektit siirtyvät Gitiin ja yhä useammat yritykset ja yksittäiset kehittäjät muuttavat sinne järjestämään avoimen ja suljetun lähdekoodin projektejaan, on yhä tärkeämpää tietää, kuinka osallistua yhteisöön.



GitHub on rekisteröinyt yli 650 000 kehittäjää sivustolle, joka isännöi yli 500 000 ainutlaatuista avoimen lähdekoodin projektia ja yhteensä 1,8 miljoonaa varastoa. Tuhansien joukossa muun muassa Twitter, Facebook, Yahoo ja Rackspace käyttävät GitHubia jakamaan avoimen lähdekoodin projektejaan ja ottamaan vastaan ​​lahjoituksia suuremmalta avoimen lähdekoodin yhteisöltä. Monet muut yritykset käyttävät GitHubia ulkoistamaan koodinhallintatarpeitaan tai etsivät palkattavia kehittäjiä - sivuston oppiminen voi olla se, miten saat seuraavan työpaikkasi tai mitä käytät, kun pääset sinne.



kuinka käyttää viitteitä taiteessa

Viime viikolla esiteltiin Git Version Control -työkalu ja tänään tarkastelemme GitHubin käyttöä. Näemme, miten luodaan tili, lisätään olemassa oleva projekti Gitiin ja työnnetään se GitHubiin jakamaan laajemman yhteisön kanssa. Lopuksi opimme kuinka osallistua jonkun muun avoimen lähdekoodin projektiin GitHubissa. Tämän opetusohjelman loppuun mennessä sinun pitäisi tuntea olosi mukavaksi hankkia uusia projekteja GitHubista sekä osallistua GitHubissa löytämiisi projekteihin.

1. Lataa torni

Jos et vielä käytä Gitiä, voit ladata ilmaisen komentoriviasiakkaan osoitteesta git-scm.com tai voit hankkia jonkin käyttöliittymistä. Tässä käytämme Toweria, kaupallista Mac-käyttöliittymäasiakasta, jolla on 30 päivän kokeilu, jonka voit ladata git-tower.com .



2. Tuo ja hyväksy koodi

Lataa tiedostot ylhäältä. Pura tiedosto ja alusta hakemisto Git-arkistona. Napsauta Towerissa Luo paikallinen arkisto valitse sitten polkusi. Voit sitten tehdä ensimmäisen sitoutumisen napsauttamalla Vaihe kaikki ja sitten Tehdä -painiketta.



3. Luo tili

Ensimmäinen tavoitteemme on työntää tämä koodi GitHubille jakamaan ihmisten kanssa. Voit tehdä tämän luomalla tilin GitHubiin, jos sinulla ei vielä ole tiliä. Mene GitHub.com/plans ja napsauta Luo ilmainen tili -painiketta ja täytä sitten yksinkertainen lomake.

4. Luo uusi arkisto

Projektin jakamiseksi meidän on luotava arkisto GitHubiin. Sinun pitäisi nähdä painike nimeltä Uusi arkisto hallintapaneelissa, jolle laskeudut tilin luomisen jälkeen. Napsauta sitä ja anna projektin nimi seuraavassa lomakkeessa uuden arkiston luomiseksi.

5. Lisää GitHub etätallennuksena

Valitse Towerissa Viitteet> Lisää uusi etätietovarasto ja liitä projektisivulta löytyvä HTML-URL avautuvan lomakkeen URL-ruutuun. Kirjoita sitten GitHub-salasanasi ja napsauta OK .

6. Työnnä koodisi GitHubiin

Napsauta Towerissa hiiren kakkospainikkeella sivupalkin päähaaraa ja valitse Julkaise haara . Tämä ajaa työsi GitHubiin, joten voit siirtyä projektisivullesi ja nähdä julkaistun työn. Tästä lähtien voit vain napsauttaa Työntää jakaa lisää päivityksiä.

7. Haaraa arkisto

Olemme jakaneet koodin, joten nyt meidän pitäisi osallistua projektiin. Ensimmäinen askel projektin parissa työskentelyyn GitHubissa on haarauttaa sitä, eli hankkia oma kirjoitettava kopio. Mene GitHub.com/schacon/esimerkki ja napsauta Haarukka -painiketta tämän saavuttamiseksi.

8. Kloonaa arkisto

Projektin parantamiseksi meidän on hankittava kopio paikallisesti muokattavaksi. Valitse HTTP-URL projektisivulta ja käske Toweria kloonaamaan se meille. Siirry arkistot -sivulle (komento + D), napsauta Kloonaa kaukovarasto ja liitä HTTP-URL-osoite.

9. Tee muutos

Nyt haluamme lisätä ominaisuuden, joten meidän pitäisi luoda haara, jossa muutokset tehdään. Luo uusi haara (komento + B) nimeltä uusi ominaisuus ja tarkista se. Kopioi sitten kaksi tiedostoa alkuperäisestä esimerkkiprojektista tähän haarautuneeseen arkistoon ja tee uudet muutokset.

kuvata kahta elementtiä yllä olevasta maalauksesta, jotka taiteilija sisällytti perspektiivin luomiseen?

10. Julkaise aiheesi haara

Napsauta hiiren kakkospainikkeella uusi ominaisuus haara sivupalkissa ja valitse Julkaise haara julkaista se GitHubissa. Tämä luo uuden haaran nimeltä uusi ominaisuus GitHubissa, jonka haastamasi koodin alkuperäinen kirjoittaja voi nyt nähdä kaikilla uusilla teoksillasi.

11. Aloita vetopyyntö

Koska työmme on nyt julkista ja GitHubissa, haluamme kehottaa alkuperäistä projektin tekijää sisällyttämään sen projektiin. Tätä kutsutaan vetopyynnöksi. Siirry haarautuneelle projektisivulle
ja napsauta Vedä pyyntö -painiketta avataksesi lomakkeen.

12. Täytä ja tarkista vetopyyntösi

Kirjoita vakuuttava otsikko ja kuvaus siitä, miksi työsi tulisi sisällyttää. vuonna Sitoutuu välilehdellä näet luettelon lähettämistäsi yksilöllisistä sitoumuksista. vuonna Tiedostot muutettu välilehdessä näet lähettämiesi tietojen yhtenäisen eron.

13. Katso kuvaerot

Kun kuvaa muokataan, GitHub antaa sinun käyttää useita näkymiä, kuten rinnakkain , pyyhkäise , sipulin iho ja ero joten näet kuinka sitä muutettiin. Kun olet tyytyväinen muutokseen, lähetä vetopyyntö.

14. Kommentoi muutettua riviä

Vetopyynnöt toimivat koodin tarkistusprosessina, ja GitHub antaa sinun keskustella muutoksista ennen niiden hyväksymistä. Mene Tiedostot muutettu näkymä juuri lähettämästäsi pyynnöstä ja kommentoi koodiriviä.

15. Tarkastele vetopyynnön keskustelua

Kun olet kommentoinut, näet vetopyynnön kommentin ja kaikki muut siihen liittyvät tiedot vetopyynnön pääsivulla. Klikkaa Keskustelu -välilehdellä nähdäksesi, kuinka kommenttisi ja koodisi konteksti on nyt pääkeskustelulistalla.

kirjasinlaji käsinkirjoitetuilla merkeillä

16. Näytä haaraluettelo

Nyt kun projektiisi on työnnetty useampi kuin yksi haara, voit verrata niitä projektiin Haarakonttori näkymä. Jos napsautat Haarakonttori alla Lähde -välilehdellä saat mukavan visualisoinnin kaikista haaroistasi ja siitä, kuinka monta tekemistä kullekin on ainutlaatuinen.

17. Katso vertailusivu

Jos olet kiinnostunut jostakin haarasta ja haluat nähdä sen vertailun päähaaraan, napsauta Vertaa-painiketta Haarakonttori sivun sivuliikkeen vieressä. Tämä tuo esiin muutettujen tiedostojesi näkymän, yhtenäisen eron ja luettelon sitoutumisista.

18. Vedonpyyntösi

Voit seurata lähetettyjen ja odottavien vetopyyntöjen tilaa GitHubissa oleville projekteille napsauttamalla Vetopyynnöt -välilehti Kojelauta . Nyt kun osallistut sosiaalisen koodauksen verkostoon, tämä on tärkeää.

19. Profiilisi

Nyt kun olet aktiivinen ja koulutettu GitHub-yhteisön jäsen, varmista, että olet edustettuna kunnolla. Profiilisivusi, joka löytyy osoitteesta GitHub.com/[käyttäjänimi], on se, miten ihmiset voivat nähdä kuka olet ja ottaa sinuun yhteyttä. Muista ladata avatar osoitteeseen Gravatar.com ja täytä profiilisi.

Asiantuntijavinkki: GitHub-käyttöliittymä on erittäin mukava, mutta jos haluat tehdä jotain erilaista tai toistuvasti, GitHubilla on myös ihana pieni sovellusliittymä, jonka avulla voit tehdä komentosarjan kanssa melkein mitä tahansa, mitä voit tehdä web-käyttöliittymän kautta. Vierailla develop.GitHub.com oppia lisää minkä tahansa GitHub-vuorovaikutuksen komentosarjasta, mukaan lukien olemassa olevat kirjastot, jotta se olisi helppo tehdä Java, JavaScript, PHP, Perl, Python, Ruby ja muissa. Jos GitHub ei tee tarkalleen mitä haluat, on mahdollista, että voit taivuttaa sen omaan tahtoosi.