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

Вземете настройка

Тази статия предполага, че вече имате акаунт в GitHub, но ако не, моля бързо регистрирайте се за безплатен акаунт. Също така се уверете, че вече имате git инсталиран чрез изпълнение на следната команда в терминала:

git --версия

Ако вместо да видите номера на версията, получите съобщение „команда не е намерена“, можете да инсталирате git с командата:

sudo apt-get -y инсталирайте git

Разклонете хранилището

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

instagram viewer
https://github.com/mdizak/muo_demo. Това е проста демонстрация и можете да създадете заявки за изтегляне срещу нея за целите на тестване и обучение.

Докато разглеждате хранилището във вашия уеб браузър, потърсете Хранилище за вилици и щракнете върху него. Това ще разклони хранилището към вашия собствен акаунт в GitHub и ще ви отведе до него. След това трябва клонирайте новораздвоеното хранилище, така че отворете терминала на вашия локален компютър и стартирайте:

Как да клонирате хранилище с помощта на GitHub Desktop

Искате ли да се запознаете със софтуера на GitHub? Ето как да го направите на изток с рационализирания инструмент GitHub Desktop.

git клонинг https://github.com/myusername/muo_demo.git
cd muo_demo

Естествено, уверете се, че сте променили горния URL адрес на този на новоразклоненото хранилище. След като бъде клониран, добавете оригиналното хранилище като upstream с командата:

git remote add upstream https://github.com/mdizak/muo_demo.git

Уверете се, че сте променили URL адреса в горната команда с този на оригиналното хранилище, което сте клонирали. Това означава, че git е негово родителско хранилище, от което работите.

Подгответе локално хранилище

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

git checkout master
git pull master нагоре по веригата && git push master master

Първата команда гарантира, че в момента работите в главния клон, а втората команда синхронизира родителското хранилище както с локалните, така и с GitHub хранилищата. Това гарантира, че променяте най-актуалната кодова база и не работите с остарял код.

Също така не забравяйте да проверите дали проектът има файл cont.md и ако да, моля, уверете се, че следвате това, което пише. Понякога проектите имат конкретни насоки относно това как да предоставят вноски, които винаги трябва да се следват.

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

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

Въпреки че не е задължително, обикновено се счита за любезна учтивост да се добавя пред името на клона префикс актуална корекция / за бързи корекции на грешки или особеност/ за добавени функции. Изберете желаното име на клон и изпълнете командата:

git checkout -b функция / my_cool_feature

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

Сега, когато вашият клон е създаден, продължете и завършете всички необходими модификации, които искате, със стандартния работен поток на git.

Задайте и създайте заявка за изтегляне

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

git commit --file commit.txt
git push -u функция за произход / my_cool_feature

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

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

Продължете да допринасяте за GitHub

Поздравления, успешно изпратихте принос към проект на GitHub!

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

електронна поща
Как да добавите повече RAM към вашето устройство Android с MicroSD карта

Ако вашият Android телефон или таблет работи малко бавно, може просто да се нуждае от малко повече RAM. Можем да помогнем с това.

Свързани теми
  • Програмиране
  • GitHub
За автора
Мат Дизак (Публикувани 11 статии)Още от Мат Дизак

Абонирайте се за нашия бюлетин

Присъединете се към нашия бюлетин за технически съвети, рецензии, безплатни електронни книги и ексклузивни оферти!

Още една стъпка…!

Моля, потвърдете имейл адреса си в имейла, който току-що ви изпратихме.

.