Si të ngarkoni një projekt në Github si fillestar

Çdo zhvillues ose profesionist i lidhur me botën teknologjike e di se çfarë është GitHubMegjithatë, jo të gjithë e zotërojnë procesin e ngarkoni një projekt në Github dhe shfrytëzoni plotësisht potencialin e kontrollit të versioneve, bashkëpunimit të ekipit dhe dukshmërisë profesionale që ofron kjo platformë.

Pra, në këtë kuptim, si fillestarët ashtu edhe ekspertët shpesh e gjejnë veten disi të humbur. Në këtë artikull, do të mësoni Ne ju tregojmë se si ta bëni, meqenëse Ekzistojnë disa opsione ose metodaNëse doni ta bëni projektin tuaj të disponueshëm për bashkëpunim ose që të tjerët ta shohin dhe shkarkojnë lehtësisht, lexoni më tej për të mësuar të gjitha detajet.

Çfarë është një depo dhe pse duhet ta hostojmë në GitHub?

Un depo Është hapësira virtuale ku ruhen skedarët dhe dosjet e projektit tuaj, së bashku me historikun e ndryshimeve që u ndodhin atyre ndërsa përparoni në zhvillimin e tyre. Ky historik lejon Menaxhoni versionet, kthehuni në gjendjet e mëparshme, bashkëpunoni me të tjerët dhe mbani një regjistër të qartë të progresit të punës suaj..

Strehoni një depo në GitHub Ka përparësi të shumta:

• Kontrolli i versionit: Ndryshimet tuaja regjistrohen dhe ju mund të anuloni, rishikoni ose ndani çdo pjesë të zhvillimit.
• Kopje rezervë në cloud: Ju shmangni humbjen e informacionit të rëndësishëm në rast të ndonjë incidenti lokal.
• Dukshmëria profesionale: Duke qenë publik, kushdo mund ta shohë punën tuaj, gjë që e pasuron portofolin tuaj.
• Bashkëpunim i thjeshtë: GitHub ua lehtëson të tjerëve kontributin në projektin tuaj përmes kërkesave për tërheqje, problemeve ose forqeve.

Fillimi: Parakushtet dhe Përgatitja e Mjedisit

Para se të ngarkoni një projekt në Github, sigurohuni që keni instaluar në kompjuterin tuaj këto programe:

• Llogari në GitHub. Është thelbësore të krijohen depo në platformë.
• Git u instalua. Është mjeti bazë i kontrollit të versioneve që ju lejon të menaxhoni ndryshimet. Mund ta shkarkoni dhe instaloni nga faqja zyrtare e internetitNë sistemet e bazuara në Linux, mund ta kryeni instalimin duke ekzekutuar komandën sudo apt-get install git në terminal.
• Redaktor kodi ose IDE. Opsione si Visual Studio Code (VSCode) e bëjnë procesin më të lehtë. Nëse doni të përfitoni nga integrimi i drejtpërdrejtë me GitHub nga redaktori, rekomandohet të shkarkoni një nga këto mjete.

Pasi të instalohet Git në sistemin tuaj, hapi i parë është ta konfiguroni atë me tuajin emri dhe emaili (Këto të dhëna do të përdoren për të nënshkruar commit-et tuaja.) Nga terminali, ekzekutoni komandën e mëposhtme:

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

Ky konfigurim është global dhe do të duhet ta bësh vetëm një herë në ekipin tënd.

Krijimi i depos në GitHub

Tani është koha për të krijuar hapësirën ku do ta strehoni projektin tuaj. Bëjeni këtë nga ndërfaqja web e GitHub duke ndjekur këto hapa:

1. Qasuni në profilin tuaj në GitHub.com dhe shtypni butonin "E re" për të krijuar një depo të re.
2. Hyr në emër e dëshiruar për depozitën dhe shton një përshkrim i shkurtër por konkret rreth qëllimit të projektit.
3. Zgjidhni nëse depoja do të jetë publik ose privatNëse dëshironi që të tjerët të jenë në gjendje ta shohin dhe të marrin pjesë, zgjidhni "publike".
4. Ju keni mundësinë të krijoni një skedar README.md automatikisht. Ky skedar rekomandohet, pasi është gjëja e parë që zhvilluesit e tjerë do të shohin kur të hyjnë në depo.
5. Klikoni mbi "Krijo depo" për të përfunduar procesin dhe depoja juaj do të jetë gati për të marrë skedarë.

