Как создать репозиторий на GitHub
Данная статья:
- написана командой Vertex Academy. Надеемся, что она Вам будет полезна. Приятного прочтения!
- это одна из статей из нашего "Самоучителя по Java"
Привет! Это одна из статей из руководства "GIT основы: Курс молодого бойца"
Как создать репозиторий на GitHub
Как только Вы создали эккаунт на GitHub (см. статью "Как зарегистрироваться на GitHub"), перед Вами должно появиться похожее окно:
В самом верху, как видите, страница предлагает Вам прочитать гид по сайту. Вы можете сделать это в свободное время для лучшего знакомства с функционалом страницы - а Вам придется проводить на ней достаточно много времени.
Но сейчас, давайте начнем с основ. Сверху слева находится поисковая строка:
Справа вверху - небольшое меню:
Колокольчик - это уведомления.
Если нажать на иконку справа, появится меня для управления учётной записью:
Если же нажать на плюс, откроется выпадающее меню:
Как видите, можно:
- создать новый репозиторий ("New repository")
- импортировать репозиторий ("Import repository")
- новый gist ("New gist") - что-то наподобие статьи в блог
- новая организация ("New organisation") - например, Вы можете создать организацию, с которой можно связывать учётные записи на GitHub.
Три способа создать репозиторий на GitHub:
Cпособ 1: нажать на "New repository".
Способ 2: нажать на большую кнопку "Start a project" ("Создать проект"):
Способ 3: нажать на зеленую кнопку "New repository" ("Новый репозиторий") в окошке Repositories ("Репозитории"):
Создаем репозиторий на GitHub
Вы уже знаете три способа создать новый репозиторий! 🙂 Тогда создайте репозиторий, использовал любой из 3 способов.
Создали? Отлично, тогда Вы должны увидеть вот такую страницу:
Отлично! Давайте разберем по частям.
Сверху, Вы видите собственника репозитория ("Owner"), и название репозитория ("Repository name"). Давайте назовем его "first-repo":
Как выбирать имя для репозитория
В языке Java есть определенные Naming Conventions (Code Conventions), т.е. соглашение о том, как нужно называть переменные, классы, методы и т.д. Как Вы наверное помните, в Java принято использовать CamelCase (по-другому CamelStyle).
На GitHub таких правил нет. Тем не менее, часто можно увидеть запись через дефис (как сделали мы), или тем же CamelCase.
Для примера, можно посмотреть на репозитории:
- Google (https://github.com/google)
- Facebook (https://github.com/facebook)
- Microsoft (https://github.com/Microsoft)
Вот так выглядит репозиторий Google.
Если Вы просмотрите эти репозитории, то увидите, что чаще всего названия из нескольких слов записываются через дефис, или CamelCase.
Возвращаемся к созданию репозитория
Итак, дальше идёт описание ("Description"). Писать его не обязательно (справа от "Description" серым написано слово "optional"). Но если Вы хотите чтобы работодатель, который будет смотреть на Ваш аккаунт, или другие программисты, смогли понять о чём идёт речь и оценили Вашу работу, желательно подробно описывать проекты. В частности, это можно сделать с помощью README (об этом позже).
В описании давайте напишем "Первый проект на Git":
Затем мы можем выбрать, будет ли наш проект публичным (т.е. все смогут его видеть), или приватным. Как Вы помните, на бесплатных аккаунтах GitHub предоставляет безграничное хранилище только для публичных проектов.
Выбираем "Public":
На этом мы можем остановиться и нажать большую зеленую кнопку "Создать репозиторий" ("Create repository"). Тем не менее, есть еще несколько настроек, которые мы можем сделать.
Во-первых, Вы видите галочку "Initialise this repository with a README" (Создать репозиторий с README). README - это еще один способ рассказать людям, просматривающим Ваш репозиторий, о Вашем проекте.
Хорошо расписанные README будет выглядет примерно так:
Но написание таких файлов - отдельная наука. Файл README имеет расширение .md, свой синтаксис и метки. Подробнее то, как следует писать файл README, мы рассмотрим в следующих статьях.
Кроме создания README, у нас есть еще две опции - добавлять ли файл .gitignore (по умолчанию None - не добавлять), и добавлять ли лицензию (по умолчанию тоже None).
Про то, что такое файл .gitignore, мы поговорим в следующих статьях. В двух словах, это файл, который говорит GIT, какие файлы следует игнорировать при загрузке.
Также, Вы потенциально можете добавить лицензию к своему проекту:
Дело в том, что на GitHub размещают много open-source проектов, то есть бесплатных программ с открытым кодом. Интересно, что обычно лицензия используется не для того, чтобы ограничить доступ в проекту, а наоборот, чтобы позволить другим людям использовать Ваш код. Когда Вы ничего не указываете в поле "лицензия", использование кода из репозитория считается кражей.
Итак, отлично! Мы разобрались с основными полями, которые надо заполнить. Теперь, нажмем большую зеленую кнопку "Создать репозиторий" ("Create repository").
Теперь Вы должны видеть перед собой похожую страницу:
Вот мы и создали свой первый репозиторий на GitHub. Теперь он появится у Вас в разделе "Репозитории" на главной странице:
Теперь мы можем загружать проекты из компьютера на удаленный репозиторий на GitHub. О том, как это делать, мы поговорим в следующих статьях.
Спасибо, что были с нами! 🙂
Надеемся, что наша статья была Вам полезна. Можно записаться к нам на курсы по Java на сайте.