цікаво

Як чорт я можу використовувати GitHub?

Шановний Goldavelez.com,

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

З повагою,

Git Help

Шановний GH,

GitHub - чудовий інструмент, але він, безумовно, трохи плутає перший раз (і, можливо, кілька разів після цього). Ось, швидше за все, GitHub створив програмне забезпечення (для OS X і Windows), щоб зробити процес трохи простішим. Тим не менш, добре вивчити старомодний спосіб, інакше ваші параметри спрощеного програмного забезпечення не матимуть сенсу. Почнемо з прогулянки по азам.

Крок перший: Підпишіться на GitHub

Ось легка частина: зробіть собі обліковий запис GitHub на першій сторінці. Після заповнення форми GitHub ввійде до вас та переведе вас до вашої порожньої стрічки новин. У середині сторінки ви побачите завантажувальний табір (на фото справа). Ми переглянемо його, щоб створити ваш обліковий запис, а пізніше створити ваше перше сховище. Натисніть "Налаштувати Git", щоб розпочати роботу.

Крок другий: Встановіть Git

GitHub існує завдяки застосуванню для керування версіями під назвою git . Сайт заснований на тому, як працює git, а git досить старий. Він працює через командний рядок і не має фантазійного графічного інтерфейсу користувача. Оскільки він створений для управління написаним кодом, це не повинно звучати занадто страшно. (Звичайно, як уже згадувалося, GitHub зробив чудове програмне забезпечення, яке дозволило вам використовувати їх сервіс без командного рядка, але це не допоможе вам надто, якщо ви не знаєте основ.)

Git працює, читаючи локальне сховище коду (лише папку, що містить код для вашого проекту) на вашому комп’ютері та дзеркально відображає цей код в іншому місці (у цьому випадку на серверах GitHub). Спочатку ми зв'язаємо (тобто надішлемо) весь ваш локальний сховище до GitHub, але це лише разова справа. Поки ви продовжуєте працювати над своїм кодом, ви просто будете вносити зміни. Потім GitHub буде відслідковувати внесені вами зміни, створюючи різні версії файлів, щоб ви могли повернути їх до старих, якщо хочете (або просто відстежувати ці зміни з інших причин). Це головним чином, чому ви хочете використовувати систему контролю версій, як git самостійно, але додаткові переваги при використанні git для управління кодом з іншими людьми, які працюють над вашим проектом. Коли кілька розробників вводять код з git, GitHub стає центральним сховищем, де весь код, над яким працюють усі, може синхронізуватися. Ви внесете свої зміни, а інші розробники перетягнуть їх (тобто синхронізуйте їх до їх локального сховища). Ви зробите те саме з їх кодом.

У Git все це відбувається, тому вам потрібно завантажити останню версію та встановити її. В OS X ви просто встановите додаток командного рядка. У Windows ви отримаєте ще кілька предметів. Ми обговоримо, як вони працюють на наступному кроці.

Крок третій: Налаштування Git

Щоб налаштувати git, вам потрібно пробратися в командний рядок. У OS X це означає запуск програми Terminal (Жорсткий диск -> Програми -> Утиліти -> Термінал), а в Windows - запуск запущеного вами програми Git Bash - командного рядка Windows. Коли ви будете готові, скажіть git своє ім’я так:

git config --global user.name "Your Name Here"

Наприклад, моє виглядатиме так, тому що я використовую тестовий рахунок для цього прикладу:

git config --global user.name "Adam Dachis"

Ви можете ввести будь-яке ім’я, яке вам подобається, але після цього вам потрібно буде ввести свою електронну пошту, і це повідомлення електронної пошти, яке ви використовували під час реєстрації в GitHub:

git config --global user.email " "

Якщо з будь-якої причини ви зареєструвалися в GitHub з неправильною електронною адресою, вам потрібно буде змінити її.

