Кароткае кіраўніцтва па выкарыстанні Github

Гэты падручнік - кароткае кіраўніцтва па ўсталёўцы і выкарыстанні GitHub. Вось як стварыць лакальны рэпазітар, як падключыць гэты лакальны рэпазітар да аддаленага рэпазітара Github (дзе яго могуць бачыць усе), як зафіксаваць змены і, нарэшце, як перанесці ўвесь змест з лакальнага рэпазітара на GitHub, сярод іншых распаўсюджаных задач. .

Перш чым пачаць, важна адзначыць, што гэты падручнік мяркуе базавае разуменне тэрмінаў, якія выкарыстоўваюцца ў Git: націск, выцягванне, фіксацыя, сховішча і г.д. Гэта таксама патрабуе папярэдняй рэгістрацыі ў GitHub.

Ўстаноўка Github

На Debian / Ubuntu і вытворных:

Sudo APT-атрымаць ўстаноўку мярзотнік

En Мяккая фетравы капялюш і вытворныя:

Sudo ням ўсталяваць гнюса

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 ЧЫТАЦЬ

Пасля ўводу апісання сховішча не забудзьцеся захаваць змены.

Даданне файлаў сховішча ў індэкс

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

У нашым выпадку наш лакальны рэпазітар ужо ўтрымлівае новы файл: README. Такім чынам, мы збіраемся стварыць яшчэ адзін файл з простай праграмай на C, які мы назавем 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

Не забудзьцеся замяніць "імя карыстальніка" і "MyTest" на адпаведныя імя карыстальніка і тэчку.

Націсніце файлы з лакальнага сховішча ў сховішча GitHub

Заключным этапам з'яўляецца перасоўванне змесціва лакальнага сховішча ў аддалены рэпазітар, выкарыстоўваючы каманду:

мярзотнік штуршок майстар паходжання

Застаецца толькі ўвесці ўліковыя дадзеныя для ўваходу (імя карыстальніка і пароль).

Гэта загрузіць усё змесціва папкі MyTest (лакальнае сховішча) у GitHub (знешняе сховішча). Для наступных праектаў вам больш не трэба выконваць гэтыя дзеянні з нуля. Замест гэтага вы можаце пачаць непасрэдна з кроку 3. Нарэшце, не забывайце, што змены будуць даступныя на сайце Github.

Стварэнне галіны

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

Ёсць два варыянты стварэння новай галіны:

Доўгі варыянт:

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

Кароткі варыянт:

git checkout -b mirama - стварыце і пераключыцеся на выкарыстанне галіны mirama

Пасля ўнясення змяненняў дадайце іх у індэкс галіны і зрабіце адпаведную фіксацыю:

git дадаць. git commit -m "змены ў mirama"

Затым вам трэба вярнуцца да асноўнай галіны і прыняць змены, унесеныя ў mirama:

git checkout master git merge mirama

Нарэшце, вы павінны выдаліць mirama (бо змены былі ўключаны ў master):

git галіна -d mirama

І загрузіце майстар у Github:

мярзотнік штуршок майстар паходжання

Стварэнне вытворнага сховішча Git (відэлец)

Дзякуючы Git і існаванню вялікіх публічных бібліятэк сховішчаў, такіх як Github, большую частку часу не трэба пачынаць праграмаваць наш праект з нуля. У гэтых выпадках можна ўзяць гэты базавы код для стварэння новага праекта.

Для гэтага першае, што трэба зрабіць, - гэта развілка існуючага сховішча, гэта значыць праект, атрыманы з яго на аснове кода зыходнага праекта. На Github гэта дасягаецца націскам адпаведнай кнопкі, як відаць на скрыншоце ніжэй.

Відэлец сховішча Github

Тады нам трэба кланаваць сховішча гэтага новага праекта на нашым кампутары. У якасці прыкладу мы можам выкарыстоўваць маё сховішча Ankifox, пашырэнне для Firefox, якое дазваляе дадаваць словы ў анкі, які даступны на Github:

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

Не забудзьцеся замяніць https://github.com/usemoslinux/Ankifox.git на URL, які адпавядае вашаму праекту. Атрымаць гэты адрас вельмі проста, як відаць на малюнку ніжэй.

Кланаванне сховішча Github

Гэтая каманда створыць каталог пад назвай «Ankifox», яна ініцыялізуе ў ім каталог .git і загрузіць усе дадзеныя з гэтага сховішча для працы з апошняй версіяй.


