Вы когда-нибудь находили на GitHub пакет, который вам понравился, но вы хотели добавить быструю функцию, исправить обнаруженную ошибку или, может быть, просто внести свой вклад в открытый исходный код в целом? Присоединяйтесь к тенденции социального программирования, делитесь своими навыками и помогайте миру с открытым исходным кодом. В этой статье вы узнаете все о том, как добавить код в репозиторий на GitHub или в любой размещенной службе git.
Получить настройку
В этой статье предполагается, что у вас уже есть учетная запись GitHub, но если нет, пожалуйста, быстро Зарегистрировать бесплатный аккаунт. Также убедитесь, что у вас уже есть мерзавец устанавливается с помощью следующей команды в терминале:
git --versionЕсли вместо номера версии вы получите сообщение «команда не найдена», вы можете установить мерзавец командой:
sudo apt-get -y установить gitРазветвить репозиторий
Сначала вы должны выбрать репозиторий, в который вы хотите внести свой вклад, и посетить его в своем веб-браузере. Если вы не уверены, какой репозиторий выбрать, вы можете использовать демонстрационный репозиторий, расположенный по адресу
https://github.com/mdizak/muo_demo. Это простая демонстрация, и вы можете создавать запросы на вытягивание для нее в целях тестирования и обучения.При просмотре репозитория в веб-браузере найдите Репозиторий вилок кнопку и щелкните ее. В результате репозиторий будет соединен с вашей учетной записью GitHub и вы попадете в него. Далее вам нужно клонировать вновь созданный репозиторий, поэтому откройте терминал на своем локальном компьютере и запустите:
Хотите разобраться с программным обеспечением на GitHub? Вот как сделать это на востоке с помощью оптимизированного инструмента GitHub Desktop.
git clone https://github.com/myusername/muo_demo.git
cd muo_demoЕстественно, убедитесь, что вы изменили вышеуказанный URL-адрес на URL-адрес вашего вновь созданного репозитория. После клонирования добавьте исходный репозиторий в качестве восходящего с помощью команды:
git удаленный добавить вверх по течению https://github.com/mdizak/muo_demo.gitУбедитесь, что вы изменили URL-адрес в приведенной выше команде на URL-адрес исходного репозитория, который вы клонировали. Для git это означает, что это родительский репозиторий, над которым вы работаете.
Подготовить локальный репозиторий
Каждый раз, прежде чем вы начнете работать над новым вкладом, убедитесь, что вы используете последнюю версию кода родительского репозитория. В каталоге проекта выполните в терминале следующие команды:
мастер проверки git
git pull upstream master && git push origin masterПервая команда гарантирует, что вы в настоящее время работаете в основной ветке, а вторая команда синхронизирует родительский репозиторий с локальным репозиторием и репозиторием GitHub. Это гарантирует, что вы изменяете самую последнюю базу кода и не работаете с устаревшим кодом.
Также не забудьте проверить, есть ли у проекта файл deposit.md, и если да, то обязательно следуйте его указаниям. Иногда в проектах есть конкретные инструкции относительно того, как делать взносы, которым следует всегда следовать.
Создать новую ветку
Вам необходимо создать новую ветку, в которой будут храниться все изменения для этого вклада, который позже будет объединен с основным репозиторием GitHub сопровождающими проекта. Ветвь должна быть буквенно-цифровой, и ее можно назвать как угодно.
Хотя это и не обязательно, обычно считается вежливостью добавлять к имени ветки префикс исправление / для быстрого исправления ошибок или особенность/ для дополнительных функций. Выберите желаемое имя ветки и выполните команду:
git checkout -b функция / my_cool_featureВы всегда должны создавать отдельную ветку для каждой функции / исправления ошибок и никогда не включать несколько вкладов в одну. Это помогает поддерживать плавный процесс разработки, а также гарантирует, что ваш вклад будет принят и включен в проект.
Теперь, когда ваша ветка создана, продолжайте и вносите любые необходимые изменения, которые вы хотите, с помощью стандартного рабочего процесса git.
Фиксация и создание запроса на извлечение
Завершив работу над своим вкладом, зафиксируйте его с помощью правильное сообщение фиксации и отправьте его в свой разветвленный репозиторий с помощью команд:
git commit --file commit.txt
git push -u функция происхождения / my_cool_featureПоследний шаг - создать пул-реквест, предупреждающий разработчиков проекта о том, что новый вклад находится на рассмотрении. Посетите разветвленный репозиторий GitHub в своем веб-браузере, и вы увидите кнопку раскрывающегося списка, позволяющую изменять ветки. Перейдите на свою недавно созданную ветку, и следующая страница будет содержать ссылку, позволяющую создать новый запрос на перенос.
Щелкнув эту ссылку, вы увидите страницу с сообщением о фиксации и всеми изменениями, которые вы внесли в код. Проверьте все, чтобы убедиться, что это правильно, добавьте необходимое дополнительное сообщение для сопровождающих и отправьте запрос на вытягивание.
Продолжайте вносить свой вклад в GitHub
Поздравляем, вы успешно внесли свой вклад в проект GitHub!
Ваш запрос на вытягивание сейчас ожидает рассмотрения и утверждения разработчиками проекта, и вы будете уведомлены по электронной почте о том, был ли он одобрен, а также с любыми сообщениями, которые у них есть для вас. Теперь, когда вы узнали, как вносить свой вклад в проекты на GitHub, продолжайте двигаться вперед и помогайте развивать сообщество с открытым исходным кодом.
Если ваш телефон или планшет Android работает немного медленно, ему может потребоваться немного больше оперативной памяти. Мы можем помочь с этим.
- Программирование
- GitHub
Подписывайтесь на нашу новостную рассылку
Подпишитесь на нашу рассылку, чтобы получать технические советы, обзоры, бесплатные электронные книги и эксклюзивные предложения!
Еще один шаг…!
Пожалуйста, подтвердите свой адрес электронной почты в электронном письме, которое мы вам только что отправили.