Përgatitja e projektit tuaj lokal për ngarkim në GitHub

Pasi të keni krijuar depon tuaj, hapi tjetër për të ngarkuar një projekt në GitHub është përgatitja e dosjes së projektit në kompjuterin tuaj. Për ta bërë këtë, ndiqni këto udhëzime në terminal, duke gjetur së pari rrugën e saktë me cd:

cd tu-carpeta-del-proyecto

Tani inicializoni depon lokale Git:

git init

Kjo do të krijojë një dosje të fshehur të quajtur .git që ruan historiku i versioneve dhe skedarë të tjerë të brendshëm.

 

Ngarkimi i kodit në GitHub: procesi i plotë në terminal

Pasi të inicializohet depoja lokale, ne do të ngarkojmë të gjithë përmbajtjen në GitHub duke ekzekutuar këto komanda:

1. Shtoni të gjitha skedarët në zonën e përgatitjes me:

git add .

2. Bëni një angazhim Për të regjistruar pikën e parë të kontrollit:

git commit -m "Primer commit"

3. Lidhni depon lokale me atë të largët. Zëvendëson NOMBRE_USUARIO y NOMBRE_REPOSITORIO sipas të dhënave reale:

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

4. Ngarko ndryshimet në GitHub (degë main o master sipas rastit):

git push -u origin main

Në disa depo ose konfigurime më të vjetra, dega kryesore është master në vend të mainNëse hasni gabime, kontrolloni emrin e degës kryesore dhe zëvendësojeni atë në komandën më sipër.

Si të ngarkoni projekte në Github nga VSCode

Redaktorët modernë si p.sh. VSCode Ato ofrojnë integrim nativ me Git dhe GitHub. Ja se si ta bëni lehtësisht:

• Hapni dosjen e projektit tuaj në redaktues ("Skedar → Hap Dosjen").
• Qasuni në panel Kontrolli i Burimit (kontrolli i kodit burimor) i vendosur në shiritin anësor.
• Klikoni "Initializo repozitorin" nëse nuk e keni bërë ende. Kjo është ekuivalente me komandën git init.
• Pasi të inicializohet, do të shihni një buton për të Publiko në GitHubNëse kjo është hera juaj e parë, do t'ju duhet të autorizoni lidhjen midis VSCode dhe llogarisë suaj GitHub.
• Zgjidhni ta publikoni depon si publike ose private.
• Përgatitni skedarët për kryerjen e parë duke shënuar ndryshimet dhe duke shtuar një mesazh përshkrues.
• Publikoni projektin tuaj dhe mund të sinkronizoni lehtësisht ndryshimet nga redaktori.

Ky opsion është perfekt për ata që preferojnë të qëndrojnë brenda mjedisit të zhvillimit dhe e bën menaxhimin e përditshëm të projekteve shumë më të lehtë.

Ngarko skedarët manualisht nga faqja e internetit e GitHub

Një alternativë tjetër, veçanërisht për projekte të vogla, është ngarkimi i skedarëve manualisht nga ndërfaqja e internetit:

1. Hyni në depon e sapokrijuar në GitHub.
2. Klikoni në menynë zbritëse "Shto skedar" dhe zgjidh Ngarko skedarë.
3. Zvarrit dhe lësho skedarët ose dosjet nga kompjuteri yt në dritaren e shfletuesit.
4. Në fund, shtoni një mesazh konfirmimi dhe klikoni mbi Kryej ndryshime për të ngarkuar skedarët.

Kjo metodë është më pak efikase për projektet në zhvillim aktiv, por është e dobishme për shtimin e skedarëve, dokumentacionit dhe artikujve të tjerë specifikë.

