интересен

Как по дяволите използвам GitHub?

Уважаеми Goldavelez.com,

Научих се да кодирам и искам да започна да използвам GitHub за управление на проектите си. Въпреки уводния урок, който те предоставят, все още не разбирам как работи изобщо. Можеш ли да ми помогнеш?

На Ваше разположение,

Помощ за Git

Уважаеми 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, изтеглете го и го инсталирайте. Ако сте на OS 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" и е необходима при изпълнение на задача, която изисква root достъп. Командата 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 and Terminal. Това е просто стенограма, така че не е нужно да го въвеждате всичко (което би приличало повече / Потребители / име на вашето име /). Сега, когато вашето хранилище е готово, въведете това:

git init

Ако вече имате готово хранилище, просто трябва да прехвърлите в тази директория и след това да git init командата git init . Така или иначе, вашето местно хранилище е готово за работа и можете да започнете да кодирате код. Но чакайте, нямате какво да ангажирате! Изпълнете тази команда, за да създадете README файл:

touch README

Нека да си починем за секунда и да видим какво точно се е случило. Отидете в домашната папка на вашия компютър и погледнете папката Hello-World (или погледнете папката, която използвате за локално хранилище). Ще забележите README файл вътре, благодарение на командата, която току-що изпълнихте. Това, което няма да видите, е .git папка, но това е, защото е невидимо. Git го скрива там, но понеже сте git init командата git init, знаете, че тя съществува. Ако сте скептично настроен, просто изпълнете ls в Git Bash / Terminal, за да се покаже списък на всичко в текущата директория (която, ако следвате заедно, е вашето локално хранилище).

И така, как git знае, че искаме да ангажираме този файл README, който току-що създадохме? Не е така и трябва да го кажете. Тази команда ще направи трика:

git add README

Ако искате да добавите други файлове за ангажиране, ще използвате същата команда, но заменете README с името на друг файл. Сега изпълнете тази команда, за да я извършите:

git commit -m 'first commit'

Докато другите команди бяха доста ясни, командата за изпълнение има още малко, така че нека да я разбием. Когато въведете git, това просто казва на командния ред, че искате да използвате програмата git. Когато въвеждате команда, казвате на git, че искате да използвате командата команда. Всичко, което следва тези две неща, се счита за опции. Първото, е това, което е известно като знаме. Флаг указва, че искате да направите нещо специално, а не просто да изпълнявате командата за извършване. В този случай флагът -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