Připojte se k trendu sociálního kódování a přispějte do úložišť GitHub

Už jste někdy našli balíček na GitHubu, který se vám líbil, ale chtěli jste přidat rychlou funkci, opravit nalezenou chybu nebo jen přispět k otevřenému zdroji jako celku? Připojte se k trendu sociálního kódování, sdílejte své dovednosti a pomozte využívat svět otevřeného zdroje. V tomto článku se dozvíte vše o tom, jak přispět kódem do úložiště na GitHubu nebo jakékoli hostované službě git.

Získejte nastavení

Tento článek předpokládá, že již máte účet GitHub, ale pokud ne, prosím rychle zaregistrujte si bezplatný účet. Také se ujistěte, že již máte sakra nainstalován spuštěním následujícího příkazu v terminálu:

git --verze

Pokud se místo čísla verze zobrazí zpráva „Příkaz nebyl nalezen“, můžete nainstalovat sakra s příkazem:

sudo apt-get -y nainstalovat git

Vidlice úložiště

Nejprve musíte vybrat úložiště, do kterého chcete přispět, a navštívit jej ve webovém prohlížeči. Pokud si nejste jisti, které úložiště zvolit, můžete použít demo úložiště umístěné na https://github.com/mdizak/muo_demo

. Toto je jednoduchá ukázka a můžete pro ni vytvořit požadavky na vyžádání pro účely testování a učení.

Při prohlížení úložiště ve webovém prohlížeči vyhledejte Repozitář vidlic tlačítko a klikněte na něj. Tím se úložiště rozdělí na váš vlastní účet GitHub a přenese vás na něj. Dále musíte naklonujte nově rozvětvené úložiště, tak otevřete terminál na místním počítači a spusťte:

Jak klonovat úložiště pomocí GitHub Desktop

Chcete se seznámit se softwarem na GitHubu? Zde je návod, jak se dostat na východ pomocí efektivního nástroje GitHub Desktop.

git klon https://github.com/myusername/muo_demo.git
cd muo_demo

Přirozeně zajistěte, abyste výše uvedenou adresu URL změnili na adresu svého nově rozvětveného úložiště. Po klonování přidejte původní úložiště jako upstream pomocí příkazu:

git remote add upstream https://github.com/mdizak/muo_demo.git

Ujistěte se, že ve výše uvedeném příkazu změníte adresu URL původního úložiště, které jste naklonovali. To znamená, že git je jeho nadřazeným úložištěm, ze kterého pracujete.

Připravte místní úložiště

Pokaždé, než začnete pracovat na novém příspěvku, ujistěte se, že používáte nejnovější kódovou základnu nadřazeného úložiště. V adresáři projektu spusťte v terminálu následující příkazy:

git pokladna master
git pull upstream master && git push origin master

První příkaz zajistí, že právě pracujete v hlavní větvi, a druhý příkaz synchronizuje nadřazené úložiště s místními i GitHub úložištěmi. Tím je zajištěno, že upravujete nejaktuálnější kódovou základnu a nepracujete se zastaralým kódem.

Nezapomeňte také zkontrolovat, zda má projekt soubor allow.md, a pokud ano, postupujte podle pokynů. Někdy mají projekty specifické pokyny týkající se způsobu poskytování příspěvků, které je třeba vždy dodržovat.

Vytvořte novou pobočku

Musíte vytvořit novou větev, která bude obsahovat všechny úpravy tohoto příspěvku, která bude později správci projektu sloučena do hlavního úložiště GitHub. Větev musí být alfanumerická a lze ji pojmenovat, jak si přejete.

I když to není nutné, obecně se považuje za běžné předvolby názvu pobočky oprava hotfix / pro rychlé opravy chyb nebo Vlastnosti/ pro přidané funkce. Vyberte požadovaný název pobočky a spusťte příkaz:

git checkout -b feature / my_cool_feature

Vždy byste měli vytvořit samostatnou větev pro každou opravu funkce / chyby a nikdy nezahrnout více příspěvků do jedné. To pomáhá udržovat plynulý vývojový tok a také pomáhá zajistit, aby byl váš příspěvek přijat a zahrnut do projektu.

Nyní, když byla vaše pobočka vytvořena, pokračujte a dokončete všechny nezbytné úpravy, které byste chtěli, pomocí standardního pracovního postupu git.

Potvrdit a vytvořit požadavek na vyžádání

Jakmile dokončíte práci na svém příspěvku, odevzdejte jej a správné potvrzení zprávy a posuňte jej do svého rozvětveného úložiště pomocí příkazů:

git commit --file commit.txt
git push -u origin feature / my_cool_feature

Posledním krokem je vytvoření požadavku na vytažení, který upozorní správce projektu, že čeká na nový příspěvek. Navštivte rozeklaný repozitář GitHub ve webovém prohlížeči a uvidíte rozevírací tlačítko umožňující změnit pobočky. Změňte svou nově vytvořenou větev a další stránka bude obsahovat odkaz, který vám umožní vytvořit nový požadavek na stažení.

Po kliknutí na tento odkaz se zobrazí stránka s vaší zprávou o odevzdání a se všemi změnami, které jste v kódu provedli. Zkontrolujte vše, abyste se ujistili, že je to správné, přidejte potřebnou další zprávu pro správce a odešlete požadavek na vyžádání.

Pokračujte v přispívání do GitHubu

Gratulujeme, úspěšně jste odeslali příspěvek do projektu GitHub!

Váš požadavek na vyžádání nyní čeká na kontrolu a schválení správci projektu a prostřednictvím e-mailu budete informováni, zda byl či nebyl schválen, a se všemi zprávami, které pro vás mají. Nyní, když jste se naučili, jak přispívat na projekty na GitHubu, pokračujte vpřed a pomozte růst open source komunita.

Jak přidat více paměti RAM do zařízení Android pomocí karty MicroSD

Pokud váš telefon nebo tablet s Androidem běží trochu pomalu, bude možná potřeba trochu více RAM. S tím můžeme pomoci.

O autorovi