Git

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.

• Více o instalaci a úvodní konfiguraci: Git: Instalace.

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 Code, Visual Studio,...

Založení projektu v příkazovém řádku

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.
• Více viz Git: Versioning.

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í a připojení repozitáře

• Vytvořte si účet na serveru Github.com a založte repozitář.
• Připravte si složku, ve které vytvoříte lokální kopii repozitáře a přejděte do ní.

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

• Vytvořte lokální kopii vzdáleného repozitáře:

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

• Vznikne tak složka:

cd c:\users\student\Dokumenty\develop\repository-name

• Přejděte do nově vytvořené složky a provádějte úpravy dle potřeby:

cd c:\users\student\Dokumenty\develop\repository-name

• Následně vytvořte commit a odešlete ho do repozitáře:

git add .
git commit

• Zkontrolujte změny, které mezitím v repozitáři mohli provést vaši kolegové. Poté verzi nahrajte:

git pull
git push

• Více viz Git: Repository.

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)

Větvení

• Při opravě chyb nebo přidání nových funkcí musíte obvykle kód dočasně „rozbít“ a poté doplnit požadované změny.
• Pokud s repozitářem pracuje více lidí, je vhodné tyto změny vyřešit v samostatné větvi (branch).
• Ostatní tak mají kód stále k dispozici v původní neporušené verzi.
• Pamatujte si: 1 změna = 1 větev.
• Více viz Git: Branch

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