Skip to content

Latest commit

 

History

History
121 lines (75 loc) · 7.36 KB

README.sl.md

File metadata and controls

121 lines (75 loc) · 7.36 KB

Open Source Love License: MIT Open Source Helpers

Prvi prispevek

Vsak začetek je težak. Ko sodeluješ z drugimi, so napake še veliko bolj neprijetne. Zato smo se odločili, da novincem olajšamo prispevanje k odprti kodi (ang. Open source).

Branje člankov in sledenje vodičem lahko pomaga, vendar je še vedno najbolje da nove veščine vadimo sami v varnem okolju. Namen tega projekta je da novince vodi in jim olajša prvi prispevek k odprti kodi. Če želite narediti prvi prispevek, sledite spodnjim korakom.

Angleški izrazi so v oklepajih, da dodajo kontekst vsebini.

Če se ne počutite dobro v ukazni vrstici (ang. command line), so tukaj navodila za uporabo orodij z grafičnim vmesnikom.

fork this repository

Če na svojem računalniku še nimaš "git", si ga naloži.

Ustvari svojo različico repository-ja ( Fork this repository )

S pritiskom na gumb "Fork" na vrhu te strani, ustvari svojo različico repositorya ( pogosto skrajšano v "repo" ) v svojem GitHub računu.

Kloniraj ta repository ( Clone the repository )

clone this repository

Sedaj kloniraj ta repository na svoj računalnik. Pojdi v svoj GitHub račun in poišči svojo različico tega repositorya, klikni na gumb "Clone or download" in si kopiraj povezavo. Lahko uporabiš "Ctrl+C" ali pa klikni na ikono na desni strani povezave copy to clipboard.

Odpri terminal in se postavi v direktorij, v katerem želiš imeti svojo kopijo repositorya. Nato zaženi naslednji ukaz:

git clone "url naslov, ki si ga ravno skopiral"

"url naslov, ki si ga ravno skopiral" (brez navednic) je naslov, ki si ga skopiral na Githubu ( naslov tvoje različice projekta ). Glej prejšne korake da dobiš url naslov.

copy URL to clipboard

Primer:

git clone https://github.com/this-is-you/first-contributions.git

this-is-you je tvoje GitHub uporabniško ime. Ta ukaz skopira vsebino repositorya "first-contributions" z GitHuba v tvoj računalnik.

Ustvari vejo ( Create a branch )

Prestavi se v direktorij repositorya na svojem računalniku (če še nisi v njem):

cd first-contributions

Sedaj ustvari vejo z uporabo ukaza git checkout:

git checkout -b <add-your-new-branch-name>

Primer:

git checkout -b add-janez-novak

(Ni potrebno da je v imenu veje add, vendar je v tem primeru smiselno, ker je namen veje da dodaš svoje ime na seznam.)

Naredi spremembe in izvedi commmit teh sprememb ( Make necessary changes and commit those changes )

Odpri datoteko Contributors.md v urejevalniku besedila in dodaj svoje ime. Ne dodajaj ga na začetek ali konec datoteke, dodaj ga nekje vmes. Shrani datoteko.

git status

Če se postaviš v direktorij projekta in izvedeš ukaz git status, vidiš da obstajajo spremembe v projektu.

Dodaj te spremembe veji, ki si jo ravno ustvaril, z ukazom git add:

git add Contributors.md

Sedaj izvedi commit teh sprememb z ukazom git commit:

git commit -m "Add <your-name> to Contributors list"

Zamenjaj <your-name> s svojim imenom. Tekst med navednicami je komentar spremembe, ki se shrani s spremembo.

Pošlji spremembe na GitHub ( Push changes to GitHub )

Pošlji svoje spremembe z ukazom git push:

git push origin <add-your-branch-name>

Zamenjaj <add-your-branch-name> z imenom veje, ki si jo ustvaril.

Vloži svoje spremembe v pregled ( Submit your changes for review )

Če preveriš svoj repository na GitHubu, vidiš gumb Compare & pull request. Klikni na ta gumb.

create a pull request

Sedaj izvedi submit svojega pull requesta.

submit pull request

Kmalu bom združil tvoje spremembe v master vejo tega projekta. V svoj e-poštni nabiralnik boš dobil sporočilo, da so bile spremembe združene.

Kako nadaljevati? ( Where to go from here? )

Čestitke! Pravkar si končal običajni fork -> clone -> edit -> PR potek dela, ki ga boš srečal kot sodelavec v odprto kodnih projektih!

Lahko se pridružiš naši slack ekipi, če rabiš pomoč ali imaš vprašanja. Pridruži se slack ekipi.

Sedaj lahko začneš prispevati drugim projektom. Sestavili smo seznam projektov z enostavnimi problemi (issues), ki jih lahko začneš reševati. Preveri seznam projektov v spletni aplikaciji.

Vodiči za uporabo drugih orodij

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