"Hello World"

"Hello World"

10 минут чтения (Перевод: Par1zvaL)

Проект Hello World - это давняя традиция в программировании. Это простое упражнение, с помощью которого вы начнете изучать что-то новое. Давайте начнем с GitHub!


Ты научишся:

  • Создавать и использовать репозитории
  • Создавать и изменять новые ветки
  • Вносить изменения в файл и заливать их на GitHub как коммиты
  • Открывать и соединять пулл-реквесты


Что такое GitHub?

GitHub - это платформа для размещения кода для контроля версий и совместной работы. Это позволяет вам и другим работать вместе над проектами из любой точки мира.

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

Писать код не требуется

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

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


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

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

Ваш репозиторий hello-world может быть местом, где вы храните идеи, ресурсы или даже делитесь и обсуждаете вещи с другими!

Для того что бы создать репозиторий

  1. В верхнем правом углу, рядом с вашей аватаркой, клацните по иконке "+" а потом выберите New Repository.
  2. Назовите ваш репозиторий hello-world.
  3. Напишите краткое описание.
  4. Выберите Initialize this repository with a README.

Нажмите Create repository


Шаг 2. Создайте ветку

Ветвление - это способ работы с разными версиями хранилища одновременно.


По умолчанию ваш репозиторий имеет одну ветвь с именем master, которая считается окончательной ветвью. Мы рекомендуем использовать ветки, чтобы экспериментировать и вносить изменения, прежде чем заносить их в окончательный вариант.


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


Эта диаграмма показывает:


  • master ветку
  • Новая ветвь под названием feature (потому что мы выполняем 'feature work' в этой ветке)
  • Часть, которою занимает эта feature, прежде чем она станет частью master ветки


Вы когда-нибудь сохраняли разные версии файла? Что-то вроде:

история.txt

история-джо-измененная.txt

история-джо-редактировать-проверено.txt

Ветки достигают аналогичных целей в репозиториях GitHub.


Здесь, на GitHub, наши разработчики, писатели и дизайнеры используют ветки для хранения исправлений, ошибок и работы с фичами, отдельно от нашей основной (master) ветки. Когда изменение готово, они объединяют свою ветвь с master'ом.


Создайте новую ветку

Зайдите в свой новый репозиторий hello-world.

Нажмите на раскрывающийся список в верхней части списка файлов с надписью branch: master.

Введите название ветви readme-edits в текстовое поле новой ветви.

Выберите синюю кнопку «Создать» или нажмите «Enter» на клавиатуре.

Теперь у вас есть две ветки, master и readme-edit. Они выглядят одинаково, но ненадолго! Далее мы добавим наши изменения в новую ветку.


Шаг 3. Внесите и передайте изменения

Браво! Теперь вы находитесь в представлении кода для вашей ветви readme-edits, которая является копией master. Давайте внесем некоторые изменения.


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


Для того что бы вносить и фиксировать изменения

1) Нажмите на файл README.md.

2)Нажмите на значок карандаша в верхнем правом углу представления файла для редактирования.

3)В редакторе напишите немного о себе.

4)Напишите коммит-сообщение, которое описывает ваши изменения.

5)Нажмите кнопку «Применить изменения».

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


Шаг 4. Откройте запрос на извлечение

Хорошие правки! Теперь, когда у вас есть изменения в ветке от мастера, вы можете открыть пулл-реквест.


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


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


Используя систему @mention от GitHub в своем сообщении о запросе на выдачу, вы можете запросить обратную связь от конкретных людей или команд, независимо от того, находятся ли они в зале или в 10 часовых поясах.


Вы даже можете открывать запросы на извлечение в своем собственном репозитории и объединять их самостоятельно. Это отличный способ изучить GitHub перед началом работы над более крупными проектами.


Откройте запрос на извлечение изменений в README

P.S Шаги в описании картинок


Перейдите на вкладку Pull Request, затем на страницеPull Request нажмите зеленую кнопку New pull request.
Выберите ветку readme-edit
Проверте ваши изменения, удостовертесь что хотите их отправить


Когда закончите - нажмите кнопку Create pull request
Добавьте имя и описание к вашему запросу


952/5000




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

На этом последнем этапе пришло время объединить ваши изменения: - объединить ветку readme-edits с веткой master.

1) Нажмите зеленую кнопку Merge pull request, чтобы объединить изменения в master.

2) Нажмите Confirm merge.

3) Дальше удалите ветку, так как ее изменения были включены в основную, с помощью кнопки Delete branch в фиолетовом поле.

delete

Празднуйте!

Завершив этот урок, вы научились создавать проект и отправлять запросы на GitHub!

Вот что вы сделали в этом уроке:

  • Создали репозиторий с открытым исходным кодом
  • Начали и изменили новую ветку
  • Изменили файл и отправили изменения на GitHub
  • Открыли и обьеденили Pull Request

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

Чтобы узнать больше о мощности запросов на извлечение, мы рекомендуем прочитать руководство по потоку GitHub. Вы также можете посетить GitHub Explore и принять участие в проекте с открытым исходным кодом.





Report Page