Создаём репозиторий на GitHub

Предварительные требования

1. Есть базовое понимание что такое Git и GitHub
2. Вы зарегистрированы на GitHub и авторизованы на сайте

Создать новый публичный репозиторий

Откройте главную страницу GitHub и нажмите зеленую кнопку New в меню слева.

Вы попадёте на страницу создания репозитория, где необходимо выполнить 4 шага (каждый шаг подробно описан после скриншота – ознакомьтесь с ними, прежде чем завершать создание репозитория):

1. Укажите имя репозитория
2. Выберите пункт Public
3. Включите “галочку” Add a README file
4. Нажмите зелёную кнопку Create repository

Имя репозитория

Есть определённые ограничения для названия репозитория: можно использовать только латинскую раскладку клавиатуры (английские буквы), цифры, а также точку “.”, дефис “-” и построчный пробел “_”. Любые другие символы будут проигнорированы, либо заменены на дефис.

Такие ограничения связаны с тем, что имя репозитория будет использовано как часть URL, поэтому GitHub автоматически заменит все неподходящие символы.

Иногда новички используют транслитерацию (русские слова, записанные английскими буквами: mashina, holodilnik) – однако это считается “дурным тоном” среди опытных программистов. Если на начальных этапах это упростит поиск нужного репозитория в вашем аккаунте – можете делать именно таким образом. Но имейте ввиду, что большая часть документации написана на английском языке, поэтому:

Чем раньше вы начнёте изучать английский язык, тем лучше

Самый простой способ именования репозиториев – указать название клиента, проекта, учебного курса или компании, для которой пишется код.
Так, имя devman_courses-python_basics-02 указывает на то, что:

• репозиторий создан в рамках учебы на Девман
• модуль Основы Python
• Урок №2

Минус такого подхода – название может быть довольно громоздким и сложно читаемым. Чтобы исправить это, придумайте какие-нибудь стандартные сокращения внутри вашего аккаунта GitHub, например: dvmn-py_basics-02 – короче, но с тем же смыслом

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

Если вы видите красное оповещение подобного содержания: "The repository [указанное название] already exists on this account” – это значит, что подобное название уже было использовано ранее, поэтому нужно выбрать другое.

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

Публичный репозиторий

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

Избегайте создания Приватных репозиториев, если находитесь в Крыму или на Новых территориях

К сожалению, санкцией за использование приватных репозиториев в этих локациях является полная блокировка аккаунта на GitHub без возможности восстановления.

README файл

Включить “галочку” Add a README file. Благодаря этой настройке при создании репозитория автоматически будет добавлен файл документации проекта, который всегда отображается на главной странице репозитория. В файле по умолчанию будет указано название репозитория. По своей сути это обычный текстовый документ со специальным форматированием Markdown. На данный момент нет необходимости углубляться в особенности синтаксиса этого файла, достаточно знать, что в нем всегда хранится документация проекта.

Завершаем создание репозитория

Создавать файл .gitignore и выбирать лицензию не обязательно на начальных этапах обучения. Вы сможете вернуться к ним позже и добавить при необходимости. Нажмите зеленую кнопку Create repository — она завершит создание репозитория и откроет в браузере его главную страницу.

Проверяем результат

Вы сделали всё правильно, если:

1. видите метку Public рядом с названием репозитория на вкладке <> Code
2. видите поле со списком файлов и папок с одним файлом README.md
3. видите содержимое файла README.md – название вашего проекта

Если рядом с названием репозитория стоит метка Private (Частный, Непубличный), то другие пользователи не смогут увидеть ваш код.

Если при создании репозитория не было добавлено ни одного файла (README.md, Лицензия или .gitignore), то главная страница будет выглядеть иначе

Однако, вы по-прежнему можете убедиться что создание репозитория прошло успешно если вы видите

• название репозитория
• метку режима его видимости

Как найти репозиторий, если вкладка в браузере была закрыта

Если страница репозитория была закрыта, то его необходимо искать в списке проектов, для чего требуется выполнить несколько шагов:

• Открыть главную страницу GitHub

• Найти в меню слева нужный репозиторий по его названию

• Если количество репозиториев достаточно большое, то не все из них будут отображены в этом списке. Нажмите кнопку “Show more” (Показать больше) или начать вводить название в строке поиска, как на скриншоте ниже.

• Альтернативный способ – открыть полный список репозиториев через меню аккаунта (анимация ниже).