Paano mag-upload ng isang proyekto sa Github bilang isang baguhan

Alam ng sinumang developer o propesyonal na naka-link sa teknolohikal na mundo kung ano ito GitHubGayunpaman, hindi lahat ay nakakabisa sa proseso ng mag-upload ng proyekto sa Github at samantalahin nang husto ang potensyal ng kontrol sa bersyon, pakikipagtulungan ng koponan, at propesyonal na visibility na inaalok ng platform na ito.

Kaya, sa ganitong diwa, ang parehong mga nagsisimula at eksperto ay madalas na naliligaw sa kanilang sarili. Sa artikulong ito, matututunan mo Sinasabi namin sa iyo kung paano ito gagawin, dahil Mayroong ilang mga opsyon o pamamaraanKung gusto mong gawing available ang iyong proyekto para sa pakikipagtulungan o para madaling makita at ma-download ng iba, magbasa para matutunan ang lahat ng detalye.

Ano ang isang repositoryo at bakit ito i-host sa GitHub?

Un imbakan Ito ang virtual na espasyo kung saan naka-imbak ang mga file at folder ng iyong proyekto, kasama ang kasaysayan ng mga pagbabagong nangyayari sa kanila habang sumusulong ka sa kanilang pag-unlad. Ang kasaysayang ito ay nagpapahintulot Pamahalaan ang mga bersyon, bumalik sa mga nakaraang estado, makipagtulungan sa iba, at panatilihin ang isang malinaw na talaan ng iyong pag-unlad sa trabaho..

Mag-host ng repository sa GitHub Mayroon itong maraming bentahe:

• Kontrol ng bersyon: Ang iyong mga pagbabago ay naitala at maaari mong i-undo, suriin, o ibahagi ang anumang bahagi ng pag-unlad.
• Pag-backup sa ulap: maiiwasan mong mawalan ng mahalagang impormasyon sa kaganapan ng anumang lokal na insidente.
• Propesyonal na kakayahang makita: Bilang pampubliko, makikita ng sinuman ang iyong gawa, na nagpapahusay sa iyong portfolio.
• Simpleng pakikipagtulungan: Pinapadali ng GitHub para sa iba na mag-ambag sa iyong proyekto sa pamamagitan ng mga pull request, isyu, o fork.

Pagsisimula: Mga Kinakailangan at Paghahanda sa Kapaligiran

Bago mag-upload ng proyekto sa Github, tiyaking naka-install ang sumusunod sa iyong computer:

• Account sa GitHub. Mahalagang lumikha ng mga repositoryo sa platform.
• Naka-install na ang Git. Ito ang pangunahing tool sa pagkontrol ng bersyon na nagbibigay-daan sa iyong pamahalaan ang mga pagbabago. Maaari mong i-download at i-install ito mula sa opisyal na website. Sa mga system na nakabatay sa Linux, maaari mong isagawa ang pag-install sa pamamagitan ng pagpapatakbo ng command sudo apt-get install git sa terminal.
• Code editor o IDE. Mga opsyon tulad ng Visual Studio Code (VSCode) gawing mas madali ang proseso. Kung gusto mong samantalahin ang direktang pagsasama sa GitHub mula sa editor, inirerekomendang mag-download ng isa sa mga tool na ito.

Kapag na-install na Git sa iyong system, ang unang hakbang ay i-configure ito sa iyong pangalan at email (Gagamitin ang data na ito para lagdaan ang iyong mga commit.) Mula sa terminal, patakbuhin ang sumusunod:

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

Ang konpigurasyong ito ay pandaigdigan at isang beses mo lang ito gagawin sa iyong team.

Paglikha ng repositoryo sa GitHub

Ngayon ay oras na upang lumikha ng espasyo kung saan mo iho-host ang iyong proyekto. Gawin ito mula sa GitHub web interface sa pamamagitan ng pagsunod sa mga hakbang na ito:

1. I-access ang iyong profile sa GitHub.com at pindutin ang buton "Bago" para gumawa ng bagong repository.
2. Ipasok ang pangalan ninanais para sa imbakan at nagdaragdag ng a paglalarawan maikli ngunit konkreto tungkol sa layunin ng proyekto.
3. Piliin kung ang repository ay magiging pampubliko o pribadoKung gusto mong makita at makilahok ng iba, piliin ang pampubliko.
4. Mayroon kang pagpipilian upang lumikha ng isang file README.md awtomatiko. Inirerekomenda ang file na ito, dahil ito ang unang makikita ng ibang mga developer kapag na-access nila ang repositoryo.
5. Mag-click sa "Gumawa ng imbakan" upang makumpleto ang proseso at ang iyong imbakan ay magiging handa na tumanggap ng mga file.

Inihahanda ang iyong lokal na proyekto para sa pag-upload sa GitHub

Sa paggawa ng iyong repository, ang susunod na hakbang upang mag-upload ng proyekto sa GitHub ay ihanda ang folder ng iyong proyekto sa iyong computer. Upang gawin ito, sundin ang mga tagubiling ito sa terminal, unang hanapin ang tamang landas gamit ang cd:

cd tu-carpeta-del-proyecto

Ngayon simulan ang lokal na Git repository:

git init

Ito ay lilikha ng isang nakatagong folder na tinatawag na .git na nag-iimbak ng kasaysayan ng bersyon at iba pang mga panloob na file.

 

Pag-upload ng code sa GitHub: ang kumpletong proseso sa terminal

Kapag nasimulan na ang lokal na repositoryo, ia-upload namin ang lahat ng nilalaman sa GitHub sa pamamagitan ng pagpapatakbo ng mga command na ito:

1. Idagdag ang lahat ng mga file sa lugar ng pagtatanghal ng dula kasama ang:

git add .

2. Gumawa ng isang pangako Upang itala ang unang checkpoint:

git commit -m "Primer commit"

3. I-link ang lokal na repositoryo sa remote. Pinapalitan NOMBRE_USUARIO y NOMBRE_REPOSITORIO sa pamamagitan ng totoong data:

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

4. Mag-upload ng mga pagbabago sa GitHub (sangay main o master ayon sa naaangkop):

git push -u origin main

Sa ilang mas lumang mga repositoryo o configuration, ang pangunahing sangay ay master sa halip na mainKung magkakaroon ka ng mga error, suriin ang pangalan ng pangunahing sangay at palitan ito sa command sa itaas.

Paano mag-upload ng mga proyekto sa Github mula sa VSCode

Mga modernong editor tulad ng VSCode Nagtatampok ang mga ito ng katutubong pagsasama sa Git at GitHub. Narito kung paano ito madaling gawin:

• Buksan ang iyong folder ng proyekto sa editor ("File → Open Folder").
• I-access ang panel Kontrol ng Pinagmulan (kontrol ng source code) na matatagpuan sa sidebar.
• I-click ang "Initialize repository" kung hindi mo pa nagagawa. Ito ay katumbas ng utos git init.
• Sa sandaling masimulan, makakakita ka ng isang pindutan sa "I-publish sa GitHub"Kung ito ang iyong unang pagkakataon, kakailanganin mong pahintulutan ang koneksyon sa pagitan ng VSCode at ng iyong GitHub account.
• Piliin na i-publish ang repository bilang pampubliko o pribado.
• Ihanda ang mga file para sa unang commit sa pamamagitan ng pagmamarka sa mga pagbabago at pagdaragdag ng isang mapaglarawang mensahe.
• I-publish ang iyong proyekto at madali mong mai-sync ang mga pagbabago mula sa editor.

Ang opsyon na ito ay perpekto para sa mga mas gustong manatili sa loob ng development environment at ginagawang mas madali ang pang-araw-araw na pamamahala ng proyekto.

Manu-manong mag-upload ng mga file mula sa website ng GitHub

Ang isa pang alternatibo, lalo na para sa maliliit na proyekto, ay ang manu-manong pag-upload ng mga file mula sa web interface:

1. Ilagay ang bagong likhang repositoryo sa GitHub.
2. I-click ang drop-down menu "Magdagdag ng file" at piliin Mag-upload ng mga file.
3. I-drag at i-drop ang mga file o folder mula sa iyong computer patungo sa browser window.
4. Sa ibaba, magdagdag ng mensahe ng kumpirmasyon at mag-click sa Gumawa ng mga pagbabago upang i-upload ang mga file.

