27 KiB

Raw Permalink Blame History Unescape Escape

Увод у GitHub

Ова лекција покрива основе GitHub-а, платформе за хостовање и управљање изменама вашег кода.

Скетч од Tomomi Imura

Квиз пре предавања

Увод

У овој лекцији ћемо обрадити:

праћење рада који обављате на вашем рачунару
рад на пројектима са другима
како допринети софтверу отвореног кода

Предуслови

Пре него што почнете, потребно је да проверите да ли је Git инсталиран. У терминалу укуцајте:
git --version

Ако Git није инсталиран, преузмите Git. Затим подесите ваш локални Git профил у терминалу:

git config --global user.name "ваше-име"
git config --global user.email "ваш-имејл"

Да бисте проверили да ли је Git већ конфигурисан, можете укуцати: git config --list

Такође ће вам бити потребан GitHub налог, уређивач кода (као што је Visual Studio Code), и потребно је да отворите ваш терминал (или командну линију).

Посетите github.com и направите налог ако га већ немате, или се пријавите и попуните ваш профил.

✅ GitHub није једини репозиторијум кода на свету; постоје и други, али GitHub је најпознатији.

Припрема

Потребан вам је фолдер са код пројектом на вашем локалном рачунару (лаптопу или десктопу) и јавни репозиторијум на GitHub-у, који ће служити као пример како допринети пројектима других.

Управљање кодом

Рецимо да имате локални фолдер са неким код пројектом и желите да почнете да пратите ваш напредак користећи git - систем за контролу верзија. Неки људи пореде коришћење git-а са писањем љубавног писма себи у будућности. Читајући поруке ваших commit-ова данима, недељама или месецима касније, моћи ћете да се сетите зашто сте донели одређену одлуку или да "вратите" промену - то јест, ако пишете добре поруке commit-ова.

Задатак: Направите репозиторијум и commit-ујте код

Погледајте видео

Направите репозиторијум на GitHub-у. На GitHub.com, у картици репозиторијума или из навигационе траке у горњем десном углу, пронађите дугме new repo.
1. Дајте вашем репозиторијуму (фолдеру) име.
2. Изаберите create repository.
Навигирајте до вашег радног фолдера. У вашем терминалу, пребаците се у фолдер (такође познат као директоријум) који желите да почнете да пратите. Укуцајте:
```
cd [name of your folder]
```
Иницијализујте git репозиторијум. У вашем пројекту укуцајте:
```
git init
```
Проверите статус. Да бисте проверили статус вашег репозиторијума, укуцајте:
```
git status
```
излаз може изгледати овако:
```
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)

     modified:   file.txt
     modified:   file2.txt
```
Обично команда git status вам говори ствари као што су који фајлови су спремни да буду сачувани у репозиторијуму или имају измене које можда желите да задржите.
Додајте све фајлове за праћење
Ово се такође назива постављање фајлова/додавање фајлова у staging area.
```
git add .
```
Аргумент git add са . означава да су сви ваши фајлови и измене спремни за праћење.
Додајте одабране фајлове за праћење
```
git add [file or folder name]
```
Ово нам помаже да додамо само одабране фајлове у staging area када не желимо да commit-ујемо све фајлове одједном.
Уклони све фајлове из staging area
```
git reset
```
Ова команда нам помаже да уклонимо све фајлове из staging area одједном.
Уклони одређени фајл из staging area
```
git reset [file or folder name]
```
Ова команда нам помаже да уклонимо само одређени фајл из staging area који не желимо да укључимо у следећи commit.
Сачувајте ваш рад. У овом тренутку сте додали фајлове у такозвани staging area. Место где Git прати ваше фајлове. Да бисте направили промену трајном, потребно је да commit-ујете фајлове. Да бисте то урадили, направите commit командом git commit. Commit представља тачку чувања у историји вашег репозиторијума. Укуцајте следеће да направите commit:
```
git commit -m "first commit"
```
Ово commit-ује све ваше фајлове, додајући поруку "first commit". За будуће поруке commit-ова, желећете да будете описнији у вашем опису како бисте пренели какву сте промену направили.
Повежите ваш локални Git репозиторијум са GitHub-ом. Git репозиторијум је добар на вашем рачунару, али у неком тренутку желите да имате резервну копију ваших фајлова негде и такође позовете друге људе да раде са вама на вашем репозиторијуму. Једно такво одлично место је GitHub. Запамтите да смо већ направили репозиторијум на GitHub-у, тако да је једино што треба да урадимо да повежемо наш локални Git репозиторијум са GitHub-ом. Команда git remote add ће то урадити. Укуцајте следећу команду:

Напомена, пре него што укуцате команду, идите на страницу вашег GitHub репозиторијума да пронађете URL репозиторијума. Користићете га у команди испод. Замените https://github.com/username/repository_name.git вашим GitHub URL-ом.
```
git remote add origin https://github.com/username/repository_name.git
```
Ово креира remote, или везу, названу "origin" која показује на GitHub репозиторијум који сте раније направили.
Пошаљите локалне фајлове на GitHub. До сада сте направили везу између локалног репозиторијума и GitHub репозиторијума. Хајде да пошаљемо ове фајлове на GitHub следећом командом git push, овако:

Напомена, име ваше гране може бити другачије од main.
```
git push -u origin main
```
Ово шаље ваше commit-ове у вашу "main" грану на GitHub.
Додајте још измена. Ако желите да наставите са прављењем измена и њиховим слањем на GitHub, само ћете морати да користите следеће три команде:
```
git add .
git commit -m "type your commit message here"
git push
```
Савет, Можда ћете желети да усвојите .gitignore фајл како бисте спречили да фајлови које не желите да пратите буду приказани на GitHub-у - као што је тај фајл са белешкама који чувате у истом фолдеру, али нема место у јавном репозиторијуму. Можете пронаћи шаблоне за .gitignore фајлове на .gitignore templates.

Поруке commit-ова

Одлична порука у Git commit-у завршава следећу реченицу:
Ако се примени, овај commit ће <ваша порука овде>

За наслов користите императив, садашње време: "промени" уместо "променио" или "мења".
Као и у наслову, у телу (опционо) такође користите императив, садашње време. Тело треба да укључи мотивацију за промену и да је упореди са претходним понашањем. Објашњавате зашто, а не како.

✅ Одвојите неколико минута да прегледате GitHub. Можете ли пронаћи заиста одличну поруку commit-а? Можете ли пронаћи заиста минималну? Које информације мислите да су најважније и најкорисније за преношење у поруци commit-а?

Задатак: Сарадња

Главни разлог за постављање ствари на GitHub је да се омогући сарадња са другим програмерима.

Рад на пројектима са другима

Погледајте видео

У вашем репозиторијуму, идите на Insights > Community да видите како ваш пројекат стоји у поређењу са препорученим стандардима за заједницу.

Ево неких ствари које могу побољшати ваш GitHub репозиторијум:

Опис. Да ли сте додали опис за ваш пројекат?
README. Да ли сте додали README? GitHub пружа смернице за писање README.
Смернице за допринос. Да ли ваш пројекат има смернице за допринос?
Кодекс понашања. Да ли ваш пројекат има кодекс понашања?
Лиценца. Можда најважније, да ли ваш пројекат има лиценцу?

Сви ови ресурси ће помоћи у укључивању нових чланова тима. То су обично ствари које нови сарадници гледају пре него што уопште погледају ваш код, како би утврдили да ли је ваш пројекат право место за њих да проведу своје време.

✅ README фајлови, иако захтевају време за припрему, често се занемарују од стране заузетих одржавалаца. Можете ли пронаћи пример посебно описног README-а? Напомена: постоје неки алати за креирање добрих README-а које бисте могли да испробате.

Задатак: Спојите код

Документација о доприносу помаже људима да допринесу пројекту. Она објашњава које врсте доприноса тражите и како процес функционише. Сарадници ће морати да прођу кроз низ корака да би могли да допринесу вашем репозиторијуму на GitHub-у:

Fork-овање вашег репозиторијума. Вероватно ћете желети да људи fork-ују ваш пројекат. Fork-овање значи креирање реплике вашег репозиторијума на њиховом GitHub профилу.
Clone. Након тога ће clone-овати пројекат на свој локални рачунар.
Креирање гране. Желите да их замолите да креирају грану за свој рад.
Фокусирање измена на једну област. Замолите сараднике да концентришу своје доприносе на једну ствар у исто време - на тај начин су веће шансе да можете спојити њихов рад. Замислите да напишу исправку грешке, додају нову функцију и ажурирају неколико тестова - шта ако желите, или можете да имплементирате само 2 од 3, или 1 од 3 измене?

✅ Замислите ситуацију где су гране посебно критичне за писање и испоруку доброг кода. Које случајеве употребе можете да замислите?

Напомена, будите промена коју желите да видите у свету и креирајте гране за свој рад. Сви commit-ови које направите биће направљени на грани на којој сте тренутно "checked out". Користите git status да видите на којој грани се налазите.

Хајде да прођемо кроз процес сарадника. Претпоставимо да је сарадник већ fork-овао и clone-овао репозиторијум, тако да има Git репозиторијум спреман за рад на свом локалном рачунару:

Креирање гране. Користите команду git branch да креирате грану која ће садржати измене које намеравају да допринесу:
```
git branch [branch-name]
```
Пребацивање на радну грану. Пребаците се на одређену грану и ажурирајте радни директоријум командом git switch:
```
git switch [branch-name]
```
Радите на изменама. У овом тренутку желите да додате своје измене. Не заборавите да кажете Git-у о томе следећим командама:
```
git add .
git commit -m "my changes"
```
Уверите се да сте дали вашем commit-у добро име, за ваше добро као и за одржаваоца репозиторијума на којем помажете.
Комбинујте ваш рад са main граном. У неком тренутку сте завршили рад и желите да комбинујете ваш рад са радом main гране. Main грана је можда промењена у међувремену, па се уверите да сте је прво ажурирали на најновију верзију следећим командама:
```
git switch main
git pull
```
У овом тренутку желите да се уверите да се сви конфликти, ситуације где Git не може лако да комбинује измене, дешавају у вашој радној грани. Зато покрените следеће команде:
```
git switch [branch_name]
git merge main
```
Ово ће донети све измене из main гране у вашу грану и надамо се да можете само наставити. Ако не, VS Code ће вам показати где је Git збуњен и само измените погођене фајлове да кажете који садржај је најтачнији.
Пошаљите ваш рад на GitHub. Слање вашег рада на GitHub значи две ствари. Пушовање ваше гране на ваш репозиторијум и затим отварање PR-а (Pull Request).
```
git push --set-upstream origin [branch-name]
```
Горња команда креира грану на вашем fork-ованом репозиторијуму.
Отворите PR. Затим, желите да отворите PR. То радите тако што навигирајте до fork-ованог репозиторијума на GitHub-у. Видећете индикацију на GitHub-у где вас пита да ли желите да креирате нови PR, кликнете на то и бићете одведени на интерфејс где можете променити наслов поруке commit Увери се да одеђеш на GitHub страницу за форковани репо и уклониш удаљену грану коју си управо послао.

Pull request изгледа као смешан термин јер заправо желиш да "погураш" своје измене у пројекат. Али одржавалац (власник пројекта) или главни тим треба да размотри твоје измене пре него што их споји са "главном" граном пројекта, тако да заправо тражиш одлуку о изменама од одржаваоца.

Pull request је место где се упоређују и дискутују разлике уведене на грани уз рецензије, коментаре, интегрисане тестове и још много тога. Добар pull request прати отприлике исте смернице као и порука комита. Можеш додати референцу на проблем у тракеру проблема, на пример када твој рад решава одређени проблем. Ово се ради коришћењем # праћеног бројем твог проблема. На пример #97.

🤞Држимо палчеве да сви провери прођу и да власник(ци) пројекта споје твоје измене у пројекат🤞

Ажурирај своју тренутну локалну радну грану са свим новим комитима из одговарајуће удаљене гране на GitHub-у:

git pull

Како допринети отвореном коду

Прво, хајде да пронађемо репозиторијум (или репо) на GitHub-у који те интересује и коме би желео да допринесеш изменом. Желиш да копираш његов садржај на свој рачунар.

✅ Добар начин да пронађеш репозиторијуме погодне за почетнике је претрага по ознаци 'good-first-issue'.

Постоји неколико начина за копирање кода. Један од начина је да "клонираш" садржај репозиторијума, користећи HTTPS, SSH или GitHub CLI (Command Line Interface).

Отвори свој терминал и клонирај репозиторијум овако: git clone https://github.com/ProjectURL

Да би радио на пројекту, пребаци се у одговарајући фолдер: cd ProjectURL

Можеш такође отворити цео пројекат користећи Codespaces, GitHub-ов уграђени едитор кода / облачно окружење за развој, или GitHub Desktop.

На крају, можеш преузети код у зипованом фолдеру.

Неколико занимљивих ствари о GitHub-у

Можеш да означиш звездицом, пратиш и/или "форкујеш" било који јавни репозиторијум на GitHub-у. Своје репозиторијуме означене звездицом можеш пронаћи у падајућем менију у горњем десном углу. То је као обележавање, али за код.

Пројекти имају тракер проблема, углавном на GitHub-у у картици "Issues", осим ако није другачије назначено, где људи дискутују о проблемима везаним за пројекат. А картица Pull Requests је место где људи дискутују и прегледају измене које су у току.

Пројекти могу такође имати дискусије у форумима, мејлинг листама или каналима за ћаскање као што су Slack, Discord или IRC.

✅ Разгледај свој нови GitHub репо и испробај неколико ствари, као што су уређивање подешавања, додавање информација у свој репо и креирање пројекта (као што је Канбан табла). Постоји много тога што можеш да урадиш!

🚀 Изазов

Удружи се са пријатељем да радите на кодовима један другог. Креирајте пројекат заједно, форкујте код, креирајте гране и спојите измене.

Квиз након предавања

Преглед и самостално учење

Прочитај више о доприносу софтверу отвореног кода.

Git подсетник.

Вежбај, вежбај, вежбај. GitHub има одличне путеве за учење доступне преко skills.github.com:

Прва недеља на GitHub-у

Наћи ћеш и напредније курсеве.

Задатак

Заврши курс Прва недеља на GitHub-у

Одрицање од одговорности:
Овај документ је преведен коришћењем услуге за превођење помоћу вештачке интелигенције Co-op Translator. Иако настојимо да обезбедимо тачност, молимо вас да имате у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати меродавним извором. За критичне информације препоручује се професионални превод од стране људи. Не преузимамо одговорност за било каква погрешна тумачења или неспоразуме који могу настати услед коришћења овог превода.

27 KiB Raw Permalink Blame History Unescape Escape