Тепер, щоб не завжди вводити свої дані для входу та генерувати SSH-ключі, ви захочете встановити помічник, щоб він керував вашими паролями. Якщо у вас є Windows, завантажте його та встановіть. Якщо ви перебуваєте в ОС X, вам потрібно буде це впоратися через термінал. Для початку скористайтеся цією командою для завантаження довідки даних:

curl -s -O \

//github-media-downloads.s3.amazonaws.com/osx/git-credential-osxkeychain

Це завантажить маленький маленький файл і не повинно займати багато часу. Закінчивши, введіть таку команду, щоб переконатися в правильності дозволів у файлі, який ви тільки що завантажили (і виправте їх, якщо ні):

chmod u+x git-credential-osxkeychain

Тепер настав час встановити довідку щодо ввірених даних у ту саму папку, де ви встановлюєте git. Для цього введіть цю команду:

sudo mv git-credential-osxkeychain `dirname \`which git\``

Вам буде запропоновано ввести пароль адміністратора, оскільки вищевказана команда починалася з sudo. Sudo - це скорочення для "super user do", і воно необхідне при виконанні завдання, яке вимагає кореневого доступу. Команда sudo дозволяє на мить стати користувачем root (користувачем, що має дозвіл робити майже все) у вашій операційній системі, щоб ви могли виконати це завдання. Вам пропонується ввести свій пароль, щоб довести, що ви адміністратор на комп’ютері, і вам слід дозволити це робити. Після введення пароля та переміщення помічника довірених даних, закінчіть встановлення цією командою:

git config --global credential.helper osxkeychain

Тепер ви все готові і можете перейти до фактичного використання git та GitHub!

Крок четвертий: Створіть свій перший сховище

Тепер, коли ви зробили це так далеко, ви можете фактично використовувати GitHub! Як перший порядок ведення бізнесу, ми збираємось створити сховище (або коротко "repo"). Перейдіть до GitHub і натисніть кнопку "Новий сховище" у верхньому правому куті сторінки вашого акаунта. (Примітка. Якщо ви все ще показуєте завантажувальний розділ GitHub, він відображатиметься під ним.)

Створюючи сховище, ви маєте вирішити кілька речей, включаючи його ім’я та чи буде воно загальнодоступним чи ні. Вибір імені повинен бути досить простим, оскільки ви, ймовірно, вже маєте ім’я для свого проекту. Якщо ви просто стежите за навчальними цілями, використовуйте "Hello-World". Чому "Hello-World", а не "Hello World"? Тому що пробіли та спеціальні символи спричинять проблеми. Нехай це буде просто та легко вводити в командному рядку. Якщо ви хочете включити більш складне ім'я, ви можете додати його до необов'язкового поля опису під полем імені.

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

Коли все закінчиться, ви можете натиснути кнопку «Створити сховище», але, можливо, спочатку потрібно зробити ще одне: встановіть прапорець «Ініціалізувати це сховище за допомогою README». Чому? У всіх сховищах потрібен файл README. В ідеалі цей файл містив би трохи інформації про ваш проект, але ви, можливо, не хочете займатися цим зараз. Ініціалізуючи сховище README, ви отримаєте порожній файл README, з яким ви можете просто працювати пізніше. Для цілей цього підручника ми залишимо поле, тому що в наступному розділі ми збираємося створити файл README з нуля, щоб практикувати вчинення (відправлення) його на GitHub.

Крок п'ятий: зробіть свій перший вчинок

Коли ви надсилаєте файли в GitHub, ви їх. Для практики ми збираємося ініціалізувати ваше локальне сховище та створити файл README, який потрібно виконати як практику. Перш ніж почати, потрібно знати, де знаходиться ваше місцеве сховище коду на вашому комп’ютері та як отримати доступ до нього за допомогою командного рядка. У цьому підручнику ми будемо припускати, що в домашній папці вашого комп’ютера є каталог під назвою "Hello-World". Якщо вам потрібно створити її, просто запустіть цю команду (те саме для Git Bash на терміналі Windows та OS X):

mkdir ~/Hello-World

