Pripojte sa k trendu kódovania v sociálnej sieti a prispievajte do úložísk GitHub

Našli ste niekedy balíček na GitHube, ktorý sa vám páčil, ale chceli ste pridať rýchlu funkciu, opraviť chybu, ktorú ste našli, alebo možno len prispieť k otvorenému zdroju ako celku? Pripojte sa k trendu sociálneho kódovania, podeľte sa o svoje zručnosti a pomôžte využívať svet otvoreného zdroja. V tomto článku sa dozviete všetko o tom, ako prispieť kódom do úložiska na GitHub alebo do ktorejkoľvek hostovanej služby git.

Získajte nastavenie

Tento článok predpokladá, že už účet GitHub máte, ale ak nie, rýchlo zaregistrujte si účet zadarmo. Uistite sa tiež, že už máte git nainštalovaný spustením nasledujúceho príkazu v termináli:

git --verzia

Ak namiesto zobrazenia čísla verzie dostanete správu „príkaz sa nenašiel“, môžete nainštalovať git príkazom:

sudo apt-get -y nainštalovať git

Vidlica úložiska

Najprv musíte zvoliť úložisko, do ktorého chcete prispieť, a navštíviť ho vo svojom webovom prehliadači. Ak si nie ste istí, ktoré úložisko zvoliť, môžete použiť ukážkové úložisko umiestnené na adrese

https://github.com/mdizak/muo_demo. Toto je jednoduchá ukážka a môžete proti nej vytvoriť požiadavky na stiahnutie pre účely testovania a učenia.

Pri prezeraní úložiska vo webovom prehliadači vyhľadajte ikonu Repozitár vidlice tlačidlo a kliknite naň. Toto rozdelí úložisko na váš vlastný účet GitHub a privedie vás k nemu. Ďalej musíte naklonujte novo rozvetvené úložisko, tak otvorte terminál na lokálnom počítači a spustite:

Ako klonovať úložisko pomocou GitHub Desktop

Chcete sa oboznámiť so softvérom na GitHub? Tu je postup, ako sa dostať na východ pomocou zjednodušeného nástroja GitHub Desktop.

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

Prirodzene sa uistite, že zmeníte vyššie uvedenú adresu URL na svoje novo vidlicové úložisko. Po naklonovaní pridajte pôvodné úložisko ako upstream pomocou príkazu:

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

Nezabudnite zmeniť adresu URL vo vyššie uvedenom príkaze s adresou pôvodného úložiska, ktoré ste naklonovali. To znamená, že je to nadradené úložisko, z ktorého pracujete.

Pripravte miestne úložisko

Zakaždým, keď začnete pracovať na novom príspevku, skontrolujte, či máte spustený najnovší kódový základ nadradeného úložiska. V adresári projektu spustite v termináli nasledujúce príkazy:

majster pokladne git
git pull upstream master && git push origin master

Prvý príkaz zabezpečí, že momentálne pracujete v hlavnej vetve, a druhý príkaz synchronizuje nadradené úložisko s miestnymi aj GitHub archívmi. To zaisťuje, že upravujete najaktuálnejšiu kódovú základňu a že nepracujete so zastaraným kódom.

Nezabudnite tiež skontrolovať, či má projekt súbor allow.md, a ak áno, postupujte podľa jeho pokynov. Niekedy majú projekty špecifické pokyny týkajúce sa spôsobu poskytovania príspevkov, ktoré by sa mali vždy dodržiavať.

Vytvorte novú pobočku

Musíte vytvoriť novú vetvu, ktorá bude obsahovať všetky úpravy tohto príspevku, ktoré správcovia projektu neskôr zlúčia do hlavného úložiska GitHub. Vetva musí byť alfanumerická a dá sa pomenovať čímkoľvek chcete.

Aj keď to nie je potrebné, všeobecne sa považuje za bežné zdvorilosť predpona názvu pobočky rýchla oprava / pre rýchle opravy chýb alebo funkcia / pre pridané funkcie. Vyberte požadovaný názov pobočky a spustite príkaz:

git checkout -b feature / my_cool_feature

Pre každú funkciu / opravu chyby by ste mali vždy vytvoriť samostatnú vetvu a nikdy nesmiete zahrnúť viac príspevkov do jednej. To pomáha udržiavať plynulý vývojový tok a tiež pomáha zabezpečiť, aby bol váš príspevok prijatý a zahrnutý do projektu.

Teraz, keď je vaša pobočka vytvorená, pokračujte a dokončite všetky potrebné úpravy, ktoré chcete, so štandardným pracovným tokom git.

Potvrdiť a vytvoriť požiadavku na stiahnutie

Keď ste dokončili prácu na svojom príspevku, zaviažte ju a správna správa o odovzdaní a zatlačte ho do svojho rozvetveného úložiska pomocou príkazov:

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

Posledným krokom je vytvorenie žiadosti o stiahnutie, ktorá varuje správcov projektu, že čaká na nový príspevok. Navštívte vidlicové úložisko GitHub vo webovom prehliadači a zobrazí sa rozbaľovacie tlačidlo, ktoré vám umožňuje meniť pobočky. Zmeňte svoju novo vytvorenú vetvu a na nasledujúcej stránke bude uvedený odkaz, ktorý vám umožní vytvoriť novú požiadavku na stiahnutie.

Po kliknutí na tento odkaz sa zobrazí stránka, ktorá zobrazuje vašu správu o potvrdení a všetky zmeny, ktoré ste v kóde vykonali. Skontrolujte všetko, aby ste sa ubezpečili, že je to správne, pridajte ďalšiu potrebnú správu pre správcov a odošlite žiadosť o načítanie.

Pokračujte v prispievaní do GitHubu

Gratulujeme, úspešne ste odoslali príspevok do projektu GitHub!

Vaša požiadavka na stiahnutie teraz čaká na posúdenie a schválenie správcami projektu a prostredníctvom e-mailu budete informovaní, či bola alebo nebola schválená, a o všetkých správach, ktoré pre vás majú. Teraz, keď ste sa naučili, ako prispievať na projekty na GitHube, pokračujte vpred a pomáhajte rozvíjať open source komunita.

Ako pridať viac pamäte RAM do zariadenia Android pomocou karty microSD

Ak váš telefón alebo tablet s Androidom beží trochu pomaly, možno bude treba trochu viac pamäte RAM. Môžeme s tým pomôcť.

O autorovi