Короткий посібник з використання Github

Цей підручник - це короткий посібник із встановлення та використання GitHub. Ось як створити локальне сховище, як підключити це локальне сховище до віддаленого сховища Github (де його можуть бачити всі), як внести зміни та, нарешті, як перенести весь вміст локального сховища на GitHub, серед інших поширених завдань. .

Перш ніж розпочати, важливо зазначити, що цей посібник передбачає базове розуміння термінів, що використовуються в Git: push, pull, commit, repository тощо. Це також вимагає попередньої реєстрації в GitHub.

Встановлення Github

На Debian / Ubuntu та похідних:

sudo apt-get install git

En Fedora та похідні:

sudo yum install git

En арка та похідні:

sudo pacman -S git

Початкове налаштування Github

Після успішного завершення інсталяції наступним кроком є ​​налаштування деталей конфігурації користувача GitHub. Для цього використовуйте наступні команди, замінюючи «ім’я користувача» вашим іменем користувача GitHub, а «email_id» адресою електронної пошти, яка використовується для створення облікового запису GitHub.

git config --global user.name "ім'я користувача" git config --global user.email "email_id"

Створіть локальне сховище

Перше, що потрібно створити на комп’ютері папку, яка буде виконувати функції локального сховища. Для цього просто запустіть таку команду:

git init Mytest

Ця команда створює папку MyTest. У свою чергу, підпапка .init робить MyTest визнаним локальним сховищем Git.

Якщо репозиторій створено успішно, з’явиться рядок, подібний до наступного:

Ініціалізоване порожнє сховище Git у /home/tu_usuario/Mytest/.git/

Потім вам потрібно перейти до папки MyTest:

CD Mytest

Створіть файл README для опису сховища

Файл README зазвичай використовується для опису того, що містить сховище або про що йдеться у проекті. Щоб створити його, просто запустіть:

gedit README

Ввівши опис сховища, не забудьте зберегти зміни.

Додавання файлів сховища до індексу

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

У нашому випадку наш локальний репозиторій уже містить новий файл: README. Тому ми збираємося створити ще один файл із простою програмою на С, який ми будемо називати example.c. Його вміст буде:

#include int main () {printf ("привіт світ"); повернути 0; }

Отже, зараз у нашому локальному сховищі є 2 файли: README та example.c.

Наступним кроком є ​​додавання цих файлів до індексу:

git add README git add 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 master майстер

Залишається лише ввести облікові дані для входу (ім’я користувача та пароль).

Це завантажить весь вміст папки MyTest (локальне сховище) до GitHub (зовнішнє сховище). Для подальших проектів більше не потрібно виконувати ці дії з нуля. Натомість ви можете розпочати з кроку 3 безпосередньо. Нарешті, не забувайте, що зміни будуть доступні на веб-сайті Github.

Створення гілки

Коли розробники хочуть виправити помилки або додати нові функції, вони часто створюють гілку або копію коду, щоб вони могли робити коміти окремо, не впливаючи на оригінальний проект. Потім, коли вони закінчать, вони можуть об'єднати цю гілку назад в основну гілку (master).

Існує два варіанти створення нової гілки:

Довгий варіант:

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

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

git checkout -b mirama - створіть і перейдіть до використання гілки mirama

Після внесення змін додайте їх до індексу гілки та зробіть відповідне комітування:

git add. git commit -m "зміни до mirama"

Потім вам потрібно повернутися до основної гілки та взяти зміни, внесені в mirama:

git checkout master git merge mirama - -

Нарешті, ви повинні видалити mirama (оскільки зміни були включені в master):

git гілка -d mirama

І завантажте майстер на Github:

git push master майстер

Створення похідного сховища Git (fork)

Завдяки Git та існуванню великих публічних бібліотек сховищ, таких як Github, більшу частину часу не потрібно починати програмувати наш проект з нуля. У цих випадках можна взяти цей базовий код для створення нового проекту.

Для цього першим ділом є розгалуження існуючого сховища, тобто похідного від нього проекту на основі коду вихідного проекту. На Github це досягається натисканням відповідної кнопки, як показано на скріншоті нижче.

Тоді нам потрібно клонувати сховище цього нового проекту на нашому комп’ютері. Як приклад, ми можемо використати моє сховище Ankifox, розширення для Firefox, яке дозволяє додавати слова до Анки, який доступний на Github:

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

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

Ця команда створить каталог під назвою «Ankifox», ініціалізує в ньому каталог .git і завантажить усі дані з цього сховища для роботи з останньою версією.