Hello World

Выполните это Hello World упражнение, чтобы узнать GitHubрабочий процесс запроса на вытягивание.

В этой статье

Introduction

В этом руководстве вы GitHub узнаете, как репозитории, ветви, фиксации и запросы на вытягивание. Вы создадите собственный репозиторий Hello World и изучите GitHubрабочий процесс запроса на вытягивание, популярный способ создания и проверки кода.

В этом кратком руководстве вы выполните следующие действия:

  • Создание и использование репозитория.
  • Запустите и управляйте новой ветвью.
  • Внесите изменения в файл и отправьте их в GitHub виде фиксаций.
  • Откройте и объедините запрос на вытягивание.

Необходимые условия

  • У вас должна быть GitHub учетная запись. Для получения дополнительной информации см. Создание аккаунта на GitHub.

  • Вам не нужно знать, как кодировать, использовать командную строку или устанавливать Git (программное обеспечение управления версиями, GitHub созданное на основе).

Шаг 1. Создание репозитория

Первое, что мы сделаем, — создать репозиторий. Репозиторий можно рассматривать как папку, содержащую связанные элементы, такие как файлы, изображения, видео или даже другие папки. Репозиторий обычно группировать элементы, принадлежащие одному и тому же проекту или тому, над которым вы работаете.

Репозитории часто включают файл сведений о проекте. Файлы README записываются в Markdown, который является простым для чтения и простого языка записи для форматирования обычного текста. Дополнительные сведения о файлах Markdown и README см. в Базовый синтаксис написания и форматирования и Управление файлом сведений о профиле.

GitHub позволяет добавлять файл README одновременно с созданием нового репозитория. GitHub также предлагает другие распространенные варианты, такие как файл лицензии, но вам не нужно выбирать какие-либо из них сейчас.

В репозитории hello-world можно хранить идеи и ресурсы, а также делиться ими и обсуждать их с другими пользователями.

  1. В правом верхнем углу любой страницы выберите , а затем нажмите кнопку "Создать репозиторий".

    Снимок экрана: раскрывающееся меню GitHub с параметрами создания новых элементов. Пункт меню "Новый репозиторий" описан в темно-оранжевый.

  2. В поле "Имя репозитория" введите hello-world.

  3. В поле "Описание" введите короткое описание. Например, введите "Этот репозиторий предназначен для практики GitHub потока".

  4. Выберите, будет ли репозиторий общедоступным или частным.

  5. Выберите параметр Добавить файл сведений.

  6. Щелкните Создать репозиторий.

Шаг 2. Создание ветви

Ветвление позволяет одновременно иметь разные версии репозитория.

По умолчанию репозиторий имеет одну ветвь с именем main, которая считается главной. В репозитории можно создать дополнительные ветви на основе main.

Ветвление полезно при добавлении новых функций в проект без изменения основного источника кода. Работа, выполняемая в других ветвях, не будет отражаться в главной ветви, пока вы не выполните ее слияние (этот процесс будет рассмотрен далее в руководстве). Ветви можно использовать для проведения экспериментов и внесения изменений перед их фиксацией в main.

Когда вы создаете ветвь на основе ветви main, создается копия или моментальный снимок main на этот момент времени. Если кто-то другой внес изменения в ветвь main, пока вы работали со своей ветвью, вы можете вытянуть эти изменения.

На этой схеме показано следующее:

  • ветвь main;
  • новая ветвь с именем feature;
  • Путешествие, которое feature проходит через этапы для "Фиксация изменений", "Отправить запрос на вытягивание", и "Обсудить предложенные изменения", прежде чем он объединен в main

Схема двух ветвей. Ветвь "feature" отличается от ветви main и затем объединяется обратно в основную.

Создание ветви

  1. В репозитории **** перейдите на вкладку hello-world.

  2. Над списком файлов щелкните раскрывающееся меню, которое говорит main.

    Снимок экрана: страница репозитория. Раскрывающееся меню, помеченное значком ветви и "main", выделено оранжевым контуром.

  3. В текстовом поле введите имя ветви readme-edits.

  4. Нажмите кнопку Создать ветвь readme-edits на основе main.

    Снимок экрана: раскрывающийся список ветви для репозитория. "Создать ветвь: readme-edits from 'main'' описывается в темно-оранжевый цвет.

Теперь у вас две ветви: main и readme-edits. Сейчас они выглядят совершенно одинаково. Затем вы добавите изменения в новую readme-edits ветвь.

Шаг 3. Внесение и фиксация изменений

