GitHub што е тоа и како да го користите

GitHub е парче софтвер што широко се користи од тимовите за развој на софтвер, за контрола на развојната верзија.

Корисно е кога повеќе од едно лице работат на проект.

На пример, да претпоставиме дека тим од развивачи на софтвер сака да изгради веб-локација и сите тие треба да го ажурираат кодот, истовремено, додека работат на проектот. Во овој случај, Github помага да се создаде централизирано складиште каде што секој може да прикачува, уредува и управува со датотеки со програмски код.

Пред да започнете со користење на GitHub, треба да креирате сметка GitHub.

Репозиториум

Складиштето обично се користи за организирање на проект за апликативен софтвер. Складиштата може да содржат папки и датотеки, слики, видеа, табеларни пресметки и сетови на податоци - сè што му треба на вашиот проект. Често складиштата вклучуваат датотека README, датотека со информации за вашиот проект.

README-датотеките се напишани на јазикот Markdown во обичен текст. Можете да се консултирате Оваа страница веб како брза референца на јазикот Markdown. GitHub ви овозможува да додадете README-датотека во исто време кога го креирате вашето ново складиште. GitHub нуди и други вообичаени опции како што е датотеката за лиценца, но не треба првично да избирате ниту една.

За да креирате ново складиште, горе десно изберете во менито New repository. Продолжете со следните чекори:

1. Во горниот десен агол на која било страница, користете го опаѓачкото мени и изберете New repository.

1. Во полето Име на складиштето, внесете first-repository.
2. Во полето Опис, напишете краток опис.
3. Изберете Додај датотека README.
4. Изберете дали вашето складиште ќе биде јавно или приватно.
5. Кликнете на Create repository.

Создавање гранка

Создавањето гранка ви овозможува да имате неколку верзии на складиште во исто време.

Стандардноdefiнита, складиштето first-repository има именувана гранка main која се смета за гранка defiнитив. Можете да креирате дополнителни гранки за главно во складиштето first-repository. Можете да користите гранки за да имате различни верзии на проект во исто време. Ова е корисно кога сакате да додадете нова функционалност на проект без да го менувате главниот изворен код. Работата направена на различни гранки нема да се појави на главната гранка додека не ја споите. Можете да ги користите гранките за да експериментирате и да правите промени пред да ги ставите на главните.

Кога креирате гранка од главната гранка, правите копија или снимка од главната како што беше во тој момент. Ако некој друг направил промени во главната гранка додека сте работеле на вашата филијала, можете да ги поттикнете тие ажурирања.

На следниот дијаграм можеме да видиме:

Главната гранка
Се вика нова филијала feature
Патот кој го feature врши пред да се спои со main

Создавањето гранка за нова имплементација или поправка на грешки е како зачувување на датотека. Со GitHub, развивачите на софтвер користат гранки за да ги поправат грешките и да работат на функции, одвоени од главната производна гранка. Кога промената е подготвена, таа се спојува во главната гранка.

Ајде да создадеме гранка

Откако ќе го креирате нашето складиште, преместете се на јазичето <>Code(1) од складиштето:

Кликнете на главното (2) паѓачко мени, а потоа дајте му име на новото branch (3)

Кликнете на Create branch: first branch from 'main'

Сега имаме две branch, main e first-branch. Во моментов, тие изгледаат сосема исто. Подоцна ќе ги додадеме промените во новата branch.

Направете и потврдете ги промените

Само што го создадов новиот branch, GitHub ве доведе до code page за ново first-branch, што е копија на главната.

Можеме да правиме и зачуваме промени во датотеките во складиштето. На GitHub се повикуваат зачуваните промени commit. Секој commit има порака од commit поврзани, што е опис што објаснува зошто е направена одредена промена. Пораките на commit тие ја доловуваат историјата на промените за да можат другите соработници да разберат што е направено и зошто.

Под гранката first-branch создадена, кликнете на датотеката README.md, а потоа на моливот за да ја уредите датотеката.

Во уредникот, пишувајте користејќи Markdown.

Во кутијата Commit changes (Преглед), пишуваме порака на commit опишувајќи ги промените.

Конечно кликнете на копчето Commit changes.

Овие промени ќе се направат само во датотеката README first-branch, па сега оваа гранка содржи различна содржина од главната.

Отворање на еден pull request

Сега кога имаме промени во една гранка од главната, можеме да отвориме една pull request.

Le pull request тие се срцето на соработката на GitHub. Кога ќе отворите а pull request, ги предлагате вашите промени и барате некој да направи а review e pull на вашиот придонес и да ги споите во нивната гранка. На pull request покажете ги разликите на содржината на двете гранки. Промените, собирањата и одземањето се прикажани во различни бои.

Веднаш штом ќе направите обврзување, можете да отворите барање за повлекување и да започнете дискусија, дури и пред да заврши кодот.

Користење на функцијата @mention на GitHub во вашата порака на pull request, можете да побарате повратни информации од одредени луѓе или тимови, без оглед на нивната локација.

Можете дури и да отворите pull request во вашето складиште и спојте ги сами. Тоа е одличен начин да го научите протокот на GitHub пред да работите на поголеми проекти.

Да се ​​направи еден pull request треба да:

• Кликнете на јазичето pull request на вашето складиште first-repository.

• Кликнете на New pull request
• Во кутија Example Comparisons, изберете ја гранката што ја создадовте, first-branch, да се спореди со главната (оригиналот).
• Прегледајте ги вашите промени во разликите на страницата Спореди, проверете дали тие се оние што сакате да ги поднесете.

• Кликнете на Create pull request.

• Дајте му титула pull request напишете краток опис на вашите промени. Може да вклучите емотикони и да влечете и испуштате слики и гифови.

• Изборно, десно од насловот и описот, кликнете веднаш до Рецензенти. Примачи, етикети, проекти или пресвртници за да додадете некоја од овие опции на вашата pull request. Сè уште не треба да ги додавате, но овие опции нудат неколку начини за соработка користејќи ги вашите pull request.
• Кликнете на Create pull request.

Вашите соработници сега можат да ги прегледаат вашите промени и да даваат предлози.

Спој го твоето pull request

Во овој последен чекор, ќе ја споите вашата филијала first-branch во главниот огранок. По спојувањето на pull request, промени во гранката first-branch ќе бидат вградени во главната датотека.

Понекогаш, барањето за повлекување може да воведе промени во кодот кои се во конфликт со постоечкиот код на главната. Доколку има конфликти, GitHub ќе ве предупреди за конфликтниот код и ќе го спречи спојувањето додека не се решат конфликтите. Можете да направите обврска што ги решава конфликтите или да ги користите коментарите во барањето за повлекување за да разговарате за конфликтите со членовите на вашиот тим.

• Кликнете на Merge pull request за да се спојат промените во main.

• Кликнете на Confirm merge. Ќе добиете порака дека барањето е успешно споено и барањето е затворено.
• Кликнете на Delete branch. Сега кога вашиот richiesta pull е споен и вашите промени се на главното, можете безбедно да ја избришете гранката first-branch. Ако сакате да направите дополнителни промени во вашиот проект, секогаш можете да креирате нова гранка и да го повторите овој процес.

Ercole Palmeri