Тепер перейдіть до цього каталогу за допомогою команди cd (змінити каталог):

cd ~/Hello-World

У випадку, якщо вам було цікаво, ~ представляє ваш домашній каталог у Git Bash та Terminal. Це просто скорочення, тому вам не доведеться вводити все це (що буде більше схоже на / Users / yourusername /). Тепер, коли ваше сховище готове, введіть це:

git init

Якщо у вас вже було готове сховище, вам просто потрібно буде перейти до цього каталогу, а потім замість нього запустити команду git init . У будь-якому випадку ваш локальний сховище готовий до роботи, і ви можете почати введення коду. Але зачекайте, вам нічого не потрібно робити! Запустіть цю команду, щоб створити файл README:

touch README

Давайте зробимо перерву на секунду і подивимося, що щойно сталося. Зайдіть у домашню папку свого комп’ютера і подивіться папку Hello-World (або подивіться, яку папку ви використовуєте для локального сховища). Ви помітите файл README всередині, завдяки команді, яку ви тільки що виконали. Те, що ви не побачите, - це папка .git, але це тому, що вона невидима. Git приховує його там, але оскільки ви запустили команду git init ви знаєте, що вона існує. Якщо ви скептично налаштовані, просто запустіть команду ls в Git Bash / Terminal, щоб відобразити список усього в поточному каталозі (який, якщо ви будете слідувати далі, є вашим локальним сховищем).

Тож як git знає, що ми хочемо зробити цей файл README, який ми тільки що створили? Це не так, і ви повинні це сказати. Ця команда виконає трюк:

git add README

Якщо ви хочете додати інші файли для фіксації, ви будете використовувати ту ж команду, але замініть README на ім'я іншого файлу. Тепер запустіть цю команду, щоб виконати її:

git commit -m 'first commit'

Хоча інші команди були досить прості, команда команд виконує ще трохи, тому давайте розбимо її. Коли ви вводите git, це просто говорить командному рядку, що ви хочете використовувати програму git. Коли ви вводите команду, ви говорите git, що хочете скористатися командою commit. Все, що відповідає цим двом, вважається варіантами. По-перше, це те, що відомо як прапор. Прапор вказує, що ви хочете зробити щось особливе, а не просто запустити команду введення. У цьому випадку прапор -m означає "повідомлення", а далі - повідомлення вашого фіксації (у прикладі "перша фіксація"). Повідомлення не є абсолютно необхідним (хоча, як правило, потрібно надати його), а просто посилання, яке допоможе вам розрізнити різні версії файлу (або файлів), які ви надаєте для вашого сховища.

Ваше перше зобов’язання повинне пройти за секунду, оскільки ви ще нічого не завантажили. Щоб отримати цей порожній файл README в GitHub, вам потрібно натиснути його з парою команд. Ось перший:

git remote add origin //github.com/yourusername/Hello-World.git

Вам потрібно замінити "yourusername" на - ви здогадалися - своїм ім'ям користувача GitHub. Для мене це виглядатиме так:

git remote add origin //github.com/gittest1040/Hello-World.git

Ця команда повідомляє git куди надсилати ваше сховище Hello-World. Тепер все, що вам потрібно зробити, це надіслати його:

git push origin master

Після запуску цієї команди все (в даному випадку лише ваш файл README) зробить шлях до GitHub. Вітаємо вас з першим зобов’язанням!

Дізнатися більше

Використання GitHub вимагає більше, ніж просто створення файлу README, але ці основи повинні добре зрозуміти, як взаємодіяти з додатком git та сервісом. Тепер, коли ви знаєте, як GitHub працює в своїй основі, ви можете використовувати додатки GitHub для керування кодом, якщо ви хочете. Якщо ви хочете дізнатися більше про GitHub, є кілька чудових навчальних посібників. Для початку подивіться, як роздрібнити сховище та посібник з GitHub LockerGnome.

Приємно керуючи своїм кодом!

Любов,

Goldavelez.com