1. Уеб дизайн и разработка Как да настроите GitHub хранилище

От Сара Гутълс

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

За да получите по-добро разбиране какво е хранилище и как е структурирано, трябва да създадете първото си репо в GitHub:

Страница за ново хранилище на GitHubGitHub HelloWorld

Информация в горната част на вашето хранилище на GitHub

В горната част на хранилището е потребителското име на автора и заглавието на хранилището. Когато разклоните хранилище, виждате оригиналния автор отдолу за бърза връзка. Да разклоните хранилище означава да направите копие от него, където промените, които правите в своето копие, могат да бъдат предложени на оригиналния автор.

Вдясно от вашето потребителско име са три бутона:

  • Гледайте: Можете да изберете какъв вид известия искате да получавате въз основа на вида дейност, случваща се в това репо. Star: Starring може да ви помогне бързо да отидете до определени хранилища, както и да даде на GitHub представа за нещата, които ви интересуват, така че препоръките да бъдат по-точни за вас. За достъп до вашите хранилища със звезда, просто щракнете върху вашия аватар в горния десен ъгъл на GitHub.com и изберете Your Stars. Fork: Ако не сте автор на хранилището, тогава имате възможност да го разклоните.

Силно препоръчваме да изберете или Не гледате или Пускате само за повечето хранилища, така че да получавате известия само когато сте конкретно споменати или активно участвате в дискусия по даден проблем или заявка за изтегляне. В противен случай вашата пощенска кутия ще бъде пълна с имейли за всяко едно действие, предприето в хранилището, което ще излезе от употреба много бързо. Ако забележите, че това се случва, отидете на GitHub.com и бързо изтеглете всички или някои от хранилищата, които гледате.

Раздели във вашето хранилище на GitHub

Седем раздела се появяват в горната част на вашето репо. Всеки раздел предоставя различни функции за репо:

  • Код: Разделът Code е мястото, където можете да намерите целия си код и да преглеждате папки и файлове. Можете да щракнете върху файл, за да видите съдържанието му или щракнете върху иконата на молив, за да промените файла, точно в интернет браузъра си. (Вижте предстоящия раздел „Раздел Код“ за повече подробности.) Проблеми: Изданията са наистина чиста функция за репости. Проблемите могат да ви помогнат да проследявате нещата, които искате да продължите, проблеми, които имате, или предложения за други хора. Искания за изтегляне: Исканията за изтегляне, наричани също PR, са подобни на проблеми, тъй като имат заглавие и описание, но имат и промени в кода, които искате да бъдете изтеглени в основния клон. Най-сигурният начин да добавите код е да създадете нов клон, да промените кода си в него и след това да поискате този клон да бъде обединен с главния клон. PR ви дава интерфейс за сливане на двата клона, показва ви разликата между файловете, които сте променили, и тези, които са в главния клон, и ви дава място за разговор със сътрудници относно това дали кодът трябва да бъде обединен или променен трябва да се направи първо. Проекти: Вече може да сте запознати с дъски за проекти като Trello или Kanboard. GitHub има табла за проекти, свързани директно с вашето репо. Най-добрата част е, че картите на борда на проекта на GitHub могат да бъдат пряко свързани с проблеми или PR и могат автоматично да се движат, когато нещо се случи. Wiki: Уикисите са чудесно място за съхраняване на документация, състояние на проекта и пътни карти за вашия проект. Това е чудесно място за сътрудници да видят какво се случва и къде могат да скочат, за да помогнат! Статистика: Разделът „Статистика“, показан на следващата фигура, ви дава преглед на всички сътрудници и действия, случващи се в репото. Наистина е хубаво да виждате този раздел в популярни проекти с отворен код. Например, TensorFlow е имал 158 сътрудници през последния месец! Настройки: Разделът Настройки се вижда само ако имате правилните разрешения на хранилището. В този раздел можете да решите кой има достъп до какво и как трябва да си сътрудничат. Можете също да интегрирате приложения, които ви казват каква част от кода ви е покрит с тестове.
