Je to ťažké. Je to vždy ťažké, keď niečo robíš prvýkrát. Najmä vtedy, keď spolupracuješ, robiť chyby nie je pohodlná vec. Chceli sme zjednodušiť spôsob, akým sa noví prispievatelia do open source učia a prispievajú prvýkrát.
Čítanie článkov a sledovanie tutoriálov môže pomôcť, ale čo je lepšie, ako skutočne robiť veci v skúšobnom prostredí? Cieľom tohto projektu je poskytnúť usmernenie a zjednodušiť spôsob, akým prvýkrát prispievajú začiatočníci. Ak máš záujem o prvý príspevok, postupuj podľa nižšie uvedených krokov.
Ak sa ti nedarí s príkazovým riadkom, tu sú návody s nástrojmi grafického rozhrania.
Prečítaj si to v ostatných jazykoch.
️🇬🇧 🇮🇳 🇲🇲 🇮🇩 🇫🇷 🇪🇸 🇳🇱 🇱🇹 🇷🇺 🇯🇵 🇻🇳 🇵🇱 🇮🇷 🇮🇷 🇰🇷 🇰🇵 🇩🇪 🇨🇳 🇹🇼 🇬🇷 🇪🇬 🇸🇦 🇺🇦 🇧🇷 🇵🇹 🇮🇹 🇹🇭 🏴 🇵🇰 🇧🇩 🇲🇩 🇷🇴 🇹🇷 🇸🇪 🇸🇮 🇮🇱 🇨🇿 🇲🇽
Ak nemáš na svojom počítači git, nainštaluj ho.
Skopíruj toto úložisko kliknutím na tlačidlo vidlice(fork) v hornej časti tejto stránky. Tým sa vytvorí kópia tohto úložiska na tvojom účte.
Teraz stiahni toto úložisko do tvojho zariadenia. Prejdi do tvojho účtu GitHub, otvor skopírované úložisko, klikni na tlačidlo klonovania a potom klikni na ikonu * kopírovať do schránky *.
Otvor terminál a spusti nasledujúci git príkaz:
git clone "adresa, ktorú si práve skopíroval"
kde "adresa ktorú si práve skopíroval" (bez úvodzoviek) je adresa URL tohto úložiska (tvoja kópia tohto projektu). Pozri si predchádzajúce kroky na získanie adresy URL.
Napríklad:
git clone https://github.com/toto-si-ty/prve-prispevky.git
kde toto-si-ty
je tvoje GitHub užívateľské meno. Tu skopíruješ obsah GitHub úložiska prve-prispevky do tvojho počítača.
Prejdi do adresára úložiska v tvojom počítači (ak ešte nie si tam):
cd prve-prispevky
Teraz vytvor vetvu pomocou príkazu git checkout
:
git checkout -b <pridaj-meno-tvojej-novej-vetvy>
Napríklad:
git checkout -b pridaj-ferko-mrkvicka
(Názov pobočky nemusí obsahovať slovo * pridaj *, ale je rozumné pridať ho, pretože účelom tejto pobočky je pridať tvoje meno do zoznamu.)
Teraz otvor súbor Contributors.md
v textovom editore a pridaj do neho svoje meno. Nepridávaj ho na začiatok alebo na koniec súboru. Daj ho kdekoľvek medzi tým. Teraz súbor ulož.
Ak prejdeš do adresára projektu a vykonáš príkaz git status
, uvidíš zmeny.
Pridaj tieto zmeny do vetvy, ktorú si práve vytvoril, pomocou príkazu git add
:
git add Contributors.md
Teraz vykonaj tieto zmeny pomocou príkazu git commit
:
git commit -m "Pridaj <tvoje-meno> do zoznamu pripievateľov"
nahraď <tvoje-meno>
tvojim menon.
Nahraj svoje zmeny pomocou príkazu git push
:
git push origin <pridaj-meno-tvojej-novej-vetvy>
nahraď <pridaj-meno-tvojej-novej-vetvy>
názvom vetvy, ktorú si vytvoril skôr.
Ak prejdeš do tvojho úložiska v službe GitHub, zobrazí sa tlačidlo Compare & pull request
. Klikni na toto tlačidlo.
Teraz predlož požiadavku na vytiahnutie.
Čoskoro budem zlučovat všetky vaše zmeny do hlavnej pobočky tohto projektu. Po zlúčení zmien dostaneš upozornenie.
Gratulujem! Práve si dokončil štandardný fork -> klon -> upraviť -> PR pracovný postup, ktorý sa často stretneš ako prispievateľ!
Osláv svoj príspevok a zdieľaj ho so svojimi priateľmi a nasledníkmi web app.
Môžeš sa pripojiť k nášmu slack tímu v prípade, že potrebuješ nejakú pomoc alebo máš nejaké otázky. Join slack team.
Teraz začni s účasťou na iných projektoch. Vytvorili sme zoznam projektov s jednoduchými problémami, s ktorými môžeš začať. Pozri zoznam projektov vo webovej aplikácii.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code |
Ak sa ti tento projekt páči, daj mu hviezdu GitHub. Ak sa cítiš obzvlášť dobročinne, nasleduj Roshan na Twitter a GitHub.