Git

Verze z 11. 11. 2020, 17:46

Git

• Git je jedním z nejoblíbenějších verzovacích systémů současnosti.
• Jedná se o aplikaci, která umí:
  • sledovat změny v souborech,
  • ukládat průběžné verze dokumentů a připojovat k nim komentáře,
  • vracet se k předchozím verzím.
• Typicky se využívá pro správu zdrojového kódu projektu, ale lze ji využít i k sledování verzí libovolného dokumentu.

Instalace

• Git nainstalujete jako běžnou aplikaci ze stránek: Git-scm.com
• Doporučujeme zvolit si při instalaci vhodný textový editor pro psaní komentářů.

  Výchozí volbou je editor vim, známý z unixových systémů. Jeho ovládání ale pro většinu uživatelů Windows není příliš přívětivé — aspoň než si zvyknete.

Správa verzí lokálně

• Git lze ovládat buď z příkazového řádku, bývá ale vestavěn ve většině programátorských vývojových prostředí (IDE) — například NetBeans, IntelliJ IDEA, Visual Studio,...

Založení projektu

git init

Zařazení aktuálních změn dokumentu do správy verzí

git add soubor
git add .

• Zařadí všechny soubory v aktuálním adresáři.

Vytvoření verze dokumentu

git commit

• Následně je třeba zapsat název aktuální verze a popis.

GitHub

• GitHub je veřejný server, kde si můžete ukládat aktuální verze svého projektu.
• Váš Git umí stáhnout z GitHubu aktuální verzi a posléze nahrát zpět provedené změny.
• Obdobných serverů existuje více, GitHub patří k nejznámnějším.

Práce s repozitářem

Vytvoření repozitáře

• Vytvořte si účet na serveru Github.com.
• Vytvořte repozitář.

Připojení repozitáře

• Vytvořte složku, kterou chcete používat pro místní práci s repozitářem.
• Spusťte příkazový řádek (například Win+R → cmd).
• Přejděte vytvořené složky. Například pro složku c:\users\student\Dokumenty\develop\project napište:

c:
cd c:\users\student\Dokumenty\develop\project

• Vytvořte základní strukturu pro Git:

git init

• Připojte repozitář:

git pull https://github.com/username/repository-name

• Obsah repozitáře se stáhne do složky. Obsah se stáhne do větve master.
• Protože od října 2020 pojmenovává GitHub.com hlavní větev jako main v důsledku kampaně Black lives matter, přejmenujte aktuální větev na main:

git branch -m master main

Jak souvisí pojmenování hlavní větve projektu s Black lives matter??? Slovem master museli černí otroci oslovovat své vlastníky.

• Seznam aktuálně používaných větví si zobrazíte:

git branch

• Nastavte si výchozí repozitář pro nahrávání tak, abyste mohli posléze psát pouze git push a nemuseli uvádět cílový repozitář:

git push --set-upstream https://github.com/username/repository-name main

• Nyní můžete do složky nahrát požadované soubory a libovolně je upravit. Změny přidáte do gitu pomocí:

git add .

• Až jste s úpravami hotovi, zkontrolujte, jestli se obsah repozitáře mezitím nezměnil a stáhněte případné změny (mohli tam provést změny vaši kolegové):

git pull

• Nyní změny potvrďte:

git commit

• Upravenou verzi nahrajete do repozitáře příkazem:

git push

Markdown

• Markdown je hypertextový značkovací jazyk.
• Na rozdíl od HTML je určen k tomu, aby se dobře zapisoval na klávesnici a aby hyptertextové značky byly co nejúspornější.
• Je určen pro zápis textových dokumentů s formátováním, typicky takových, které půjdou zobrazit v podobě webové stránky.

Příklad dokumentu

# Zadání projektu — Evidence docházky
 
## Úvod
 
Vytvoříme aplikaci pro evidenci docházky do kroužku. 
 
Aplikace bude umět:
1. Vytvořit termín hodiny/schůzky/setkání.
2. Zobrazit seznam přihlášených do kroužku.
 
## Požadavky
 
Dále musí aplikace splňovat následující požadavky:
- Přístupnost kdekoli (tělocvična, třída).
   - Musí běžet i na mobilních zařízeních.
   - Požadavek dostupnosti Wi-Fi je akceptovatelný.
- Snadné ovládání pro člověka, který není zběhlý v IT.

Základy syntaxe

• Nadpisy různých úrovní
  • Uvozujeme znakem mřížka (#).
  • Počet znaků mřížka udává úroveň nadpisu.
• Seznamy s odrážkami
  • Na začátku řádku uvedete pomlčku (-).
  • Pro vnořené seznamy uveďte tabulátor a pak až pomlčku.
• Číslované seznamy
  • První řádek začíná znaky jedničkou a tečkou (1.).
  • Další body seznamu pak libovolným číslem, následovaným tečkou.
  • Body v rámci jednoho seznamu se vždy přečíslují od jedničky dál.

Popis syntaxe podrobněji

• Základní syntaxe (→ MarkdownGuide.org)

Dotazy a problémy

Jak vytvořím v repozitáři složku?

1. Proveďte pull-request a vytvořte si kopii repozitáře ve složce na svém počítači.
2. Nyní můžete běžně vytvořit podsložky a soubory dle potřeby.
3. Proveďte pull → add → commit → push, čímž změny nahrajete zpět do repozitáře (viz práce s repozitářem).

Nelze přistupovat do repozitáře na GitHub — error 403

• Máte problém s tím, že se nelze přihlásit pomocí uložených oprávnění.
• Pokud se při:

git config --system --list

• zobrazí (mimo jiné):

credential.helper=manager

• Potom spusťte 'Správce pověření' ('Credentials Manager'):

  → Přihlašovací údaje systému Windows

  → git:https://github.com

  → Odebrat

• Při dalším příkazu by se vás Git měl zeptat na přihlašovací údaje.
• Další variantou je, že vám vlastník repozitáře nedal právo zapisovat:

  Settings→ Manage Access

Zdroje

Kurz na Learn2Code.cz ==

• Learn2Code.cz → Git a GitHub