Skip to content

Latest commit

 

History

History
280 lines (165 loc) · 27.3 KB

File metadata and controls

280 lines (165 loc) · 27.3 KB

Tweet

Discord

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.

Ovaj tutorijal je takođe dostupan drugi jezici (Engleski, Portugalski, Spanski, and Italijanski trenutno. Prevodi su veoma dobrodošli.).

Ciljevi

  • Dajte doprinos projektu otvorenog koda.
  • Učite GitHub.

Za koga je ovo namenjeno?

  • 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?

Kartica saradnika

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.

Index brzog pristupa

Doprinesi:

Podešavanje! :)

Prvo hajde sve da podesimo za posao!

  1. Ulogujte se na svoj GitHub nalog. Ako još uvek nemate nalog pridruži se GitHub'u. Preporučujem da pogledate GitHub Hello World tutorial pre nego što nastavite.
  2. Skinite GitHub Desktop aplikaciju.
    • 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.
  • Uverite se da ste na glavnoj stranici of this repo.
  • Kliknite na Fork dugme
Fork
  • Sada imate kompletnu kopiju projekta na svom nalogu.

Korak 2: Kloniraj repozitorijum

  • Sada želimo da napravimo lokalnu kopiju projekta. To je kopija sačuvana na Vašoj mašini.
  • Otvorite GitHub desktop aplikaciju. U aplikaciji :
  • Klikni na File potom Clone repository
Clone
  • Videćete listu svojih projekata i forkova na GitHub-u.
  • Izaberite <vaše-github-username>/Contribute-To-This-Project.
  • Klikni Clone
Kloniraj projekat
  • Izračvan projekat će imati simbol viljuške sa leve strane.
  • Vaše račvanje će imati vaše sopstveno GitHub korisničko ime.
vaše račvanje
  • 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
Create branch
  • Dajte grani ime
  • Kliknite Create branch
Naziv grane
  • 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
Ime grane
  • 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
Otvori index fajl
  • 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
Kopirajte šablon kartice
  • 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
Nalepite šablon kartice
  • 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"
Promeni ime
  • Unesite URL svog Tvitter naloga href="Insert URL here"
  • Unesite svoju oznaku u polje za tekst
Promeni kontakt
  • 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
Promeni o sebi
  • 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
izmeni resurse
  • 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"
Komituj 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
Komituj promene
  • 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"
Napiši poruku komitovanja i komituj

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
Pušuj na GitHub
  • 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
Submit a 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.
Open a Pull Request
  • Kreirajte pull request:
  • Napišite naslov
  • Dodajte opcionalne informacije i opis
  • Kliknite Create pull request
Submit a 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.

Dodali ste kod na živu veb stranicu: https://syknapse.github.io/Contribute-To-This-Project

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 Tweet
  • Možete me pratiti i ostati u kontaktu na Twitter or using any of these other options
  • 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 Good First Issue 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.

Priznanja

Na ovaj projekat veliki uticaj je imao Roshan Jossey's odlični first-contributions projekat sa sjajnim tutorijalom.

Takođe je posebno inspirisano velikom zajednicom u okolini #GoogleUdacityScholars The Google Challenge Scholarship: Front-End Web Dev, class of 2017 Europe.

Licenca

MIT License

Vrati se na početak ↑