Hacktoberfest je každoroční měsíční oslava open-source projektů, správců a přispěvatelů. Cílem akce je propagovat open source a povzbudit vývojáře, aby přispívali.
Hacktoberfest přichází s pobídkami pro prvních 40 000 účastníků, kteří do 31. října dostanou sloučené čtyři žádosti o stažení. Můžete si nechat zasadit strom na své jméno nebo tričko Hacktoberfest.
Vše začíná vaší první žádostí o vytažení/sloučení.
Registrace na Hacktoberfest
Chcete-li se zúčastnit Hacktoberfestu, musíte se nejprve zaregistrovat na akci hacktoberfest.com.
Zobrazí se obrazovka podobná této:
Abyste se mohli zúčastnit, musíte mít účet GitHub nebo GitLab.
Vyberte preferovanou hostingovou službu a klikněte na ZAHÁJIT knoflík. Kliknutím na toto tlačítko budete přesměrováni na vámi vybranou aplikaci, která vás požádá o schválení Hacktoberfestu.
Autorizace Hacktoberfest vás automaticky zaregistruje na akci.
Hledání projektů, do kterých můžete přispět na GitHubu a GitLabu
Pouze příspěvky do zúčastněných open source projektů na
GitHub nebo GitLab se bude počítat pro Hacktoberfest. Abyste se mohli zúčastnit, musíte mít účet GitHub nebo GitLab.GitHub
Jak najít projekty účastnící se Hacktoberfestu na GitHubu:
- Navigovat do github.com.
- Přejděte do vyhledávacího pole na GitHubu nebo stiskněte lomítko (/) na klávesnici.
- Zadejte „Hactoberfest“ a klikněte na ENTER knoflík.
Po výše uvedených krocích se zobrazí několik výsledků s tématem Hacktoberfest úplně nahoře. Toto téma vám poskytne seznam úložišť, do kterých můžete přispívat, jak je znázorněno na obrázku níže.
Případně můžete přejít přímo na GitHub Hacktoberfest téma.
GitLab
Jak najít projekty účastnící se Hacktoberfestu na GitLab:
- Navigovat do gitlab.com.
- Na domovské stránce vyberte prozkoumat veřejné projekty.
- Na stránce prozkoumat projekty vyberte prozkoumat témata.
- V filtrovat podle vyhledávání zadejte „Hactoberfest“.
Po výše uvedených krocích se zobrazí několik výsledků, přičemž téma Hacktoberfest je úplně první. Toto téma vám poskytne seznam úložišť, do kterých můžete přispívat, jak je znázorněno na obrázku níže.
Případně můžete přejít přímo na GitLab Hacktoberfest téma.
Vytvoření požadavku Pull (PR) na GitHubu
Požadavek na stažení (PR) je návrh vytvořený přispěvatelem do projektu, který žádá správce projektu, aby zkontroloval a sloučil navrhované změny do projektu.
Chcete-li vytvořit PR, musíte najít projekt Hacktoberfest, do kterého chcete přispět. Jakmile najdete projekt, klikněte na Vidlička tlačítko v pravém horním rohu:
Rozdělení projektu vytvoří kopii projektu ve vašem účtu GitHub, což vám umožní provádět změny, aniž by to ovlivnilo hlavní projekt. Po rozvětvení projektu naklonujte úložiště ze svého účtu a proveďte změny ve svém místním vývojovém prostředí.
Nezapomeňte si přečíst pokyny pro příspěvky k projektu a dodržovat je, abyste zvýšili šance na vaši žádost o stažení.
Po provedení změn a přidání vaší rozvětvené verze úložiště, provést změny pomocí Gita odeslat je na GitHub.
Když se změny projeví na GitHubu, zobrazí se výzva, která vás informuje, že vaše větev je „zavázána“ před hlavní větví, jak je znázorněno na obrázku níže.
Dále klikněte na přispět tlačítko na výzvě. Kliknutím na toto tlačítko budete vyzváni k otevření požadavku na stažení, jak je znázorněno na obrázku níže.
Poté klikněte na otevřený požadavek na vytažení knoflík. Tím se dostanete na stránku, kde si projdete pokyny pro příspěvky a název a popis vaší žádosti o stažení.
Vyplňte požadovaná pole a klikněte na Vytvořit požadavek na stažení tlačítko, jak je znázorněno na obrázku níže.
Vytvořili jste žádost o stažení. Nyní počkejte, až správci projektu zkontrolují a sloučí nebo odmítnou váš příspěvek.
Vytvoření žádosti o sloučení na GitLab
Požadavek na sloučení je totožný s požadavkem na stažení. Jediným rozdílem jsou jejich příslušná jména.
Chcete-li podat žádost o sloučení, musíte nejprve najít projekt Hacktoberfest, do kterého chcete přispět. Jakmile najdete projekt, klikněte na tlačítko rozvětvení v pravém horním rohu:
Rozdělení projektu vytvoří kopii projektu ve vašem účtu GitLab, což vám umožní provádět změny, aniž by to ovlivnilo hlavní projekt. Po rozvětvení projektu naklonujte úložiště ze svého účtu a proveďte změny ve svém místním vývojovém prostředí.
Nezapomeňte si přečíst pokyny pro příspěvky k projektu a dodržovat je, abyste zvýšili šance na vaši žádost o stažení.
Po provedení změn a přidání vaší rozvětvené verze úložiště potvrďte změny a poslat je do GitLabu.
Po odeslání změn do GitLabu přejděte do svého rozvětveného projektu a klikněte Sloučit žádosti v postranním panelu. Zobrazí se obrazovka vysvětlující požadavek na sloučení a a Nový požadavek na sloučení knoflík. Klikněte na Nový požadavek na sloučení tlačítko, jak je znázorněno na obrázku níže.
Dále budete muset vybrat a zdroj a cílová větev. The zdroj větev by měla být větev, kde jsou umístěny změny, které chcete zanést do hlavního úložiště. The cílová větev by měla být hlavním úložištěm, kam chcete uložit své změny. Po výběru větví klikněte na Porovnejte větve a pokračujte tlačítko, jak je znázorněno na obrázku níže.
Kliknutím na Porovnejte větve a pokračujte se dostanete na stránku, kde můžete zadat název a popis pro vaši žádost o sloučení.
Vyplňte požadované údaje a klikněte na tlačítko vytvořit žádost o sloučení, jak je znázorněno na obrázku níže.
Kliknutím na toto tlačítko vytvoříte žádost o sloučení. Nyní musíte počkat, až správci projektu zkontrolují a sloučí nebo zavře váš požadavek na stažení.
Podmínky Hacktoberfestu
Všechny příspěvky do projektů Hacktoberfest musí být v rámci Hacktoberfestu a nesmí být spamové. Nedodržení pravidel Hacktoberfestu může vést k diskvalifikaci z akce.
Hacktoberfest vydává sedmidenní období kontroly pro žádosti o stažení/sloučení, které dodržují všechny pokyny. Pokud je vaše PR dobré, projekt by ho měl v tomto časovém rámci přijmout na Hacktoberfest.
Šťastné přispívání!