Menaxhim i avancuar dhe praktikat më të mira kur punoni me GitHub

Ngarkimi i një projekti është vetëm fillimi. Për të përfituar sa më shumë nga GitHub dhe për të ruajtur një organizatë profesionale, ne rekomandojmë të ndiqni këto praktika më të mira shtesë:

• Mbajeni README.md të përditësuar. Kjo është letra shoqëruese e projektit tuaj. Ajo shpjegon qëllimin e tij, mënyrën e instalimit, mënyrën e përdorimit dhe çdo detaj përkatës. Mund ta modifikoni direkt në internet ose nga redaktori juaj duke përdorur sintaksën Markdown.
• Krijoni degë pune. Mos i bëni të gjitha ndryshimet në "main" ose "master". Përdorni degë të ndara për veçori ose rregullime të reja. Më vonë mund t'i bashkoni ato duke përdorur kërkesa tërheqjeje.
• Ngarko skedarët .gitignore për të shmangur ndarjen e të dhënave të ndjeshme ose të gjeneruara automatikisht, siç janë dosjet node_modules, skedarët e përkohshëm ose skedarët e konfigurimit lokal.
• Sinkronizoni periodikisht depot tuaja lokale dhe të largëta. Përdor git pull për ta mbajtur kopjen tuaj lokale të përditësuar me çdo ndryshim që mund të jetë bërë nga kontribuesit.
• Menaxhoni telekomandat me kujdes. Nëse e ndryshoni ndonjëherë burimin e telekomandës, përdorni git remote -v për të shqyrtuar depot e lidhura dhe git remote remove origin për t'i hequr ato nëse është e nevojshme.

Klonimi dhe bashkëpunimi në projekte: hapi tjetër

Pasi depoja juaj të jetë në cloud, mund ta klononi atë në çdo kompjuter tjetër duke përdorur:

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

Kjo do të krijojë një kopje lokale të projektit tuaj, duke përfshirë të gjitha historia e ndryshimeveNëse dëshironi që dosja të ketë një emër tjetër, mund ta shtoni atë në fund të komandës. Për të parandaluar që komanda të krijojë një dosje të re dhe të vendosë skedarë direkt në drejtorinë aktuale, shtoni një pikë:

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

Bashkëpunimi me përdorues të tjerë në GitHub ka të bëjë tërësisht me të mësuarit e rrjedhës së degëve, kërkesave për tërheqje dhe rishikimeve të kodit. Në këtë mënyrë, do të jeni në gjendje të pranoni kontribute të jashtme dhe të punoni si ekip në një mënyrë të organizuar dhe efikase.

Gabimet e zakonshme dhe si t'i rregulloni ato

Kur ngarkoni një projekt, mund të hasni disa probleme të zakonshme. Ja cilat janë më të zakonshmet dhe si t'i zgjidhni ato:

• Duke u përpjekur të shtyj në një depo bosh pa një degë kryesore- Nëse depoja e largët është krijuar pa një skedar README.md dhe një degë nuk është shtyrë kurrë, sigurohuni që të shtyni degën e parë me emrin e saktë, zakonisht "main" ose "master".
• Konflikte sinkronizimiKur ka ndryshime të njëkohshme në nivel lokal dhe në distancë, zgjidhini ato duke bërë së pari një git pull dhe zgjidhjen e konflikteve përpara se të bëjmë git push përsëri.
• Leje të pamjaftueshmeSigurohuni që keni kredencialet e sakta dhe kontrolloni që URL-ja e largët të jetë shkruar saktë (https ose ssh sipas rastit).
• Harrimi i shtimit të skedarëve të rëndësishëmRishikoni dhe përditësoni skedarin tuaj .gitignore në mënyrë që të mos lihen jashtë skedarë kyç ose të mos ngarkohen aksidentalisht informacione private.

Ngarkimi i projektit tuaj në GitHub është një ndryshim rrënjësor për rrjedhën tuaj të punës: gjithmonë mund të rikuperoni versionet e kaluara, të bashkëpunoni dhe ta shfaqni punën tuaj para botës.