Uvodni “GitHub” repozitorijum – kako napraviti profil “README”

Profil "README" je odličan način da pokažeš svoje veštine i znanje.

“GitHub” danas nije samo mesto gde čuvaš kod, već i platforma na kojoj možeš da predstaviš sebe kao developera. Upravo zato je uvodni “GitHub” repozitorijum – kako napraviti profil “README” zanimljiva tema za svakog programera početnika.

GitHub profil README
GitHub profil README

Ovaj poseban repozitorijum omogućava da na svom “GitHub” profilu napišeš nešto o sebi, da navedeš tehnologije koje koristiš, predstaviš projekte na kojima radiš i da dodaš načine na koje drugi mogu da stupe u kontakt sa tobom. Kada ga pravilno postaviš, tvoj “GitHub” profil dobija mali uvod koji posetiocima odmah govori ko si i čime se baviš.

Šta je profil README?

Već sam pisala o tome šta je “GitHub”, tako da ću se ovaj put osvrnuti samo na to šta je profil “README”?

Profil “README” je poseban “GitHub” repozitorijum koji ima isto ime kao tvoj “GitHub” nalog. Kada napraviš takav repozitorijum i u njega dodaš “README.md” fajl, sadržaj tog fajla će automatski biti prikazan na vrhu tvog “GitHub” profila, odnosno biće prvo što drugi vide kada posete tvoj profil.

Kako napraviti profil “README”?

Nekome ko se prvi put susreće sa “GitHub”-om možda ne deluje tako, ali pravljenje profil “README” fajla je vrlo jednostavno i zanimljivo.

Pre nego što napraviš uvodni repozitorijum, važno je da znaš da ovaj repozitorijum mora imati identično ime kao tvoj “GitHub” nalog. Ukoliko ime repozitorijuma nije potpuno isto kao ime korisničkog naloga, “GitHub” ga neće prikazati kao profil “README”.

Kreiranje repozitorijuma

Pretpostavljam da ovo nije prvi repozitorijum koji praviš, tako da ti je postupak već poznat, ali ću ga ipak, za svaki slučaj, ponoviti:

  1. Idi na github.com i klikni na “Sign In” (uloguj se) dugme u gornjem desnom uglu.
  2. Uloguj se na svoj nalog.
  3. Klikni na dugme “New” (nov) sa leve strane.
  4. Nakon što se otvori forma za kreiranje novog repozitorijuma, počni sa popunjavanjem.
  5. U polje “Repository name” (ime repozitorijuma) unesi svoje korisničko ime. Nakon što ovo uradiš, videćeš i obaveštenje kako je u pitanju specijalan repozitorijum i da će ovaj “README” fajl biti prikazan na tvom profilu.
  6. U polje “Description” (opis) možeš, a i ne moraš da dodaš kratak opis (do 350 karaktera).
  7. Proveri da li je vidljivost repozitorijuma podešena na “Public” (javan).
  8. Kod “Add README” (dodaj “README”) prebaci prekidač na ON.
  9. Klikni na dugme “Create repository” (kreiraj repozitorijum).
Specijalan README.md fajl
Specijalan README.md fajl

Videćeš da je kreiran repozitorijum sa praznim “README” fajlom koji sada možeš da urediš klikom na olovku u gornjem desnom uglu.

Uređivanje “README.md” fajla

“README” koristi “markdown” – jednostavan jezik za stilizovanje i formatiranje običnog teksta. U nastavku su neki od najčešće korišćenih “markdown” elemenata koji se često koriste u “README” fajlovima.

Najčešće korišćeni
Najčešće korišćeni "markdown" elementi

A ovde možeš videti i kako to kasnije izgleda na tvom “GitHub” profilu:

Prikaz
Prikaz "markdown" elemenata

Dodavanje vizuelnih elemenata

Osim običnog teksta, u “README” fajl možeš da dodaš i neke vizuelne elemente.

Pored linkova i slika, možeš da dodaš i “GitHub” statistiku. “GitHub” statistika su slike (kartice) koje prikazuju tvoju aktivnost, kao što su broj “commit”-ova, najčešće korišćeni jezici i slično. Najčešće se koriste gotovi servisi koji generišu te slike. Najpopularniji je “GitHub Readme Stats”.

Ovde možeš videti neke primere koje možeš da iskoristiš – sve što je potrebno je da umesto “ivanastamenkovic” uneseš korisničko ime svog “GitHub” naloga.

"GitHub" statistika
"GitHub" statistika
A evo i kako to izgleda na profilu:
Prikaz statistike na
Prikaz statistike na "GitHub" profilu

Zašto je profil “README” koristan?

Postoji nekoliko razloga zašto je dobro imati ovakav repozitorijum:

  • ostavlja profesionalan prvi utisak
  • pomaže drugima da razumeju čime se baviš
  • može poslužiti kao mini portfolio
  • čini tvoj “GitHub” profil zanimljivijim

Mnogi regruteri i developeri često prvo pogledaju upravo ovaj deo profila. Uz malo truda i kreativnosti, profil “README” može postati odličan način da pokažeš svoje veštine, projekte i interesovanja u svetu programiranja.

Podelite post:

Ivana

Ivana

Lice iza bloga i svih tekstova na njemu.
Frilenser sa 8+ godina iskustva.
Student softverskih i informacionih tehnologija na FTN NS.

Leave a Reply

Your email address will not be published. Required fields are marked *

Uvodni "GitHub" repozitorijum - kako napraviti profil "README"?

Sadržaj:

Najnoviji postovi na blogu: