Git Dokumentace

Základní ovládání repositáře

Práce se změnami

• git status Ukáže vám, které soubory jste změnili, co je připraveno k uložení a na co jste zapomněli.
• git add [soubor] Přidá změny do tzv. staging area (příprava před uložením).
• • Pokud chcete přidat všechno naráz, použijte git add ..
• git commit -m "zpráva" Vytvoří trvalý „snímek“ (bod obnovy) vašich změn. Zpráva by měla stručně popisovat, co jste udělali.
• git log Historie projektu. Zobrazí seznam všech uložených commitů, abyste věděli, kdo co pokazil (často jste to vy sami, což je ta smutnější část).

---

• git init Vytvoří ve složce nový lokální repositář. Tímto příkazem v podstatě říkáte Gitu: „Odteď se dívej, co tady dělám.“

• git clone [URL] Zkopíruje existující projekt z internetu (např. z GitHubu) k vám do počítače.

• • Například: git clone https://github.com/agentai-cz/hodnoceni.git pro HTTPS
• • nebo git clone git@github.com:agentai-cz/hodnoceni.git pro SSH

---

Spolupráce a větvení

• git branch Práce s větvemi. Pomocí git branch [název] vytvoříte novou větev, kde můžete experimentovat, aniž byste rozbili hlavní kód.
• git checkout [název-větve] Přepínání mezi větvemi. (V novějších verzích Gitu se pro totéž používá také přehlednější git switch).
• git pull Stáhne nejnovější změny z online serveru a rovnou je sloučí s vaším kódem. Ideální udělat ráno před kávou.
• git push Odešle vaše lokální commity na server (GitHub/GitLab), aby je viděli i ostatní kolegové.

---

Nastavení identity (Povinné)

Tyto informace se stanou součástí každého vašeho commitu a nelze je zpětně (snadno) změnit.

• Jméno: git config --global user.name "Vaše Jméno"
• E-mail: git config --global user.email "vas@email.cz"

Výchozí název hlavní větve

Nastavení hlavní větve na main:

• git config --global init.defaultBranch main

Když Git potřebuje, abyste napsali delší text (například při řešení konfliktů), otevře výchozí systémový editor (často obávaný Vim, ze kterého začátečníci neumí odejít). Pokud preferujete něco jiného, nastavte si to:

• Pro VS Code: git config --global core.editor "code --wait"
• Pro Notepad++: git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"

---

Kontrola nastavení

Pokud si nejste jistí, co všechno už máte nastaveno, nebo jestli jste neudělali v e-mailu překlep, použijte:

• git config --list

---

Nastavení propojení s GitHubem (SSH klíče)

Pro pohodlnou a bezpečnou práci s GitHubem (bez nutnosti zadávat heslo nebo token při každém nahrávání kódu) se doporučuje nastavit ověřování pomocí SSH klíčů.

1. Vytvoření SSH klíče

Otevřete si terminál (na Linuxu/Macu) nebo příkazový řádek Git Bash (na Windows) a zadejte následující příkaz. Nahraďte e-mail svým e-mailem, který používáte na GitHubu:

ssh-keygen -t ed25519 -C "vas@email.cz"

Až budete vyzváni k uložení klíče, můžete stisknout Enter, čímž se klíč uloží do výchozího umístění. Dále můžete zadat heslo pro ochranu samotného klíče (tzv. passphrase), ale pro zjednodušení můžete toto heslo přeskočit (pouze stiskem Enter naprázdno dvakrát po sobě).

2. Kde najít vytvořený klíč

• Linux / Mac: Klíč najdete ve skryté složce vašem domovském adresáři, typicky cestou cat ~/.ssh/id_ed25519.pub.
• Windows: Klíč je pravděpodobně uložen v cestě C:\Users\VaseJmeno\.ssh\id_ed25519.pub. Otevřete tento soubor například v Poznámkovém bloku.

Tento .pub soubor obsahuje váš veřejný klíč, který můžete bezpečně s kýmkoliv sdílet (nikdy naopak nikomu neposílejte ani neukazujte soubor bez koncovky .pub, což je váš privátní/tajný klíč).

3. Přidání klíče na GitHub

1. Zkopírujte celý obsah vytvořeného souboru id_ed25519.pub.
2. Přihlaste se na GitHub, vpravo nahoře klikněte na svůj profilový obrázek a jděte do Settings.
3. V levém menu vyberte SSH and GPG keys.
4. Klikněte na zelené tlačítko New SSH key.
5. Do pole Title zadejte nějaký název (například "Klíč doma z notebooku").
6. Do pole Key vložte dříve zkopírovaný obsah souboru (neobsahuje žádné odřádkování uprostřed).
7. Uložte tlačítkem Add SSH key.

4. Otestování připojení

Nyní se můžete zkusit spojit s GitHubem, abyste si ověřili, že je vaše spojení správně nastavené:

ssh -T git@github.com

Při prvním spuštění vás to může varovat ohledně autenticity hostitele (zpráva začínající The authenticity of host 'github.com...). Napište yes a potvrďte přes Enter.

Měla by se vám vrátit zpráva typu: Hi VaseJmeno! You've successfully authenticated, but GitHub does not provide shell access. To znamená, že propojení bylo úspěšné! A odteď nezapomeňte repozitáře při git clone stahovat pomocí URL pro SSH, např.: git clone git@github.com:agentai-cz/ai_hodnoceni.git