From b7a5a1ec32e93dbf87c694c4db2700c68031f3da Mon Sep 17 00:00:00 2001 From: archos Date: Wed, 5 Jun 2024 20:04:32 +0200 Subject: [PATCH] =?UTF-8?q?p=C5=99id=C3=A1n=20n=C3=A1vod=20na=20forknut?= =?UTF-8?q?=C3=AD=20repozit=C3=A1=C5=99e?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/fork-repo.md | 199 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 199 insertions(+) create mode 100644 docs/fork-repo.md diff --git a/docs/fork-repo.md b/docs/fork-repo.md new file mode 100644 index 0000000..e98152c --- /dev/null +++ b/docs/fork-repo.md @@ -0,0 +1,199 @@ +# Krok 1: Forknutí repozitáře na GitHubu + + +1. Přejdi na stránku původního repozitáře na GitHubu: + - Například: https://github.com/cheeaun/phanpy + +2. Klikni na tlačítko "Fork" v pravém horním rohu. + +3. Vyber svůj účet jako cíl pro nový fork. + +## Krok 2: Klonování forkovaného repozitáře z GitHubu + +1. Klonuj svůj forkovaný repozitář na lokální počítač pomocí SSH: + +```bash +git clone git@github.com:zkreml/phanpy-cz.git +cd phanpy-cz +``` + +## Krok 3: Vytvoření nového prázdného repozitáře na Gitea + +1. Přejdi na Gitea a přihlas se ke svému účtu. + +2. Klikni na tlačítko "New Repository" nebo "Nový Repozitář". + +3. Vyplň informace o repozitáři: + +- Repository Name: phanpy-cz +- Description: Krátký popis repozitáře (např. "Lokalizovaná verze projektu Phanpy do češtiny"). +- Visibility: Vyber, zda má být repozitář veřejný nebo soukromý. +- Initialize Repository: Nezaškrtávej volby pro přidání README, .gitignore nebo licence. + +Klikni na tlačítko "Create Repository" nebo "Vytvořit Repozitář". + +## Krok 4: Přidání vzdáleného repozitáře na Gitea + +1. Přidej nový vzdálený repozitář (Gitea): + +```bash +git remote add gitea ssh://git@git.arch-linux.cz:29418/Archos/phanpy-cz.git +``` +- Ověř nastavení vzdálených repozitářů: + +```bash +git remote -v +``` + +Měl bys vidět něco takového: + +```bash +origin git@github.com:zkreml/phanpy-cz.git (fetch) +origin git@github.com:zkreml/phanpy-cz.git (push) +gitea ssh://git@git.arch-linux.cz:29418/Archos/phanpy-cz.git (fetch) +gitea ssh://git@git.arch-linux.cz:29418/Archos/phanpy-cz.git (push) +``` + +## Krok 5: Pushnutí hlavní větve do Gitea + +1. Pushni hlavní větev do vzdáleného repozitáře na Gitea: + +```bash +git push gitea main +``` + +## Krok 6: Nastavení upstream repozitáře + +1. Přidej upstream repozitář pro synchronizaci s původním repozitářem: + +```bash +git remote add upstream git@github.com:cheeaun/phanpy.git +``` + +2. Ověř nastavení vzdálených repozitářů: + +```bash +git remote -v +``` + +Měl bys vidět něco takového: + +```bash +origin git@github.com:zkreml/phanpy-cz.git (fetch) +origin git@github.com:zkreml/phanpy-cz.git (push) +gitea ssh://git@git.arch-linux.cz:29418/Archos/phanpy-cz.git (fetch) +gitea ssh://git@git.arch-linux.cz:29418/Archos/phanpy-cz.git (push) +upstream git@github.com:cheeaun/phanpy.git (fetch) +upstream git@github.com:cheeaun/phanpy.git (push) +``` + +## 2. Synchronizace změn z upstream repozitáře: + +```bash +git remote add upstream https://github.com/cheeaun/phanpy.git (pokud jsem to neuděl dříve) +git fetch upstream +git checkout main +git merge upstream/main +``` + +## Vytvoření tagu + +Tagy se používají k označení konkrétních bodů v historii repozitáře, obvykle při vydání nové verze softwaru. + +1. Vytvoř tag lokálně: + +```bash +git tag -a v1.0 -m "První vydání" +``` + +- v1.0 je název tagu (můžeš ho změnit na libovolný název, který odpovídá verzi). +- -m "První vydání" je zpráva k tagu. + +Pushni tag na GitHub a Gitea: + +```bash +git push origin v1.0 +git push gitea v1.0 +``` +## Vytvoření release na GitHubu + +Po vytvoření tagu můžeme vytvořit release na GitHubu. + +1. Přejdi na stránku svého repozitáře na GitHubu. +2. Klikni na záložku "Releases". +3. Klikni na tlačítko "Draft a new release". +4. Vyplň formulář pro nový release: +- Tag version: Zvol vytvořený tag (v1.0). +- Release title: Např. "První vydání". +- Description: Popis vydání, co obsahuje, změny atd. +5. Klikni na tlačítko "Publish release". + +## Vytvoření release na Gitea + +Postup je podobný jako na GitHubu. + +1. Přejdi na stránku svého repozitáře na Gitea. +2. Klikni na záložku "Releases". +3. Klikni na tlačítko "New Release". +4. Vyplň formulář pro nový release: +- Tag version: Zvol vytvořený tag (v1.0). +- Release title: Např. "První vydání". +- Description: Popis vydání, co obsahuje, změny atd. +5. Klikni na tlačítko "Create Release". + +## Kroky k aktualizaci + +1. Stáhni nejnovější změny z upstream repozitáře: + +```bash +git fetch upstream +``` +2. Přepni se na hlavní větev (main): + +```bash +git checkout main +``` + +3. Slouč změny z upstream do své hlavní větve: +```bash +git merge upstream/main +``` + +4. Pushni změny do svého forku na GitHubu: + +```bash +git push origin main +``` +5. Pushni změny do svého repozitáře na Gitea: + +```bash +git push gitea main +``` +## Aktualizační skript + +```bash +#!/bin/bash + +# Fetch latest changes from upstream +git fetch upstream + +# Switch to main branch +git checkout main + +# Merge upstream changes into main +git merge upstream/main + +# Push changes to GitHub +git push origin main + +# Push changes to Gitea +git push gitea main +``` +Ulož tento skript jako update_repos.sh a udělej ho spustitelným: +```bash +chmod +x update_repos.sh +``` +Nyní můžeš spustit tento skript, kdykoli budeš chtít aktualizovat své repozitáře: +```bash +./update_repos.sh +``` \ No newline at end of file