Как создать свой первый репозиторий на Github

Хотите поделиться своими проектами разработки в Интернете? Вот как создать свой первый репозиторий на Github

Популярный сайт Github вместе с инструментом git представляет собой отличный ресурс не только для распространения и демонстрации вашей работы, но и для эффективного и профессионального контроля версий

В этом руководстве мы рассмотрим, как создать репозиторий Github, размещать коммиты, отмечать релизы и многое другое

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

Чтобы создать новый репозиторий, сначала войдите на Github или зарегистрируйте новый аккаунт. После входа в систему нажмите на кнопку Create New в правом верхнем углу экрана, а затем на ссылку Repository в появившемся выпадающем списке

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

Имя и описание хранилища могут быть любыми по вашему желанию, в данном примере в качестве имени было использовано ‘muo_demo’. Оставьте остальные поля пустыми и нажмите кнопку Create new Repository. Вы попадете на страницу с новым пустым хранилищем

Связанное: Что такое GitHub? Введение в его основные функции

Запуск локального репозитория

Теперь, когда репозиторий на Github создан, необходимо инициализировать его на локальном компьютере. Выполните следующие команды в терминале, чтобы создать пустой каталог и добавить файл Readme.md

mkdir myrepo

cdmyrepo

echo'# My Test Repository'> Readme.md

echo'A temporary file'> temp.txt

При просмотре репозитория на Github содержимое файла Readme.md всегда отображается для описания репозитория или как первая страница руководства. Расширение файла.md означает формат Markdown, и если вы не знакомы с Markdown, ознакомьтесь с нашей отличной шпаргалкой по формату Markdown

Теперь вы можете инициировать репозиторий в терминале с помощью команд

git init

git remote add origin https://github.com/mdizak/muo_demo.git

Во второй команде вам нужно изменить ‘mdizak’ на ваше имя пользователя Github, а часть ‘muo_demo’ на имя вашего репозитория. Например, если ваше имя пользователя Github – ‘johndoe’, а имя вашего репозитория – ‘test_repo’, команда будет выглядеть следующим образом:

git remote add origin https://github.com/johndoe/test_repo.git

Первый коммит

Теперь вы можете синхронизировать локальный репозиторий и репозиторий Github и добавить два файла на Github, выполнив следующие команды в терминале

git add Readme.md temp.txt

git commit -m'My first commit'

git push -u origin master

Вам будет предложено ввести имя пользователя и пароль Github, и после успешного ввода два файла будут загружены в ваш репозиторий Github. Если вы перезагрузите свой репозиторий Github в браузере, вы увидите эти два файла вместе с заголовком ‘My Test Repository’ в файле Readme.md

Большие сообщения о коммитах

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

git commit --file=/path/to/commit.txt

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

Удаление файлов

Удаление файлов происходит примерно так же, за исключением использования вышеуказанной команды git add , мы используем команду git rm. Чтобы удалить файл temp.txt, который вы ранее добавили, выполните следующие команды в терминале

git rm temp.txt

git commit -m'Deleting temp file'

git push -u origin master

Вам снова будет предложено ввести имя пользователя и пароль, и после этого файл temp.txt будет удален из вашего репозитория Github. Вот и все!

Похожие: Как удалить нежелательные репозитории на GitHub

Тегирование релизов

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

Пометка репозитория как релиза осуществляется путем добавления тега с номером версии. Например, чтобы обозначить наш текущий репозиторий как v1. 0. 0 в терминале выполните команды

git tag 1. 0. 0

git push --tags

После ввода имени пользователя и пароля Github перезагрузите страницу репозитория в веб-браузере. Вы заметите, что теперь в вашем репозитории есть один релиз. Если вы перейдете к просмотру всех релизов, вы увидите ссылку на архив TAR.GZ для полного репозитория в состоянии, когда релиз был помечен

Клонирование репозитория

Иногда вам потребуется клонировать и заново инициализировать репозиторий с нуля. Это легко сделать с помощью следующих команд в терминале

gitclonehttps://github.com/mdizak/muo_demo.git myrepo

cdmyrepo

git init

Как и при инициализации репозитория, в первой строке нужно изменить имя пользователя Github и имя репозитория в URL

Это позволит загрузить содержимое репозитория с Github в каталог /myrepo/, а затем повторно инициализировать его с помощью команды git init. После этого вы можете продолжать добавлять и удалять файлы так же, как описано выше

Просмотр истории коммитов

Вы можете вернуться назад и просмотреть свои предыдущие коммиты с помощью git log , например:

gitlog- 3

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

Внести изменения в сообщение о фиксации

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

git commit --amend

Это откроет ваш текстовый редактор по умолчанию с предыдущим сообщением о фиксации. Внесите все необходимые изменения и закройте редактор. Если в качестве текстового редактора используется nano, вы можете закрыть его, нажав Ctrl + X , а затем клавиши Y и Enter

Сохранив новое сообщение о фиксации, отправьте его на Github с помощью команды:

git push --force origin

Готовы показать свою работу!

Поздравляем, вы освоили основы работы с популярным сайтом Github и инструментом командной строки git. Вы успешно создали репозиторий и теперь можете добавлять/удалять файлы, проталкивать коммиты, помечать релизы и клонировать репозитории

Если вы хотите изучить более продвинутые команды git, посетите сайт Advanced git Commands