Когда вы создали новую ветвь на предыдущем шаге, GitHub довели вас на кодовую страницу для новой readme-edits ветви, которая является копией main.

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

  1. В созданной readme-edits ветви щелкните README.md файл.
  2. Чтобы изменить файл, нажмите кнопку .
  3. В редакторе напишите немного о себе.
  4. Щелкните Зафиксировать изменения.
  5. В поле "Фиксация изменений" напишите сообщение фиксации, описывающее изменения.
  6. Щелкните Зафиксировать изменения.

Эти изменения будут внесены только в файл сведений в вашей ветви readme-edits, поэтому теперь ее содержимое отличается от main.

Шаг 4. Открытие запроса на вытягивание

Теперь, когда у вас есть изменения в ветви, созданной на основе main, можно открыть запрос на вытягивание.

Запросы на вытягивание — это сердце совместной работы GitHub. Когда вы открываете запрос на вытягивание, вы предлагаете свои изменения и просите, чтобы кто-нибудь проверил результаты вашей работы, извлек их и выполнил слияние со своей ветвью. В запросах на вытягивание показаны различия в содержимом двух ветвей. Изменения, дополнения и исключения отображаются разными цветами.

Сразу после фиксации вы можете открыть запрос на вытягивание и начать обсуждение, даже если код еще не завершен.

На этом шаге вы откроете запрос на вытягивание в собственном репозитории, а затем объедините его самостоятельно. Это отличный способ практики GitHub потока перед работой над крупными проектами.

  1. В репозитории **** перейдите на вкладку hello-world.

  2. Нажмите кнопку "Создать запрос на вытягивание".

  3. В поле Примеры сравнения выберите созданную вами ветвь readme-edits, чтобы сравнить ее с main (исходной ветвью).

  4. Просмотрите различия на странице сравнения и убедитесь в том, что они готовы к отправке.

    Снимок экрана: дифф для файла README.md. 3 красные строки перечисляют текст, который удаляется, и 3 зеленые строки перечисляют добавляемый текст.

  5. Нажмите "Создать pull request".

  6. Укажите заголовок запроса на вытягивание и напишите краткое описание изменений. Вы можете добавлять эмодзи и перетаскивать изображения и GIF-файлы.

  7. Нажмите "Создать pull request".

Проверка запроса на включение изменений

Когда вы начинаете сотрудничать с другими пользователями, это время, когда вы попросите их рецензирование. Это позволяет участникам совместной работы комментировать или предлагать изменения в запрос на вытягивание перед слиянием изменений в main ветви.

Мы не рассмотрим запросы на вытягивание в этом руководстве, но если вы заинтересованы в обучении больше, см . раздел AUTOTITLE. Кроме того, воспользуйтесь курсом GitHub Skills "Просмотр запросов на вытягивание".

Шаг 5. Объединение запроса на вытягивание

На этом последнем шаге вы выполните слияние ветви readme-edits с ветвью main. После слияния запроса на вытягивание изменения в вашей ветви readme-edits будут включены в main.

Иногда запрос на вытягивание может вносить изменения в код, конфликтующие с существующим кодом в main. Если есть конфликты, сообщит вам о конфликтующий код и предотвратит слияние до тех пор, GitHub пока не будут устранены конфликты. Вы можете выполнить фиксацию, которая устраняет конфликты, или использовать комментарии в запросе на вытягивание, чтобы обсудить конфликты с участниками команды.

При выполнении этого пошагового руководства конфликтов не должно быть, поэтому ваша ветвь готова к слиянию с главной.

  1. В нижней части запроса на вытягивание нажмите кнопку "Объединить запрос на вытягивание", чтобы объединить изменения mainв .
  2. Щелкните Подтвердить слияние. Вы получите сообщение о том, что запрос был успешно объединен и закрыт.
  3. Щелкните Удалить ветвь. Теперь, когда запрос на вытягивание объединен и изменения включены в main, вы можете спокойно удалить ветвь readme-edits. Чтобы внести дополнительные изменения в проект, вы всегда можете создать новую ветвь и повторить этот процесс.
  4. Вернитесь на вкладку "Код " репозитория hello-world , чтобы просмотреть опубликованные изменения main.

Conclusion

Выполнив это руководство, вы узнали, как создать проект и выполнить запрос GitHubна вытягивание.

В рамках этого мы узнали, как:

  • Создайте репозиторий.
  • Запустите и управляйте новой ветвью.
  • Измените файл и зафиксируйте эти изменения GitHub.
  • Откройте и объедините запрос на вытягивание.

Дальнейшие действия

  • Посмотрите на свой GitHub профиль, и вы увидите, что ваша работа отражается на графике вклада.
  • Если вы хотите поработать с навыками, которые вы узнали в этом руководстве, попробуйте перейти к курсу GitHub SkillsGitHub"Введение в".
  • Персонализация профиля и изучение базового синтаксиса Markdown для записи см GitHub. в разделе Персонализация профиля.

Дополнительные материалы