Як загрузіць праект на Github пачаткоўцу

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

Такім чынам, у гэтым сэнсе як пачаткоўцы, так і эксперты часта аказваюцца ў пэўнай ступені разгубленымі. У гэтым артыкуле вы даведаецеся Мы раскажам вам, як гэта зрабіць, бо Ёсць некалькі варыянтаў або метадаўКалі вы хочаце зрабіць свой праект даступным для сумеснай працы або каб іншыя маглі лёгка праглядаць і спампоўваць яго, чытайце далей, каб даведацца ўсе падрабязнасці.

Што такое рэпазітар і чаму яго варта размяшчаць на GitHub?

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

Размясціць рэпазітар на GitHub Гэта мае некалькі пераваг:

• Кантроль версій: Вашы змены запісваюцца, і вы можаце адмяніць, праглядзець або падзяліцца любой часткай распрацоўкі.
• Рэзервовае капіраванне ў воблаку: вы пазбегнеце страты важнай інфармацыі ў выпадку любога мясцовага здарэння.
• Прафесійная бачнасць: Паколькі вашы працы публічныя, кожны можа іх убачыць, што паляпшае ваша партфоліо.
• Простае супрацоўніцтва: GitHub дазваляе іншым лёгка ўносіць свой уклад у ваш праект праз пул-рэксты, задачы або форкі.

Пачатак працы: папярэднія патрабаванні і падрыхтоўка асяроддзя

Перад загрузкай праекта на Github пераканайцеся, што на вашым кампутары ўсталявана наступнае:

• Уліковы запіс на GitHub. Абавязкова трэба ствараць рэпазіторыі на платформе.
• Git усталяваны. Гэта базавы інструмент кантролю версій, які дазваляе кіраваць зменамі. Вы можаце спампаваць і ўсталяваць яго з афіцыйны сайтУ сістэмах на базе Linux вы можаце выканаць усталёўку, выканаўшы каманду sudo apt-get install git на тэрмінале.
• Рэдактар ​​кода або IDE. Такія параметры, як Visual Studio Code (VSCode) спрашчаюць працэс. Калі вы хочаце скарыстацца прамой інтэграцыяй з GitHub з рэдактара, рэкамендуецца спампаваць адзін з гэтых інструментаў.

Пасля ўстаноўкі Гіт у вашай сістэме, першы крок - наладзіць яе з вашымі імя і адрас электроннай пошты (Гэтыя дадзеныя будуць выкарыстоўвацца для падпісання вашых камітаў.) У тэрмінале выканайце наступную каманду:

git config --global user.name "TuNombre"
git config --global user.email [email protected]

Гэтая канфігурацыя глабальны і вам трэба будзе зрабіць гэта толькі адзін раз у вашай камандзе.

Стварэнне рэпазітара на GitHub

Цяпер самы час стварыць прастору, дзе вы будзеце размяшчаць свой праект. Зрабіце гэта з вэб-інтэрфейсу GitHub, выканаўшы наступныя дзеянні:

1. Атрымайце доступ да свайго профілю ў GitHub.com і націсніце кнопку "Новы" каб стварыць новае сховішча.
2. Увядзіце імя патрэбны для рэпазітара і дадае апісанне коратка, але канкрэтна пра мэту праекта.
3. Выберыце, ці будзе рэпазітар дзяржаўны ці прыватныКалі вы хочаце, каб іншыя маглі праглядаць і ўдзельнічаць, выберыце «Публічна».
4. У вас ёсць магчымасць стварыць файл README.md аўтаматычна. Рэкамендуецца выкарыстоўваць гэты файл, бо гэта першае, што ўбачаць іншыя распрацоўшчыкі, калі атрымаюць доступ да рэпазітара.
5. Націсніце на "Стварыць рэпазітар" каб завяршыць працэс, і ваша сховішча будзе гатова прымаць файлы.

Падрыхтоўка лакальнага праекта да загрузкі на GitHub

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

cd tu-carpeta-del-proyecto

Цяпер ініцыялізуйце лакальны рэпазітар Git:

git init

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

 

Загрузка кода на GitHub: поўны працэс у тэрмінале

Пасля ініцыялізацыі лакальнага рэпазітара мы загрузім увесь кантэнт на GitHub, выканаўшы наступныя каманды:

1. Дадаць усе файлы ў прамежкавую вобласць з:

git add .

2. Зрабіць фіксацыю Каб запісаць першую кантрольную кропку:

git commit -m "Primer commit"

3. Злучыць лакальны рэпазітар з аддаленымЗамяняе NOMBRE_USUARIO y NOMBRE_REPOSITORIO паводле рэальных дадзеных:

git remote add origin https://github.com/NOMBRE_USUARIO/NOMBRE_REPOSITORIO.git

4. Загрузіць змены ў GitHub (філіял main o master па меры неабходнасці):

git push -u origin main

У некаторых старых рэпазіторыях або канфігурацыях галоўная галіна — гэта master замест mainКалі вы атрымліваеце памылкі, праверце назву галоўнай галіны і заменіце яе ў камандзе вышэй.

Як загрузіць праекты на Github з VSCode

Сучасныя рэдактары, такія як VSCode Яны маюць убудаваную інтэграцыю з Git і GitHub. Вось як гэта лёгка зрабіць:

• Адкрыйце тэчку праекта ў рэдактары («Файл → Адкрыць тэчку»).
• Доступ да панэлі Кантроль версій (кантроль зыходнага кода), размешчаны на бакавой панэлі.
• Націсніце «Ініцыялізаваць рэпазітар», калі вы яшчэ гэтага не зрабілі. Гэта эквівалентна камандзе git init.
• Пасля ініцыялізацыі вы ўбачыце кнопку «Апублікаваць на GitHub»Калі вы робіце гэта ўпершыню, вам трэба будзе аўтарызаваць злучэнне паміж VSCode і вашым уліковым запісам GitHub.
• Выберыце, ці апублікаваць рэпазітар як публічны, ці прыватны.
• Падрыхтуйце файлы для першага фіксавання, адзначыўшы змены і дадаўшы апісальнае паведамленне.
• Апублікуйце свой праект, і вы зможаце лёгка сінхранізаваць змены з рэдактара.

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

Загрузіце файлы ўручную з сайта GitHub

Іншы альтэрнатыўны варыянт, асабліва для невялікіх праектаў, — гэта загрузка файлаў уручную праз вэб-інтэрфейс:

1. Увайдзіце ў нядаўна створаны рэпазітар на GitHub.
2. Націсніце на выпадальнае меню «Дадаць файл» і выберыце Загрузіць файлы.
3. Перацягніце файлы або тэчкі з кампутара ў акно браўзера.
4. Унізе дадайце паведамленне пацверджання і націсніце на Зафіксаваць змены каб загрузіць файлы.

Гэты метад менш эфектыўны для праектаў, якія знаходзяцца ў актыўнай распрацоўцы, але карысны для дадання пэўных файлаў, дакументацыі і іншых элементаў.

Пашыранае кіраванне і найлепшыя практыкі працы з GitHub

Загрузка праекта — гэта толькі пачатак. Каб атрымаць максімальную аддачу ад GitHub і падтрымліваць прафесійную арганізацыю, мы рэкамендуем прытрымлівацца гэтых дадатковых рэкамендацый:

• Абнаўляйце README.md. Гэта суправаджальны ліст да вашага праекта. У ім тлумачыцца яго мэта, спосабы ўсталёўкі, спосабы выкарыстання і ўсе адпаведныя дэталі. Вы можаце рэдагаваць яго непасрэдна ў інтэрнэце або ў рэдактары, выкарыстоўваючы сінтаксіс Markdown.
• Стварыце рабочыя галіны. Не рабіце ўсе змены ў "main" або "master". Выкарыстоўвайце асобныя галіны для новых функцый або выпраўленняў. Пазней вы можаце аб'яднаць іх з дапамогай pull requests.
• Загрузіць файлы .gitignore каб пазбегнуць сумеснага выкарыстання канфідэнцыйных або аўтаматычна згенераваных дадзеных, такіх як тэчкі node_modules, часовыя файлы або лакальныя файлы канфігурацыі.
• Перыядычна сінхранізуйце лакальныя і аддаленыя рэпазіторыі. Выкарыстанне git pull каб падтрымліваць вашу лакальную копію ў актуальным стане з улікам любых змяненняў, якія маглі быць унесены ўдзельнікамі.
• Акуратна кіруйце пультамі. Калі вы калі-небудзь зменіце крыніцу дыстанцыйнага кіравання, выкарыстоўвайце git remote -v праглядзець звязаныя сховішчы і git remote remove origin каб выдаліць іх пры неабходнасці.

Кланаванне і сумесная праца над праектамі: наступны крок

Пасля таго, як ваша сховішча апынецца ў воблаку, вы можаце кланаваць яго на любы іншы кампутар, выкарыстоўваючы:

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git

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

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git .

Супрацоўніцтва з іншымі карыстальнікамі на GitHub — гэта вывучэнне працэсу галінаванняў, пул-рэквестаў і аглядаў кода. Такім чынам, вы зможаце прымаць знешнія ўклады і працаваць у камандзе арганізавана і эфектыўна.

Тыповыя памылкі і як іх выправіць

Пры загрузцы праекта вы можаце сутыкнуцца з некаторымі распаўсюджанымі праблемамі. Вось найбольш распаўсюджаныя з іх і спосабы іх вырашэння:

• Спроба адправіць у пусты рэпазітар без галоўнай галіны- Калі аддалены рэпазітар быў створаны без README.md і галіна ніколі не была адпраўлена, пераканайцеся, што першая галіна адпраўлена з правільнай назвай, звычайна "main" або "master".
• Канфлікты сінхранізацыіКалі адбываюцца адначасовыя змены лакальна і дыстанцыйна, спачатку вырашыце іх, выканаўшы git pull і вырашэнне канфліктаў перад тым, як рабіць git push зноў.
• Недастаткова дазволаўПераканайцеся, што ў вас ёсць правільныя ўліковыя дадзеныя, і праверце правільнасць напісання аддаленага URL-адраса (https або ssh, у залежнасці ад сітуацыі).
• Забыццё дадаць важныя файлыПраглядзіце і абнавіце свой файл .gitignore каб не прапусціць ключавыя файлы і выпадкова не загрузіць асабістую інфармацыю.

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