You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Objava: Želite da pomognete razvoj ovog projekta? Ako ste zainteresovani posaljite mi poruku na Tviteru. Twitter i procitajte vodič vodič za održavaoca projekta.
Uvod
Ovo je tutorijal koji pomaže onima koji prvi put žele da učestvuju u jednostavnom i lakom projektu.
Ovo je namenjeno apsolutnim početnicima. Ukoliko znate kako da napišete tag <a href="" target=""></a> , trebalo bi da budete u mogućnosti da ovo odradite.
Ovo je namjenjeno i onima sa malo više iskustva, ali koji žele da daju svoj prvi doprinos projektu otvorenog koda, ili da dobiju više iskustva i samopouzdanja.
Zašto sam započeo ovaj projekat?
Svaki veb developer koji je ambiciozaN ili iskusan treba da koristi Git - kontrolu verzija, a GitHub je najpopularnija uluga Git hostinga koju koriste svi. Takođe je srce zajednice otvorenog koda. Dobro poznavanje GitHub-a je neophodna veština. Davanje doprinosa projektu povećava vaše samopouzdanje i daje vam nešto što možete da pokažete na svom GitHub profilu.
Ako ste novi u programiranju i pitate se da li treba da naučite Git i GitHub, evo odgovora: Trebali ste naučiti Git juče.
Šta ću ja da doprinesem?
Vi ćete doprineti projektu karticom kao što je ova stranica projekta. Uključiće vaše ime, vaš tviter profil i veze do korisnih resursa za veb programere koje preporučujete.
Napravićete kopiju šablona kartice unutar index.html fajla i prilagoditi je sopstvenim informacijama.
Alternativni ako Vam je prijatnije da koristite Git na komadnoj liniji možete i tako (ovdje su prvi-doprinosi, sličan projekat u kojem možete videti neophodne komande). ILI
Ako koristie VS Code dolazi sa integrisanim Gitom i omogućava Vam da uradite ono što nam je potrebno direktno iz editora.
Međutim najjednostavniji i najlakši način da pratite ovaj tutorijal je korišćenhe GitHub Desktop aplikacije.
Sada kada ste sve podesili, hajde da nastavimo sa poslom doprinosa projektu.
Doprinesi
Postanite saradnik otvorenog koda u 10 jednostavnih koraka.
Procenjeno vreme: Manje od 30 minuta.
Korak 1: Račvaj (fork) ovaj repozitorijum
Ovde je cilj da napravite kopiju ovog projekta i postavite je na svoj nalog.
Repozitorijum (repo) je način na koji se projekat naziva na GitHub-u, a fork je njegova kopija.
Izračvan projekat će imati simbol viljuške sa leve strane.
Vaše račvanje će imati vaše sopstveno GitHub korisničko ime.
Ovo će potrajati trenutak dok se projekat ne kopira na vaš hard disk. Preporučujem Vam da zadržite podrazumevanu putanju koja je obično ..\Documents\GitHub.
Sada imate lokalnu kopiju projekta.
Korak 3: Napravite novu granu
Kada se repo klonira i otvorite ga na GitHub radnoj površini, vreme je da napravite novu granu.
Grana je način da Vaše izmene držite odvojeno od glavnog dela projekta pod nazivom Master. Na primer, ako stvari krenu naopako i niste zadovoljni svojim izmenama, možete jednostavno da izbrišete granu i to neće uticati na glavni projekat.
Kliknite na Current branch
Potom kliknite na New
Dajte grani ime
Kliknite Create branch
Možete nazvati granu kako god želite, ali pošto je ovo grana za dodavanje kartice sa vašim imenom u projekat, nazvati je your-name-card je dobra praksa jer nameru ove grane održava jasnom.
Objavite Vašu granu na Github'u
Sada ste kreirali novu granu odvojenu od mastera.
Za sledeće korake proverite da li radite na ovoj grani. Videćete ime grane na kojoj se nalazite u gornjem centru GitHub desktop aplikacije gde piše Current branch.
NEMOJTE da radite na master grani
Korak 4: Otvori index.html fajl
Sada moramo da otvorimo datoteku koju ćemo urediti pomoću Vašeg omiljenog kod editora.
Pronađite folder projekta na računaru. Ako ste zadržali podrazumevano, ovo bi trebalo da bude nešto slično your-computer > Documents > GitHub > Contribute-To-This-Project
index.html fajl je direktno u Contribute-To-This-Project folderu.
Otvorite kod editor (Sublime, VS Code, Atom..etc) i otvorite fajl Open file komandom i locirajte index.html fajl u glavnom direktorijumu projekta.
Alternativno, možete locirati datoteku na hard disku, kliknuti desnim tasterom miša i otvoriti je pomoću uređivača
Sada imate otvorenu datoteku koju ćete uređivati u editoru i spremni ste da počnete da unosite izmene u nju.
Korak 5: Kopirajte šablon kartice
Napravićemo kopiju šablona kartice da bismo počeli da radimo na njemu
Na vrhu html fajla, ispod <head> i <header> sekcije naći ćete odeljak označen == TEMPLATE ==
Kopirajte sve unutar crvenog kvadrata na slici, iz Contributor card START komentara do Contributor card END komentara
Zalepite celu stvar direktno ispod komentara koji na to ukazuje
Uverite se da postoji jedna linija razmaka između početka i kraja poslednje kartice. Dobra je praksa da naš kod bude što jasniji
Nikada ne koristite lintere ili formatere stilova. Projekat ima lepšu postavku
Ovo je sada vaša kartica koju možete prilagoditi i urediti.
Korak 6: Primenite promene
Sada ćemo početi da uređujemo html, menjajući prilagodljiva polja na našoj kartici.
Yamenite 'Name' sa Vašim imenom
Poruka: Nemojte menjati class="name"
Unesite URL svog Tvitter naloga href="Insert URL here"
Unesite svoju oznaku u polje za tekst
Ako više volite da koristite kontakt koji nije Tviter, moraćete da zamenite tviter ikonicu<i class="fa fa-twitter"></i> tako što ćete da odete na Font Awesome Icons pronađete odgovarajucu ikonicu i zamenite samo fa-twitter deo sa novom ikonicom fa-facebook fna primer. Potom pratite iste korake iznad.
Recite nam nešto o sebi
Neka bude kratko i slatko. Razmislite o tome više kao na tvit nego na post na blogu
Podelite sa zajednicom 3 veze do resursa koji su korisni za razvoj veba
Ovo može biti bilo šta, video, razgovor, podkast, članak, referenca ili alat
Ako ste početnik, nemojte da Vas ovo plaši, podelite sve što znate čak i ako mislite da je osnovno. Iznenadićete se koliko će ljudi imati koristi
Link: Umetnite link href="here" zamenite #
Title: Napišite kratak opis title="here"
Name: Upišite naziv resursa u tekstualno polje >ovde</a>
Uverite se da ste sačuvali sve promene.
Testirajte svoje promene. OVO JE VAŽNO! Otvorite html datoteku u svom pretraživaču (na primer dvostrukim klikom na nju) i pogledajte kako će vaša kartica izgledati na sajtu. Uverite se da cela stranica i dalje izgleda isto i da ništa nije pokvareno. Kliknite na svoje veze i uverite se da rade. Otvorite konzolu (Ctrl + Shift + J (Windows / Linux) ili Cmd + Opt + J (Mac)) i proverite da nema poruka o grešci.
Odlično, završili ste sa uređivanjem koda! Sledeći koraci će poslati vaše izmene na GitHub, a zatim ih poslati da se spoje sa glavnim projektom.
Korak 7: Potvrdite svoje promene
Vratite se na GitHub desktop aplikaciju.
Vaše promene će biti automatski dodate u oblast za pripremu.
To znači da je Git zabeležio sve sačuvane promene.
To možete videti u aplikaciji. Sve što ste dodali u datoteku biće zeleno, a brisanja će biti prikazana crvenom bojom.
Sledeći korak se zove Commit
Ugrubo ovo znači "potvrdi promene"
Tako bi trebalo da izgleda zaglavlje vašeg GitHub desktopa
Obratite pažnju na simbol račvanja pored naziva projekta u Current repository
Vaša Current branch imaće ime koje ste mu dali u koraku 3
Da biste Commit morate popuniti Summary polje
Ovo je poruka potvrđivanja promene koja objašnjava šta ste promenili
U ovom slučaju "Add my card information" bi bila logična poruka
Opciono možete dodati i detaljniji opis Description
Kliknite Commit dugme. Vaše dugme će imati poruku Commit to "your-branch-name"
Korak 8: Pošalji svoje promene na GitHub
Vaše promene su sada sačuvane ili unete. Ali oni se čuvaju samo lokalno, to jest na vašem računaru.
Sinhronizacija lokalnih promena sa vašim repozitorijumom na Github-u se zove Push. Vi „gurate“ promene iz vašeg lokalnog repozitorijuma na repozitorijum na Github-u.
Kliknite Push dugme
Posle nekoliko sekundi operacija je završena i sada imate potpuno istu kopiju ove grane na vašoj mašini kao i na GitHub-u.
Korak 9: Pošalji izmene na reviziju (Pull Request)
Ovo je trenutak koji ste čekali; podnošenje Pull Request (PR).
Do sada je sav posao koji ste uradili bio na granici projekta, koji se, kako se sećate, nalazi na vašem nalogu GitHub-a.
Sada je vreme da svoje izmene pošaljete glavnom projektu da se spoje sa njim.
Ovo se zove Pull Request jer tražite od originalnog održavaoca projekta da "uvuče" vaše izmene u svoj projekat.
Idite na glavnu stranicu vašeg račvanja na GitHub'u (imaće ikonicu račvanja i vaše korisničko ime na vrhu).
Pri vrhu repo-a videćete istaknutu poruku zahteva za povlačenje sa zelenim dugmetom. (Pull request)
Kliknite na Compare and pull request
Ovako Open a pull request stranica izgleda.
SETITE SE vi pokušavate da spojite Vašu granu sa originalnim projektom, a ne sa Master granom na vašem račvanju.
Slika ispod daje vam ideju kako bi zaglavlje vašeg zahteva za povlačenje trebalo da izgleda
a levoj strani je originalni projekat, a zatim glavna grana. Na desnoj strani je vaše račvanje i grana koju ste kreirali.
Kreirajte pull request:
Napišite naslov
Dodajte opcionalne informacije i opis
Kliknite Create pull request
Nemojte da vas uznemiravaju sve opcije. Za sada treba da uradite samo ova tri koraka.
Ostavi opciju Allow edits from maintainers obeleženom.
Sada, Pull Request će biti poslat održavaocu projekta. Čim bude pregledan i prihvaćen, vaše promene će se pojaviti na veb stranici projekta.
Korak 10: Proslavite!!
To je to. Uspeli ste! Sada ste doprineli otvorenom kodu na GitHub-u.
Vaše promene neće biti vidljive odmah; prvo se moraju pregledati, prihvatiti i spojiti sa master granom što odobrava nosilac projekta. Kada se spoje, vaša kartica treba da bude vidljiva i aktivna na stranici.
Veoma je normalno da recenzent traži izmene u Pull Request-u. Smatrajte to dobrom praksom ako Vam se to dogodi. Pratite komentare i tražene izmene. Jednom kada izvršite tražene izmene (povratak u svoju granu) sve što treba da uradite je da izvršite i pogurate svoje promene. PR će se automatski ažurirati novim izmenama.
Obećavam da ću pokušati da pregledam i spojim što je pre moguće, ali ovo radim u slobodno vreme, tako da je kašnjenje od nekoliko dana neizbežno.
Sledeci koraci
Nakon nekog vremena proverite da li imate spojeni zahtev za povlačenje.
Trebalo bi da dobijete mejl u od GitHub-a kada vaše promene budu odobrene ili ako se zahtevaju dodatne promene. A kada se PR konačno spoji sa master granom, vaša kartica je dodata.
Ako smatrate da je ovaj projekat koristan, dajte mu ⭐ zvezda ⭐ na vrhu stranice i Tvitujte o njemu da biste pomogli u širenju reči
Ovo je projekat otvorenog koda, tako da osim doprinosa Vašoj kartici, dobrodošli ste da pomognete u ispravljanju grešaka, poboljšanjima ili novim funkcijama. Otvorite issue ili pošaljite novu pull zahtev pull request
Da biste poboljšali našu zajednicu, pogledajte Github Diskusije tab lociran pored Pull Requests. Ova oblast je mesto da se predstavite, uđete u dublje diskusije o otvorenom kodu i komunicirate sa održavaocima projekta. Hoćete li nam pomoći da izgradimo ovu funkciju i poboljšamo našu zajednicu? -Hvala što ste doprineli ovom projektu. Sada možete nastaviti i pokušati da doprinesete drugim projektima; potražite oznaku za opcije doprinosa prilagođene početnicima.
Takođe tražim saradnike da mi pomognu u pregledu i spajanju PR-a. Ako želite da dobijete napredniju Git praksu, pošaljite mi DM na Tvitter-u i pročitajte maintainer's guide.
Takođe je posebno inspirisano velikom zajednicom u okolini #GoogleUdacityScholars The Google Challenge Scholarship: Front-End Web Dev, class of 2017 Europe.
oznaku za opcije doprinosa prilagođene početnicima.