GitHub, co to je a jak jej používat

GitHub je software široce používaný vývojovými týmy pro vývoj verzí.

Je to užitečné, když na projektu pracuje více lidí.

Předpokládejme například, že tým vývojářů softwaru chce vytvořit webovou stránku a všichni potřebují při práci na projektu současně aktualizovat kód. V tomto případě Github pomáhá vytvořit centralizované úložiště, kam může každý nahrávat, upravovat a spravovat soubory programového kódu.

Než začnete používat GitHub, musíte si vytvořit účet GitHub.

sklad

Úložiště se obvykle používá k organizaci projektu aplikačního softwaru. Úložiště mohou obsahovat složky a soubory, obrázky, videa, tabulky a datové sady – vše, co váš projekt potřebuje. Úložiště často obsahuje soubor README, soubor s informacemi o vašem projektu.

Soubory README jsou psány v jazyce Markdown jako prostý text. Můžete se poradit tuto stránku web jako rychlý odkaz na jazyk Markdown. GitHub vám umožňuje přidat soubor README současně s vytvořením nového úložiště. GitHub také nabízí další běžné možnosti, jako je licenční soubor, ale zpočátku nemusíte žádné vybírat.

Chcete-li vytvořit nové úložiště, vyberte v nabídce vpravo nahoře New repository. Postupujte podle následujících kroků:

1. V pravém horním rohu libovolné stránky použijte rozbalovací nabídku a vyberte New repository.

1. Do pole Název úložiště zadejte first-repository.
2. Do pole Popis napište krátký popis.
3. Vyberte Přidat soubor README.
4. Vyberte, zda bude vaše úložiště veřejné nebo soukromé.
5. Cvaknutí Create repository.

Vytvoření pobočky

Vytvoření větve vám umožní mít několik verzí úložiště současně.

Ve výchozím stavudefinita, úložiště first-repository má pojmenovanou pobočku main která je považována za větev definitivní. V úložišti můžete vytvořit další větve k main first-repository. Pomocí větví můžete mít různé verze projektu současně. To je užitečné, když chcete do projektu přidat nové funkce bez změny hlavního zdrojového kódu. Práce provedená na různých větvích se na hlavní větvi nezobrazí, dokud ji nesloučíte. Větve můžete použít k experimentování a provádění změn před jejich odevzdáním do main.

Když vytvoříte větev z hlavní větve, vytvoříte kopii neboli snímek větve main tak, jak byla v daném okamžiku. Pokud někdo jiný provedl změny v hlavní větvi, když jste pracovali na své větvi, můžete tyto aktualizace odeslat.

Na následujícím diagramu můžeme vidět:

Hlavní větev
Volala se nová pobočka feature
Cesta, kterou feature provede před sloučením s hlavním

Vytvoření větve pro novou implementaci nebo opravu chyb je jako uložení souboru. S GitHub vývojáři softwaru používají větve k tomu, aby opravovali chyby a pracovali s funkcemi odděleně od hlavní produkční větve. Když je změna připravena, je sloučena do hlavní větve.

Vytvořme větev

Po vytvoření našeho úložiště přejděte na kartu <>Code(1) úložiště:

Klikněte na hlavní (2) rozevírací nabídku a poté nové pojmenujte branch (3)

Klikněte na Create branch: first branch from 'main'

Teď máme dva branch, main e first-branch. Právě teď vypadají úplně stejně. Později přidáme změny do nového branch.

Proveďte a potvrďte změny

Právě vytvořil nový branch, GitHub vás přivedl na code page pro nové first-branch, což je kopie main.

Můžeme provádět a ukládat změny souborů v úložišti. Na GitHubu se volají uložené změny commit. Každý commit má zprávu od commit související, což je popis, který vysvětluje, proč byla provedena konkrétní změna. Zprávy z commit zachycují historii změn, aby ostatní přispěvatelé pochopili, co bylo provedeno a proč.

Pod větví first-branch vytvořen, klikněte na soubor README.md a poté na tužku soubor upravte.

V editoru pište pomocí Markdown.

V krabici Commit changes (Náhled), píšeme zprávu commit popisující změny.

Nakonec klikněte na tlačítko Commit changes.

Tyto změny budou provedeny pouze v souboru README first-branch, takže nyní tato větev obsahuje jiný obsah než ta hlavní.

Otevření jednoho pull request

Nyní, když máme změny ve větvi mimo hlavní, můžeme jednu otevřít pull request.

Le pull request jsou srdcem spolupráce na GitHubu. Když otevřete a pull request, navrhujete své změny a žádáte někoho, aby provedl a review e pull vašeho příspěvku a sloučit je do jejich oboru. The pull request ukázat rozdíly obsahu obou větví. Změny, sčítání a odečítání jsou zobrazeny různými barvami.

Jakmile provedete potvrzení, můžete otevřít žádost o stažení a zahájit diskuzi, a to ještě před dokončením kódu.

Pomocí funkce @mention GitHubu ve vaší zprávě pull request, můžete požádat konkrétní lidi nebo týmy o zpětnou vazbu, bez ohledu na jejich umístění.

Můžete dokonce otevřít pull request ve svém úložišti a sami je sloučte. Je to skvělý způsob, jak se naučit stream GitHub před prací na větších projektech.

Aby jeden pull request musíš:

• Klikněte na záložku pull request vašeho úložiště first-repository.

• Cvaknutí New pull request
• V krabici Example Comparisons, vyberte větev, kterou jste vytvořili, first-branch, k porovnání s hlavní (originál).
• Zkontrolujte své změny v rozdílech na stránce Porovnat a ujistěte se, že jsou to ty, které chcete odeslat.

• Cvaknutí Create pull request.

• Dejte svému titulu pull request napište krátký popis vašich změn. Můžete zahrnout emotikony a přetáhnout obrázky a gify.

• Volitelně napravo od názvu a popisu klikněte na vedle položky Recenzenti. Příjemci, Štítky, Projekty nebo Milníky a přidejte kteroukoli z těchto možností k vašim pull request. Zatím je nemusíte přidávat, ale tyto možnosti nabízejí několik způsobů spolupráce pomocí vašeho pull request.
• Cvaknutí Create pull request.

Vaši spolupracovníci nyní mohou zkontrolovat vaše změny a navrhovat.

Sloučit své pull request

V tomto posledním kroku sloučíte svou větev first-branch v hlavní větvi. Po sloučení pull request, změní se na pobočku first-branch bude vložen do hlavního souboru.

Někdy může požadavek na stažení zavést změny kódu, které jsou v konfliktu s existujícím kódem na main. Pokud dojde ke konfliktům, GitHub vás na konfliktní kód upozorní a zabrání sloučení, dokud se konflikty nevyřeší. Můžete provést potvrzení, které vyřeší konflikty, nebo použít komentáře v žádosti o stažení k prodiskutování konfliktů se členy vašeho týmu.

• Cvaknutí Merge pull request pro sloučení změn do hlavního.

• Cvaknutí Confirm merge. Obdržíte zprávu, že požadavek byl úspěšně sloučen a požadavek byl uzavřen.
• Cvaknutí Delete branch. Nyní, když vaše richiesta pull je sloučena a vaše změny jsou na hlavním, můžete větev bezpečně smazat first-branch. Pokud chcete ve svém projektu provést další změny, můžete vždy vytvořit novou větev a tento proces zopakovat.

Ercole Palmeri