Ossza meg nyílt forráskódú projektjét a GitHubon keresztül

Ez a cikk először itt jelent meg 216. szám of .net magazin - a világ legkeresettebb weblaptervezői és -fejlesztői magazinja.

Amikor sokan hallják Git-et, azt gondolják, hogy GitHub. A GitHub a népszerű online Git tárhelyszolgáltatás, amely a közösségi hálózatok erejét eljuttatta a nyílt forráskódú kódoló közösséghez. És ahogy egyre több projekt vált Gitre, és egyre több vállalat és egyéni fejlesztő költözik oda nyílt és zárt forráskódú projektjeik megrendezésére, egyre fontosabb tudni, hogyan kell részt venni a közösségben.

A GitHub több mint 650 000 fejlesztőt regisztrált az oldalon, és több mint 500 000 egyedi nyílt forráskódú projektet és 1,8 millió teljes tárhelyet tárol. Több ezer társaság, például a Twitter, a Facebook, a Yahoo és a Rackspace használja a GitHub-ot nyílt forráskódú projektjeik megosztására és a nagyobb nyílt forráskódú közösség közreműködésére. Sokkal több vállalat használja a GitHub-ot, hogy kiszervezze kódtárhely-igényeit, vagy megtalálja a fejlesztőket, akiket alkalmazhat - a webhely megtanulása lehet az, hogy hogyan szerzi be következő munkáját, vagy mit használ, amikor odaér.



A múlt héten bevezettük a Git Version Control eszközt és ma megvizsgáljuk a GitHub használatát. Meglátjuk, hogyan hozhat létre fiókot, adhat hozzá egy meglévő projektet a Githez, és tolhatja a GitHub-ba, hogy megossza azt a szélesebb közösséggel. Végül megtanuljuk, hogyan járulhatunk hozzá valaki más nyílt forráskódú projektjéhez a GitHubon. Ennek az oktatóanyagnak a végére kényelmesen érezheti magát az új projektek beszerzésében a GitHubon, valamint hozzájárulhat a GitHubon felfedezett meglévő projektekhez.

1. Töltse le a Tornyot

Ha még nem használja a Git alkalmazást, letöltheti az ingyenes parancssori klienst a címen git-scm.com , vagy beszerezheti az egyik GUI-t. Itt a Tower kereskedelmi kereskedelmi GUI klienst fogjuk használni, 30 napos próbaverzióval, amelyről letöltheti git-tower.com .

2. Importálja és kövesse el a kódot

Töltse le a fájlokat felülről. Csomagolja ki a fájlt, és inicializálja a könyvtárat Git-tárként. A Towerben kattintson a gombra Helyi adattár létrehozása majd válassza ki az útját. Ezután kattintással megteheti az első elkötelezettséget Stage All majd a Elkövetni gomb.

3. Hozzon létre egy fiókot

Első célunk az lesz, hogy ezt a kódot a GitHub-ra toljuk, hogy megosszuk az emberekkel. Ehhez hozzon létre egy fiókot a GitHubon, ha még nincs. Menj GitHub.com/plans és kattintson a gombra Hozzon létre egy ingyenes fiókot gombra, majd töltse ki az egyszerű űrlapot.

4. Hozzon létre egy új adattárat

A projekt megosztásához létre kell hoznunk egy tárhelyet a GitHubon. Látnia kell egy gombot a címmel Új adattár azon az irányítópulton, amelyre a fiók létrehozása után kerül. Kattintson rá, és adja meg a projekt nevét a következő űrlapon az új adattár létrehozásához.

5. Adja hozzá a GitHub-ot távoli repóként

A Towerben válassza a lehetőséget Refs> Új távoli adattár hozzáadása és illessze be a projekt oldalon található HTML URL-t a megjelenő űrlap URL mezőjébe. Ezután írja be a GitHub jelszavát, majd kattintson a gombra rendben .

6. Nyomja meg a kódot a GitHub-ra

A Towerben kattintson a jobb gombbal az oldalsáv fő ágára, és válassza a lehetőséget Publish Branch . Ez a munkádat a GitHub-ra tolja, így elmehet a projekt oldalára, és megtekintheti közzétett munkáját. Mostantól csak kattints Nyom további frissítések megosztására.

7. Forkoljon egy adattárat

Megosztottunk néhány kódot, ezért most hozzá kellene járulnunk egy projekthez. Az első lépés a GitHub projekten való munkához az elágazás, azaz saját írható másolat megszerzése. Menj GitHub.com/schacon/example és kattintson a gombra Villa gombot ennek eléréséhez.

8. Klónozza azt az adattárat

A projekt továbbfejlesztése érdekében helyben be kell szereznünk egy példányt a szerkesztéshez. Válassza ki a HTTP URL-t a projekt oldalon, és mondja meg a Tower-nek, hogy klónozza azt helyettünk. Lépjen a Tárolók oldalra (parancs + D), kattintson a gombra Távoli adattár klónozása és illessze be a HTTP URL-t.