Ang pamamaraang ito ay hindi gaanong mahusay para sa mga proyekto sa aktibong pagbuo, ngunit kapaki-pakinabang para sa pagdaragdag ng mga partikular na file, dokumentasyon, at iba pang mga item.

Advanced na pamamahala at pinakamahusay na kagawian kapag nagtatrabaho sa GitHub

Ang pag-upload ng proyekto ay simula pa lamang. Upang masulit ang GitHub at mapanatili ang isang propesyonal na organisasyon, inirerekomenda naming sundin ang mga karagdagang pinakamahusay na kagawian na ito:

• Panatilihing napapanahon ang README.md. Ito ang cover letter ng iyong proyekto. Ipinapaliwanag nito ang layunin nito, kung paano i-install ito, kung paano ito gamitin, at anumang nauugnay na mga detalye. Maaari mo itong i-edit nang direkta online o mula sa iyong editor gamit ang Markdown syntax.
• Lumikha ng mga sangay ng trabaho. Huwag gawin ang lahat ng iyong pagbabago sa "pangunahing" o "master." Gumamit ng hiwalay na mga sangay para sa mga bagong feature o pag-aayos. Maaari mong pagsamahin ang mga ito sa ibang pagkakataon gamit ang mga pull request.
• Mag-upload ng mga .gitignore na file upang maiwasan ang pagbabahagi ng sensitibo o awtomatikong nabuong data, gaya ng mga folder ng node_modules, pansamantalang file, o lokal na configuration file.
• Pana-panahong i-synchronize ang iyong mga lokal at malalayong repositoryo. Gamitin git pull upang panatilihing napapanahon ang iyong lokal na kopya sa anumang mga pagbabago na maaaring ginawa ng mga nag-aambag.
• Maingat na pamahalaan ang mga remote. Kung sakaling baguhin mo ang malayong pinagmulan, gamitin git remote -v upang suriin ang nauugnay na mga imbakan at git remote remove origin upang alisin ang mga ito kung kinakailangan.

I-clone at makipagtulungan sa mga proyekto: ang susunod na hakbang

Kapag nasa cloud na ang iyong repository, maaari mo itong i-clone sa anumang computer gamit ang:

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

Gagawa ito ng lokal na kopya ng iyong proyekto, kasama ang lahat nito kasaysayan ng pagbabagoKung gusto mong magkaroon ng ibang pangalan ang folder, maaari mo itong idagdag sa dulo ng command. Upang pigilan ang command mula sa paglikha ng isang bagong folder at paglalagay ng mga file nang direkta sa kasalukuyang direktoryo, magdagdag ng isang tuldok:

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

Ang pakikipag-collaborate sa ibang mga user sa GitHub ay tungkol sa pag-aaral ng daloy ng mga branch, pull request, at code review. Sa ganitong paraan, magagawa mong tumanggap ng mga panlabas na kontribusyon at magtrabaho bilang isang team sa isang organisado at mahusay na paraan.

Mga karaniwang pagkakamali at kung paano ayusin ang mga ito

Kapag nag-a-upload ng proyekto, maaari kang makatagpo ng ilang karaniwang isyu. Narito ang mga pinakakaraniwan at kung paano lutasin ang mga ito:

• Sinusubukang itulak sa isang walang laman na repository na walang master branch- Kung ang remote na repository ay ginawa nang walang README.md at ang isang sangay ay hindi pa natulak, tiyaking itulak ang unang sangay na may tamang pangalan, kadalasang "pangunahing" o "master".
• Mga conflict sa synchronization: Kapag may mga sabay-sabay na pagbabago sa lokal at malayo, lutasin ang mga ito sa pamamagitan ng unang paggawa ng a git pull at paglutas ng mga salungatan bago gawin git push muli.
• Hindi sapat na mga permit: Tiyaking mayroon kang tamang mga kredensyal at tingnan kung tama ang spelling ng remote URL (https o ssh kung naaangkop).
• Nakakalimutang magdagdag ng mahahalagang file: Suriin at i-update ang iyong file .gitignore upang hindi maiwan ang mga pangunahing file o aksidenteng mag-upload ng pribadong impormasyon.

Ang pag-upload ng iyong proyekto sa GitHub ay isang game-changer para sa iyong workflow: maaari mong bawiin anumang oras ang mga nakaraang bersyon, mag-collaborate, at ipakita ang iyong gawa sa mundo.