Stručný průvodce používáním Githubu

Tento kurz je krátkým průvodcem instalací a používáním GitHubu. Tady je postup, jak vytvořit místní úložiště, jak připojit toto místní úložiště ke vzdálenému úložišti Github (kde to může vidět každý), jak provést změny a nakonec jak poslat veškerý obsah z místního úložiště na GitHub, mimo jiné společné úkoly.

Než začneme, je důležité si uvědomit, že tento výukový program předpokládá základní pochopení pojmů používaných v Gitu: push, pull, commit, repository atd. Vyžaduje také předchozí registraci na adrese GitHub.

Instalace Github

Na Debianu / Ubuntu a jeho derivátech:

sudo apt-get nainstalovat git

En Fedora a deriváty:

sudo yum install git

En Oblouk a deriváty:

pot pacman -S git

Počáteční nastavení Github

Jakmile je instalace úspěšně dokončena, dalším krokem je konfigurace podrobností konfigurace uživatele GitHub. Chcete-li to provést, použijte následující příkazy a nahraďte „username“ svým uživatelským jménem GitHub a „email_id“ e-mailovou adresou použitou k vytvoření účtu GitHub.

git config --global user.name "uživatelské jméno" git config --global user.email "email_id"

Vytvořte místní úložiště

První věcí je vytvořit ve svém počítači složku, která bude sloužit jako místní úložiště. Chcete-li to provést, stačí spustit následující příkaz:

git init Mytest

Tento příkaz vytvoří složku MyTest. Díky podsložce .init bude MyTest rozpoznán jako místní úložiště Git.

Pokud je úložiště úspěšně vytvořeno, zobrazí se řádek podobný tomuto:

Inicializované prázdné úložiště Git v /home/tu_usuario/Mytest/.git/

Poté musíte přejít do složky MyTest:

cd Mytest

Vytvořte soubor README k popisu úložiště

Soubor README se obecně používá k popisu toho, co úložiště obsahuje nebo o čem projekt je. Chcete-li jej vytvořit, stačí spustit:

gedit PŘEČTĚTE SI

Jakmile zadáte popis úložiště, nezapomeňte uložit změny.

Přidání souborů úložiště do indexu

Toto je důležitý krok. Než budete moci nahrát své změny na Github nebo na jiný server kompatibilní s Git, musíte indexovat všechny soubory obsažené v místním úložišti. Tento index bude obsahovat nové soubory i změny stávajících souborů v místním úložišti.

V našem případě naše místní úložiště již obsahuje nový soubor: README. Proto vytvoříme další soubor s jednoduchým programem C, kterému budeme říkat example.c. Jeho obsah bude:

#include int main () {printf ("ahoj svět"); návrat 0; }

Takže nyní máme v našem lokálním úložišti 2 soubory: README a example.c.

Dalším krokem je přidání těchto souborů do indexu:

git přidat README git přidat smaple.c

Příkaz „git add“ lze použít k přidání libovolného počtu souborů a složek do indexu. Chcete-li přidat všechny změny, aniž byste zadali název souborů, je možné spustit příkaz „git add“. (s tečkou na konci).

Uložte změny provedené v indexu

Jakmile jsou přidány všechny soubory, je možné tyto změny zaznamenat provedením toho, co se v žargonu nazývá potvrzení. To znamená, že přidávání nebo úpravy souborů je dokončeno a změny lze nahrát do vzdáleného úložiště Github. Chcete-li to provést, musíte provést následující příkaz:

git commit -m "zpráva"

„Zpráva“ může být jakákoli zpráva, která stručně popisuje dané změny, například: „Přidal jsem takovou funkci“ nebo „Opravil jsem takovou věc“ atd.

Vytvořte úložiště na GitHubu

Název úložiště musí být stejný jako název úložiště v místním systému. V tomto případě to bude „MyTest“. Chcete-li to provést, musíte se nejprve přihlásit GitHub. Poté klikněte na znaménko plus (+) v pravém horním rohu stránky a vyberte možnost „vytvořit nové úložiště“. Nakonec musíte vyplnit údaje a kliknout na tlačítko „vytvořit úložiště“.

Jakmile to provedete, vytvoří se úložiště a bude možné nahrát obsah místního úložiště do úložiště GitHub. Chcete-li se připojit ke vzdálenému úložišti na GitHubu, musíte spustit příkaz:

git remote add origin https://github.com/user_name/Mytest.git

Zatlačte soubory z místního úložiště do úložiště GitHub

Posledním krokem je poslat obsah místního úložiště do vzdáleného úložiště pomocí příkazu:

git push master původu

Zbývá pouze zadat přihlašovací údaje (uživatelské jméno a heslo).

Tím se nahraje veškerý obsah složky MyTest (místní úložiště) do GitHub (externí úložiště). U následujících projektů již tyto kroky nemusíte provádět úplně od začátku. Místo toho můžete začít přímo od kroku 3. Nakonec nezapomeňte, že změny budou k dispozici na webu Github.

Vytvoření větve

Když vývojáři chtějí opravit chyby nebo přidat nové funkce, často vytvoří větev nebo kopii kódu, aby se mohli zavázat samostatně, aniž by to ovlivnilo původní projekt. Poté, co jsou hotové, mohou sloučit tuto větev zpět do hlavní větve (hlavní).

Chcete-li vytvořit novou větev, existují dvě možnosti:

Dlouhá možnost:

git branch mirama # vytvořit novou větev s názvem mirama git checkout mirama - přepnout na používání větve mirama.

Krátká možnost:

git checkout -b mirama - vytvořte a přepněte na používání větve mirama

Po provedení změn je přidejte do indexu větve a proveďte odpovídající potvrzení:

git přidat. git commit -m "změny miramy"

Poté se musíte vrátit do hlavní větve a provést změny provedené v miramě:

git pokladna mistr git sloučit mirama

Nakonec musíte odstranit miramu (protože změny byly začleněny do hlavní):

git větev -d mirama

A nahrajte předlohu na Github:

git push master původu

Vytvoření odvozeného úložiště Git (vidlice)

Díky Gitu a existenci velkých veřejných knihoven repozitářů, jako je Github, většinou není nutné začít programovat náš projekt od nuly. V těchto případech je možné použít tento základní kód k vytvoření nového projektu.

Chcete-li to udělat, první věc, kterou musíte udělat, je rozvětvení existujícího úložiště, tj. Projekt z něj odvozený na základě kódu původního projektu. Na Githubu toho lze dosáhnout kliknutím na odpovídající tlačítko, jak je vidět na obrázku níže.

Poté musíme naklonovat úložiště tohoto nového projektu do našeho počítače. Jako příklad můžeme použít mé úložiště Ankifox, rozšíření pro Firefox, které umožňuje přidávat slova i, který je k dispozici na Github:

git klon https://github.com/usemoslinux/Ankifox.git

Nezapomeňte nahradit https://github.com/usemoslinux/Ankifox.git adresou URL odpovídající vašemu projektu. Získání této adresy je velmi snadné, jak je vidět na obrázku níže.

Tento příkaz vytvoří adresář s názvem «Ankifox», inicializuje v něm adresář .git a stáhne všechna data z tohoto úložiště, aby mohl pracovat s nejnovější verzí.