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

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

В этом руководстве мы рассмотрим, как создать репозиторий Github, push-коммиты, выпуски тегов и многое другое.

Создать репозиторий

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

Вы увидите экран создания репозитория:

Имя и описание репозитория могут быть любыми, и в этом примере в качестве имени использовалось "muo_demo". Оставьте остальные поля как есть / пустыми и нажмите кнопку « Создать новый репозиторий» . Вы попадете на страницу с вашим новым пустым репозиторием.

Инициировать локальный репозиторий

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

 mkdir myrepo

 cd myrepo

 echo "# My Test Repository" > Readme.md

 echo "A temporary file" > temp.txt

При просмотре репозитория на Github содержимое файла Readme.md всегда отображается для описания репозитория или как первая страница руководства. Расширение файла .md означает формат уценки, и если вы не знакомы с 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 в браузере, вы увидите два файла вместе с заголовком «Мой тестовый репозиторий» в файле 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. Вот и все!

Пометка релизов

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

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

 git tag 1.0.0

 git push --tags

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

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

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

 git clone https://github.com/mdizak/muo_demo.git myrepo

 cd myrepo

 git init

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

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

Просмотр истории фиксации

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

 git log - 3

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

Изменить сообщение фиксации

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

 git commit --amend

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

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

 git push --force origin

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

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

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