Краткое руководство по использованию Github

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

Прежде чем мы начнем, важно отметить, что это руководство предполагает базовое понимание терминов, используемых в Git: push, pull, commit, repository и т. Д. Также требуется предварительная регистрация в GitHub.

Установка Github

В Debian / Ubuntu и производных:

sudo apt-get install git

En Fedora и производные:

sudo yum установить git

En Арка и производные:

судо пакман -S git

Начальная настройка Github

После успешного завершения установки следующим шагом будет настройка деталей конфигурации пользователя GitHub. Для этого используйте следующие команды, заменив «username» своим именем пользователя GitHub и «email_id» адресом электронной почты, который использовался для создания учетной записи GitHub.

git config --global user.name "username" git config --global user.email "email_id"

Создать локальный репозиторий

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

git инициировать мой тест

Эта команда создает папку MyTest. В свою очередь, подпапка .init делает MyTest локальным репозиторием Git.

Если репозиторий создан успешно, появится строка, подобная следующей:

Инициализированный пустой репозиторий Git в /home/tu_usuario/Mytest/.git/

Затем вам нужно перейти в папку MyTest:

компакт-диск Mytest

Создайте файл README для описания репозитория

Файл README обычно используется для описания того, что содержится в репозитории или о чем идет речь в проекте. Чтобы создать его, просто запустите:

gedit README

После того, как вы ввели описание репозитория, не забудьте сохранить изменения.

Добавление файлов репозитория в индекс

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

В нашем случае в нашем локальном репозитории уже есть новый файл: README. Поэтому мы собираемся создать еще один файл с простой программой на языке C и назовем его example.c. Его содержимое будет:

#include int main () {printf ("привет, мир"); возврат 0; }

Итак, теперь у нас есть 2 файла в нашем локальном репозитории: README и example.c.

Следующим шагом будет добавление этих файлов в индекс:

git добавить README git добавить smaple.c

Команду «git add» можно использовать для добавления любого количества файлов и папок в индекс. Чтобы добавить все изменения, без указания имени файлов, можно выполнить «git add». (с точкой в ​​конце).

Сохранить изменения, внесенные в индекс

После добавления всех файлов можно оставить запись об этих изменениях, выполнив то, что на жаргоне называется «фиксацией». Это означает, что добавление или изменение файлов завершено, и изменения можно загрузить в удаленный репозиторий Github. Для этого необходимо выполнить следующую команду:

git commit -m "сообщение"

«Сообщение» может быть любым сообщением, кратко описывающим рассматриваемые изменения, например: «Я добавил такую ​​функцию» или «Я исправил такую ​​вещь» и так далее.

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

Имя репозитория должно совпадать с именем репозитория в локальной системе. В данном случае это будет «MyTest». Для этого, прежде всего, вам необходимо авторизоваться в Github. Затем вам нужно нажать на знак плюса (+) в правом верхнем углу страницы и выбрать опцию «создать новый репозиторий». Наконец, вы должны заполнить данные и нажать кнопку «создать репозиторий».

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

git удаленное добавление источника https://github.com/user_name/Mytest.git

Отправка файлов из локального репозитория в репозиторий GitHub

Последний шаг - отправить содержимое локального репозитория в удаленный репозиторий с помощью команды:

git push origin master

Осталось только ввести учетные данные для входа (логин и пароль).

Это загрузит все содержимое папки MyTest (локальный репозиторий) в GitHub (внешний репозиторий). Для последующих проектов вам больше не нужно выполнять эти шаги с нуля. Вместо этого вы можете начать непосредственно с шага 3. Наконец, не забывайте, что изменения будут доступны на сайте Github.

Создание ветки

Когда разработчики хотят исправить ошибки или добавить новые функции, они часто создают ветвь или копию кода, чтобы можно было фиксировать отдельно, не затрагивая исходный проект. Затем, когда они будут выполнены, они могут объединить эту ветвь обратно в основную ветвь (мастер).

Есть два варианта создания новой ветки:

Длинный вариант:

git branch mirama # создать новую ветку с именем mirama git checkout mirama - переключиться на использование ветки mirama.

Краткий вариант:

git checkout -b mirama - создать и переключиться на использование ветки mirama

После внесения изменений добавьте их в индекс ветки и сделайте соответствующий коммит:

git add. git commit -m "изменяет мираму"

Затем вам нужно вернуться в основную ветку и принять изменения, сделанные в mirama:

git checkout master git merge mirama

Наконец, вам нужно удалить mirama (поскольку изменения были внесены в мастер):

git ветка -d мирама

И загрузите мастер в Github:

git push origin master

Создание производного репозитория Git (вилка)

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

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

Затем нам нужно клонировать репозиторий этого нового проекта на нашем компьютере. В качестве примера мы можем использовать мой репозиторий Ankifox, расширение для Firefox, которое позволяет добавлять слова в Анки, который доступен на Github:

клон git https://github.com/usemoslinux/Ankifox.git

Не забудьте заменить https://github.com/usemoslinux/Ankifox.git URL-адресом, соответствующим вашему проекту. Получить этот адрес очень просто, как показано на изображении ниже.

Эта команда создаст каталог под названием «Ankifox», инициализирует в нем каталог .git и загрузит все данные из этого репозитория для работы с последней версией.