раздел 01

Репозиторий на GitHub

Репозиторий - это и есть ваш проект на GitHub: код, история изменений, описание, задачи. Всё начинается с его создания.

Создание репозитория

На GitHub нажмите New repository (зелёная кнопка в правом верхнем меню или на главной). Дальше задаёте:

  • имя репозитория и короткое описание;
  • видимость - public или private;
  • по желанию сразу добавить README, .gitignore и лицензию.
Public
Виден всем. Подходит для опенсорса и портфолио. Любой может смотреть код, но не менять его без доступа.
Private
Виден только вам и приглашённым. Для рабочих проектов и того, что не готово к публикации.

README, .gitignore и лицензия

Три файла, которые стоит добавить почти всегда.

  • README.md - визитка проекта. Что это, зачем, как запустить. GitHub показывает его прямо на главной странице репозитория. Пишется в формате Markdown.
  • .gitignore - список того, что не надо коммитить: папки node_modules, файлы .env с секретами, временные и системные файлы. GitHub предлагает готовые шаблоны под язык.
  • лицензия - правила использования вашего кода другими. Для опенсорса частые варианты - MIT и Apache 2.0. Без лицензии формально код нельзя свободно использовать.

Связь локального проекта с GitHub

Если код уже есть на компьютере, его нужно связать с пустым репозиторием на GitHub. За это отвечает remote - ссылка на удалённый репозиторий.

# связать локальный репозиторий с GitHub
git remote add origin https://github.com/username/my-project.git

# отправить код и ветку в облако
git branch -M main
git push -u origin main

origin - это стандартное имя для основного remote. После git push код появляется на GitHub.

Клонирование

Чтобы скачать существующий репозиторий к себе, его клонируют. Команда копирует код вместе со всей историей:

git clone https://github.com/username/my-project.git

Если командная строка пугает - есть GitHub Desktop, графическое приложение: клонирование, коммиты и push делаются кнопками.

Пошагово: от создания до первой загрузки

1
Создать репозиторий
New repository, задать имя и видимость. Можно без README, если код уже есть локально.
2
Добавить .gitignore
Убедиться, что секреты и мусорные папки не попадут в коммит.
3
Связать remote
git remote add origin с адресом репозитория из браузера.
4
Сделать коммит
git add . и git commit -m с описанием изменений.
5
Запушить
git push -u origin main - код уезжает в облако и появляется на GitHub.