Skip to content

Latest commit

 

History

History
127 lines (73 loc) · 7.72 KB

README.cs.md

File metadata and controls

127 lines (73 loc) · 7.72 KB

Open Source Love License: MIT Open Source Helpers

První příspěvek

Život je těžký. Obzvláště když něco děláte poprvé. V případě, že na něčem spolupracujete, není dělání chyb něco, co by vám dělalo radost. My bychom rádi zjednodušili cestu novým přispěvovatelům do open-source při jejich učení se jak na to.

Čtení článků nebo zhlédnutí video návodů jsou také cesty, ale co je lepší než si danou věc přímo osahat na vlastní kůži v reálném prostředí? Tento projekt je zaměřen na poskytnutí pomoci začátečníkům s jejich prvním přispěním do open-source. Pokud jste jím právě vy, následujte kroky popsané níže.

forkněte tento repozitář

Pokud namáte nainstalovaný git, nainstalujte si jej.

Forkněte tento repozitář

Forkněte (vytvoření kopie z originálu, z anglického forkvidlička, jako vytvoření nové odnože) tento repozitář kliknutím na tlačítko Fork nahoře na této stránce. Tím vytvoříte kopii tohoto repozitáře na svém vlastním GitHub účtu.

Naklonujte repozitář

naklonujte tento repozitář

Nyní naklonujte (anglicky clone) forknutý repozitář na váš počítač, naklonování není nic jiného než stáhnutí obrazu repozitáře k vám na počítač. Na vašem GitHub účtu si otevřete forknutý repozitář, klikněte na tlačítko Clone or download a následně v okýnku, které se objeví, klikněte na tlačítko s ikonkou copy to clipboard vedle URL adresy, čímž si ji zkopírujete do schránky.

Teď otevřete terminál a spusťte následující příkaz:

git clone "url které jste právě zkopírovali"

zkopírujte adresu do schránky

Například:

git clone https://github.com/vase-username/first-contributions.git

Tímto na svém počítači vytvoříte složku se soubory daného repozitáře.

Vytvořte větev

V příkazové řádce se přepněte do složky s repozitářem (pokud v ní už nejste)

cd first-contributions

Nyní vytvořte novou větev (anglicky branch) za použití příkazu git checkout:

git checkout -b <jmeno-nove-vetve>

Například:

git checkout -b pridani-meho-jmena

Jméno větve by mělo vypovídat o tom, co kód nebo cokoliv jiného do ní přidané bude dělat/vykonávat, případně proč se daná věc děje.

Udělejte změny a zaznamenejte je

Otevřete soubor Contributors.md v textovém editoru a přidejte do něj své jméno. Napiště jej někam doprostřed a soubor uložte.

git status

Pokud teď v příkazové řádce spustíte příkaz git status, uvidíte jaké změny byly v repozitáři provedeny.

Tyto změny do dané větvě přidáte příkazem git add:

git add Contributors.md

Zbývá už jen potvrdit (anglicky commit) změny příkazem git commit:

git commit -m "Add <vase-jmeno> to Contributors list"

Za přepínač -m se píše co dané změny představují, popis by měl být jednoduchý ale výstižný.

Protlačte změny na GitHub

Nyní změny provedené lokálně na počítači protlačíme (anglicky push) na GitHub příkazem git push:

git push origin <jmeno-vasi-vetve>

Předložte své změny k posouzení

Pokud se nyní podíváte do svého GitHub repozitáře, uvidíte tlačítko Compare & pull request. Klikněte na něj.

vytvořte pull request

Teď vytvořte žádost o přetažení vaší větve do originálního repozitáře (anglicky pull request).

potvrďte pull request

Brzy budou správci provádět zapracování vašich změn do hlavní (anglicky master) větve tohoto projektu. Až se do ní vaše změny dostanou, dostanete e-mailové upozornění.

Kam dále?

Blahopřejeme! Právě jste dokončili standardní fork -> clone -> edit -> průběh práce (anglicky workflow), se kterým se jako přispěvatel do projektů setkáte dennodenně.

Oslavte svůj první příspěvek se svými přáteli a následovníky přes webovou aplikaci.

V případě, že byste měli jakékoliv otázky nebo potřebovali pomoct, můžete se přidat k našemu Slack teamu.

Nyní vám už nic nebrání v příspívání do ostatních projektů. Připravili jsme pro vás seznam projektů, které mají jednoduché záležitosti k vyřešení/naprogramování, se kterými můžete začít. Podívejte se zde.

Návod za použití dalších nástrojů

GitHub Desktop Visual Studio 2017 GitKraken VS Code Sourcetree App IntelliJ IDEA
GitHub Desktop Visual Studio 2017 GitKraken Visual Studio Code Atlassian Sourcetree IntelliJ IDEA