9. Végezzen változtatást

Most hozzá akarunk adni egy funkciót, ezért létre kell hoznunk egy elágazást a változtatások elvégzéséhez. Hozzon létre egy új elágazást (parancs + B) új funkció és nézd meg. Ezután másolja a két fájlt az eredeti példaprojektből ebbe a villás adattárba, és hajtsa végre az új módosításokat.

10. Tegye közzé a témaágat

Kattintson a jobb gombbal a új funkció ág az oldalsávon, és válassza a lehetőséget Publish Branch hogy közzétegye a GitHub-nak. Ez létrehoz egy új elnevezést új funkció a GitHubon, amelyet az Ön által meghamisított kód eredeti szerzője mostantól minden új munkájával láthat.

11. Indítson húzási kérelmet

Mivel munkánk ma már nyilvános és a GitHubon van, szeretnénk megmondani az eredeti projekt szerzőjének, hogy építse be a projektjébe. Ezt hívjuk pull kérésnek. Menjen a villás projekt oldalára
és kattintson a gombra Húzási kérelem gombot az űrlap megnyitásához.

12. Töltse ki és ellenőrizze a húzási kérését

Töltsön be meggyőző címet és leírást arról, miért kell munkáját beépíteni. Ban,-ben Vállalások lapon megtekintheti az Ön által küldött egyedi elkötelezettségek listáját. Ban,-ben A fájlok megváltoztak lapon láthatja a küldött üzenetek egységes különbségét.

13. Lásd a képbeli különbségeket

Ha egy képet módosít, a GitHub lehetővé teszi több nézet, például egymás mellett , elcsór , hagymahéj és különbség így láthatja, hogyan változtatták meg. Ha elégedett a változással, folytassa és küldje el a Pull Request-et.

14. Hozzászólás a megváltozott sorhoz

A lehívási kérelmek kódellenőrzési folyamatként működnek, és a GitHub lehetővé teszi, hogy még mielőtt elfogadnák őket, beszélgethet a módosításokról. Menj a A fájlok megváltoztak az imént elküldött kérelem nézete és kommentár egy kódsorhoz.

15. Nézd meg a pull request megbeszélést

Miután megjegyzést fűzött hozzá, a fő kérési oldalon megtekintheti a megjegyzés és az összes kapcsolódó információt a lekérési kérelemhez. Kattintson a Vita lapon láthatja, hogy a megjegyzés és a kódkörnyezet hogyan szerepel most a fő beszélgetési listában.

16. Fióklista megtekintése

Most, hogy egynél több ágat helyezett el a projektjéhez, összehasonlíthatja őket a Fiókjegyzék Kilátás. Ha rákattint Fiókjegyzék alatt Forrás fülön szép képet jeleníthet meg az összes fiókjáról, és arról, hogy hány végrehajtás van egyedi.

17. Lásd az összehasonlító oldalt

Ha érdekel az egyik ág, és szeretné megtudni, hogy hasonlít a fő ágához, kattintson az Összehasonlítás gombra Fiókjegyzék oldal az ág mellett. Ez megjeleníti a megváltozott fájlok nézetét, egy egységes diff-et és egy listát a végrehajtásokról.

18. A húzási kéréseid

A GitHubon lévő projektek elküldött és függőben lévő lekérési kérelmének állapotának nyomon követéséhez kattintson a Húzási kérelmek fülre a Irányítópult . Most, hogy részt vesz egy közösségi kódolási hálózatban, ez fontos.

19. A profilod

Most, hogy a GitHub közösség aktív és képzett tagja vagy, győződjön meg róla, hogy megfelelően képviselteti magát. A profiloldalán, amelyet a GitHub.com/[felhasználónév] címen talál, megtudhatja, hogy az emberek hogyan láthatják, hogy ki vagy, és felveheti veled a kapcsolatot. Ügyeljen arra, hogy feltöltsön egy avatárt a következő címre: Gravatar.com és töltse ki a profilját.

Szakértői tipp: A GitHub felhasználói felülete nagyon szép, de ha valami mást vagy ismétlődést kell tennie, a GitHub rendelkezik egy kedves kis API-val is, amely lehetővé teszi, hogy egy szkriptmel bármit megtehessen, amit a webes felhasználói felületen keresztül megtehet. Látogatás develop.GitHub.com többet megtudhat arról, hogyan kell szkriptelni bármely GitHub-interakciót, beleértve a meglévő könyvtárakat is, hogy ezt Java, JavaScript, PHP, Perl, Python, Ruby és más alkalmazásokban megkönnyítse. Ha a GitHub nem pontosan azt csinálja, amit akar, akkor elképzelhető, hogy az ön akarata szerint hajlíthatja.