Змест артыкула адпавядае нашым прынцыпам рэдакцыйная этыка. Каб паведаміць пра памылку, націсніце тут.

22 каментарыяў, пакіньце свой

Пакіньце свой каментар

Ваш электронны адрас не будзе апублікаваны. Абавязковыя для запаўнення палі пазначаныя *

*

*

  1. Адказны за дадзеныя: Мігель Анхель Гатон
  2. Прызначэнне дадзеных: Кантроль спаму, кіраванне каментарыямі.
  3. Легітымнасць: ваша згода
  4. Перадача дадзеных: Дадзеныя не будуць перададзены трэцім асобам, за выключэннем юрыдычных абавязкаў.
  5. Захоўванне дадзеных: База дадзеных, размешчаная Occentus Networks (ЕС)
  6. Правы: у любы час вы можаце абмежаваць, аднавіць і выдаліць сваю інфармацыю.

  1.   Віктар Марцінес сказаў

    Проста нешта падобнае, што я шукаў, простае і практычнае кіраўніцтва, якое паэтапна растлумачыць усё.
    Для бібюкета, я думаю, гэта былі б амаль аднолькавыя крокі, так?

    1.    давайце выкарыстоўваць Linux сказаў

      Дакладна. Гэта вельмі падобна. Проста зменіце URL аддаленага хаста.
      Цікавае ў Bitbucket тое, што ён дае магчымасць ствараць прыватныя сховішчы (гэта значыць, ён не адкрыты для шырокай грамадскасці, а даступны толькі для пэўнай групы людзей). На Github гэта таксама магчыма, але трэба плаціць. З іншага боку, у Bitbucket няма.
      На ўра! Павел.

  2.   Джонатан Дыяс сказаў

    Вялікія сябры !!! З лепшых месцаў у Інтэрнэце, каб даведацца і даведацца,

    1.    давайце выкарыстоўваць Linux сказаў

      Калі вас цікавіць тэма, я рэкамендую вам зірнуць на падручнік, які ўдзельнік суполкі пра тое, як выкарыстоўваць Git + Google Code, які таксама вельмі цікавы і практычны:

      https://blog.desdelinux.net/iniciando-un-proyecto-con-git-y-google-code-parte-i/
      https://blog.desdelinux.net/iniciando-un-proyecto-con-git-y-google-code-parte-ii/
      https://blog.desdelinux.net/iniciando-un-proyecto-con-git-y-google-code-parte-iii/
      https://blog.desdelinux.net/iniciando-un-proyecto-con-git-y-google-code-parte-iv/

      На ўра! Павел.

  3.   Элаў сказаў

    Дзякуючы вам мне больш падабаецца Bitbucket .. у любым выпадку добры артыкул 😀

  4.   некс сказаў

    @usemoslinux Ці можаце вы стварыць "GitHub" для аўтаматычнай усталёўкі сістэмы FreeBSD?, амаль аўтаматычны ўсталёўшчык будзе вельмі карысны, як гэта робіць Arch, цікавы пост.

    PS: Кіраўніцтва GitHub для FreeBSD было б добра.

  5.   Язэп м. Фернандэс сказаў

    Дзякуй за кіраўніцтва. Я сачу за гэтым, і ў мяне была невялікая праблема, гэта не дазволіць мне загрузіць лакальны рэпазітар на аддалены. Гэта дае мне наступную памылку:

    [root @ iou Mytest] #git master origin origin
    памылка: Запытаны URL вярнуў памылку: 403 забаронены пры доступе https://github.com/miusuario/Mytest.git/info/refs

    Любыя ідэі?

    1.    давайце выкарыстоўваць Linux сказаў

      Магчыма, адбываецца тое, што URL аддаленага сховішча, які вы ўводзіце, няправільны. Гэта можа быць звязана з памылкай друку пры ўводзе URL-адраса, альбо вы на самой справе не стварылі сховішча на Github (праз іх вэб-старонку).

      Калі паведамленне пра памылку дакладна адпавядае паказанаму вамі, вам не хапае змены "myuser" для вашага імя карыстальніка.

      Увядзіце git remote -v, каб убачыць уведзеныя URL-адрасы. Каб змяніць яго, проста ўстаўце git remote set-url origin URLNEW

      Замена URLNEW на правільны URL.

      І, нарэшце, не забывайце, што URL улічвае рэгістр.

      На ўра! Павел.

  6.   Цеслы сказаў

    Дзіўна!

    Тлумачыцца так, што нават тыя, хто менш дасведчаны ў гэтым пытанні, як я, разумеюць гэта і могуць зрабіць першыя крокі ў git альбо Github. Цяпер мне зразумелыя многія тэрміны, такія як націск, цяга альбо фіксацыя.

    Дзякуй вам вялікае!

    1.    давайце выкарыстоўваць Linux сказаў

      Гэта была ідэя! Я рады!
      Абдымкі і дзякуй, што пакінулі свой каментарый! Павел.

  7.   Стацік сказаў

    Лагодны

    Пытанне, калі я выдаляю файлы, якія мне больш не патрэбныя ні ў лакальным, ні ў сховішчы Github

  8.   Стацік сказаў

    Я выпраўляю свае сумневы ў выдаленні каталогаў з поўнымі файламі

    каталог git rm -rf

    ці як ???

    1.    давайце выкарыстоўваць Linux сказаў

      Каб выдаліць файлы:
      git rm file1.txt

      Каб выдаліць каталогі (і іх змест):
      git rm -r мой каталог

  9.   Стацік сказаў

    Я выявіў, што гэта выглядае, выдатнае дзякуй

  10.   Віктар Мансіла сказаў

    І як мне выкарыстоўваць Gitlab?
    Прынамсі, у basicOS ён не можа скончыць канфігурацыю ...

  11.   Стацік сказаў

    Гэтая памылка з'яўляецца, калі я хачу зрабіць

    майстар паходжання git

    http://i.imgur.com/fy5Jxvs.png

    1.    давайце выкарыстоўваць Linux сказаў

      Як тлумачыцца на агульным скрыншоце, якім вы карыстаецеся, на серверы адбываюцца змены, якія не ўключаны ў версію, якая захоўваецца на вашым кампутары. У сваю чаргу, на вашым кампутары адбываюцца змены, якія адсутнічаюць на серверы (менавіта тыя, якія вы хочаце загрузіць). Адсюль і канфлікт.

      Паспрабуйце спачатку зрабіць git pull, як прапанавана на скрыншоце.

  12.   Хасэ сказаў

    Дзякуй за дапамогу, вельмі добрая інфармацыя, я выкарыстаю гэта на практыцы, яшчэ раз дзякуй

  13.   Алонса сказаў

    У раздзеле: "Перасоўванне файлаў з лакальнага сховішча ў сховішча GitHub"
    , вы можаце прачытаць:
    «Гэта загрузіць усё змесціва папкі MyTest (лакальнае сховішча) у GitHub (знешняе сховішча). Для наступных праектаў вам больш не трэба выконваць гэтыя дзеянні з нуля. Замест гэтага вы можаце пачаць непасрэдна з кроку 3. »

    Я пачынаю на гэтым з Git. Ці можаце вы сказаць мне, што такое "крок 3"?

    Больш за тое, каманды:
    git config –global user.name "імя карыстальніка"
    git config –global user.email "email_id"

    Ці трэба іх рабіць на кожнай сесіі Git?

    Аналагічна камандзе:
    git init "імя папкі"
    Ці трэба запускаць яго ў кожнай рабочай сесіі з Git ці адпаведным сховішчам, што адбываецца, калі ў мяне ёсць два ці больш сховішчы?

    Выдатныя падручнікі, віншаванні, падзякі і віншаванні.

  14.   Серхіа сказаў

    Я выдатна разумеў, вельмі дрэнна, што няма такога кліента графічнага інтэрфейсу, як Windows / Mac: /

  15.   Соня сказаў

    Я прыйшоў сюды, каб вырашыць праблему, якая ўзнікае з: fatal: Не з'яўляецца сховішчам git (альбо любым з бацькоўскіх каталогаў): .git Ці вырашана гэта кіраўніцтва ??? загадзя дзякуй 🙂

  16.   Аляксандр сказаў

    Імя карыстальніка для 'https://github.com': «royalAlexander»
    Пароль для 'https: // »royalAlexander» @ github.com':
    remote: Няправільнае імя карыстальніка або пароль.
    фатальна: Памылка аўтэнтыфікацыі для "https://github.com/royalSanity/Mytest.git/"

    дапамажы мне