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.

Създаване на клон

Създаването на клон ви позволява да имате няколко версии на хранилище едновременно.

По подразбиранеdefinita, хранилището first-repository има наименуван клон main който се счита за клона defiнитив. Можете да създадете допълнителни клонове към основния в хранилището first-repository. Можете да използвате разклонения, за да имате различни версии на проект едновременно. Това е полезно, когато искате да добавите нова функционалност към проект, без да променяте основния изходен код. Работата, извършена в различни клонове, няма да се покаже в главния клон, докато не го обедините. Можете да използвате клонове, за да експериментирате и да правите промени, преди да ги приложите към main.

Когато създавате клон от главния клон, вие правите копие или моментна снимка на основния, какъвто е бил в този момент. Ако някой друг е направил промени в основния клон, докато сте работили върху вашия клон, можете да натиснете тези актуализации.

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

Основният клон
Нов клон се обади 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, което е копие на main.

Можем да правим и запазваме промени във файловете в хранилището. В 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. Когато отворите a pull request, вие предлагате вашите промени и изисквате някой да направи a review e pull на вашия принос и да ги обедините в техния клон. The 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 напишете кратко описание на вашите промени. Можете да включите емотикони и изображения и gifs с плъзгане и пускане.

• По желание, вдясно от заглавието и описанието, щракнете до Рецензенти. Получатели, етикети, проекти или важни етапи, за да добавите някоя от тези опции към вашите pull request. Все още не е необходимо да ги добавяте, но тези опции предлагат няколко начина за сътрудничество с помощта на вашия pull request.
• Натиснете Create pull request.

Вашите сътрудници вече могат да преглеждат вашите промени и да правят предложения.

Обединете вашите pull request

В тази последна стъпка ще обедините вашия клон first-branch в главния клон. След сливането на pull request, промени в клона first-branch ще бъде вграден в главния файл.

Понякога заявката за изтегляне може да въведе промени в кода, които са в конфликт със съществуващия код на main. Ако има някакви конфликти, GitHub ще ви предупреди за конфликтния код и ще предотврати сливането, докато конфликтите не бъдат разрешени. Можете да направите ангажимент, който разрешава конфликтите, или да използвате коментарите в заявката за изтегляне, за да обсъдите конфликтите с членовете на вашия екип.

• Натиснете Merge pull request за да обедините промените в основния.

• Натиснете Confirm merge. Ще получите съобщение, че заявката е обединена успешно и заявката е затворена.
• Натиснете Delete branch. Сега, когато си richiesta pull е обединен и вашите промени са на главния, можете безопасно да изтриете клона first-branch. Ако искате да направите допълнителни промени във вашия проект, винаги можете да създадете нов клон и да повторите този процес.

Ercole Palmeri