Раздел GitHub Insights

Раздел Код на вашето хранилище GitHub

Разделът Code, показан на следващата фигура, съдържа много допълнителни важни метаданни за вашето репо, които ще бъдат полезни в бъдещото развитие:

  • Описание и теми: В горната част на раздела Код е описание и място, където можете да поставите теми, за да направите вашето хранилище по-откриваемо. Добавянето на теми е особено важно, ако искате да привлечете други кодери, които да ви помогнат в изграждането на вашия софтуер. Метаданни: Тази лента съдържа информация и връзки към броя на комитите, клоновете, версиите и сътрудниците за репо. Бутони за действие: В лявата част на репото е падащо меню, в което можете да промените кой клон разглеждате или да прегледате файловете за определен клон. Бутонът за ново искане за изтегляне ви позволява бързо да създадете заявка за изтегляне. Най-добрият начин да създадете заявка за изтегляне е да преминете към друг клон, да направите някои промени и след това да кликнете върху Нова заявка за изтегляне. От дясната страна има три бутона, свързани с файлове: Създаване на нов файл, Качване на файлове и Намиране на файл. И накрая, можете да кликнете върху зеления клонинг или да изтеглите падащия списък, за да клонирате или изтеглите кода на вашата локална машина. Код: В долната част на раздела Код е списък на всички кодове в това репо. Ако md файл се появи в този списък, тогава файлът се показва под списъка. За всеки файл можете да щракнете върху името на файла, за да отидете на страница, където можете да видите файла и да го редактирате, ако искате.
Раздел GitHub Code
  1. Уеб дизайн и разработка предприемете действия с GitHub действия

От Сара Гутълс

GitHub има функция, която премахва необходимостта да хостваме нашето приложение извън GitHub, което може да намали броя на движещите се части при разширяване на GitHub. Тази функция се нарича GitHub Actions.

GitHub Actions е една от най-новите и вълнуващи функции на GitHub. По време на писането това все още е бета функция. Действията на GitHub правят възможно създаването на персонализирани работни процеси в GitHub. Тя ви позволява да прилагате персонализирана логика, за да реагирате на събития в GitHub. В предишния раздел написахме приложение на GitHub, за да направим това. С GitHub Actions не е необходимо да създаваме персонализирано приложение. Можем да изградим работни процеси, като използваме съществуващи действия, които други са написали, или можем да напишем собствени действия, които се изпълняват в контейнер на Docker.

Да се ​​надяваме, че до момента, когато прочетете това, GitHub Actions са общодостъпни. Но в случай, че те все още са в бета версия, изпратете имейл на support@github.com и поискайте да участвате в бета програмата на GitHub Actions.

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

Не изтриването на клона не е непременно лошо нещо, освен ако не сте типът човек, който обича нещата да бъдат подредени и не може да издържи да има клон, който вече не е нужно да се задържи наоколо. Ако сте такъв тип човек, имате късмет. Jesse Frazelle също е този тип хора и тя написа GitHub Action, която можете да използвате в собствените си работни процеси. Нейната публикация в блога, „Животът на GitHub Action“, е добро четиво, за да разберете повече подробности за жизнения цикъл на GitHub действие.

Създаване на работен процес на действие на GitHub

Ако сте били приети в бета програмата на GitHub Actions или тя е станала по-широко достъпна, трябва да видите допълнителен раздел в горната част с етикети Действия, когато преглеждате хранилище.

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

Работни процеси на GitHubПрости работни процеси в GitHub

Тестване на GitHub Action

След като ангажирате този файл във вашето хранилище, работният процес е активен. Можете да го тествате, като създадете нова заявка за изтегляне и след това я обедините. Няколко секунди или минути по-късно трябва да видите, че клона на заявката за изтегляне е изтрит. Актуализация на заявката за изтегляне казва нещо подобно

github-Actions bot изтри клона с името на клона преди 1 минута

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

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