Kuidas algajana Githubi projekti üles laadida

Iga tehnoloogiamaailmaga seotud arendaja või professionaal teab, mis see on GitHubKuid mitte kõik ei valda protsessi laadige projekt Githubi üles ja kasutada täiel määral ära selle platvormi pakutavat versioonikontrolli, meeskonnatöö ja professionaalse nähtavuse potentsiaali.

Seega on nii algajad kui ka eksperdid selles mõttes tihtipeale eksinud. Sellest artiklist saate teada, Me ütleme teile, kuidas seda teha, kuna On mitu võimalust või meetoditKui soovite oma projekti koostööks või teistele hõlpsaks vaatamiseks ja allalaadimiseks kättesaadavaks teha, lugege edasi, et saada teada kõik üksikasjad.

Mis on repositoorium ja miks seda GitHubis majutada?

Un hoidla See on virtuaalne ruum, kus teie projekti failid ja kaustad salvestatakse koos nende arendusprotsessi käigus tehtud muudatuste ajalooga. See ajalugu võimaldab Halda versioone, taasta eelmised olekud, tee teistega koostööd ja pea oma töö edenemisest selget arvestust..

Hoidke hoidlat saidil GitHub Sellel on mitmeid eeliseid:

• Versiooni juhtimine: Teie muudatused salvestatakse ja saate arenduse mis tahes osa tagasi võtta, üle vaadata või jagada.
• Pilvevarundamine: väldite olulise teabe kaotamist kohaliku intsidendi korral.
• Professionaalne nähtavus: Kuna tegemist on avaliku tööga, näeb igaüks seda, mis rikastab teie portfooliot.
• Lihtne koostöö: GitHub teeb teiste jaoks teie projekti panustamise lihtsaks pull requestide, probleemide või forkide kaudu.

Alustamine: eeltingimused ja keskkonna ettevalmistamine

Enne projekti Githubisse üleslaadimist veendu, et sul on arvutisse installitud järgmine:

• Konto GitHubis. Platvormil on oluline luua repositooriumid.
• Git on installitud. See on põhiline versioonikontrolli tööriist, mis võimaldab teil muudatusi hallata. Saate selle alla laadida ja installida aadressilt ametlikul kodulehelLinuxi-põhistes süsteemides saate installimise teostada käsuga sudo apt-get install git Terminalis.
• Koodiredaktor ehk IDE. Valikud nagu Visual Studio kood (VSCode) muudavad protsessi lihtsamaks. Kui soovite redaktorist GitHubiga otseintegratsiooni ära kasutada, on soovitatav alla laadida üks neist tööriistadest.

Kui see on installitud Git teie süsteemis on esimene samm selle konfigureerimine teie nimi ja e-posti aadress (Neid andmeid kasutatakse teie commit'ide allkirjastamiseks.) Käivitage terminalis järgmine käsk:

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

See seadistus on globaalne ja sa pead seda oma meeskonnas tegema ainult ühe korra.

Repositooriumi loomine GitHubis

Nüüd on aeg luua ruum, kus oma projekti majutate. Tehke seda GitHubi veebiliidese kaudu, järgides neid samme:

1. Juurdepääs oma profiilile aadressil Github.com ja klõpsake nuppu "Uus" uue hoidla loomiseks.
2. Sisestage nimi hoidla jaoks soovitud ja lisab kirjeldus Lühidalt, aga konkreetselt projekti eesmärgi kohta.
3. Valige, kas hoidla on avalik või privaatneKui soovite, et ka teised saaksid vaadata ja osaleda, valige avalik.
4. Teil on võimalus luua fail README.md automaatselt. See fail on soovitatav, kuna see on esimene asi, mida teised arendajad repositooriumile juurde pääsedes näevad.
5. Klõpsake nuppu "Loo hoidla" protsessi lõpuleviimiseks ja teie hoidla on failide vastuvõtmiseks valmis.

Kohaliku projekti ettevalmistamine GitHubisse üleslaadimiseks

Kui teie repositoorium on loodud, on projekti GitHubisse üleslaadimise järgmine samm projektikausta ettevalmistamine arvutis. Selleks järgige terminalis neid juhiseid, leides kõigepealt õige tee cd:

cd tu-carpeta-del-proyecto

Nüüd initsialiseeri kohalik Giti hoidla:

git init

See loob peidetud kausta nimega .git mis salvestab versiooni ajalugu ja muud sisemised failid.

 

Koodi üleslaadimine GitHubisse: kogu protsess terminalis

Kui kohalik repositoorium on initsialiseeritud, laadime kogu sisu GitHubisse üles, käivitades järgmised käsud:

1. Lisa kõik failid testimisalale koos:

git add .

2. Tee commit Esimese kontrollpunkti registreerimiseks:

git commit -m "Primer commit"

3. Ühenda kohalik hoidla kaughoidlaga. Asendab NOMBRE_USUARIO y NOMBRE_REPOSITORIO reaalsete andmete põhjal:

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

4. Laadi muudatused üles GitHubi (haru main o master vastavalt vajadusele):

git push -u origin main

Mõnedes vanemates hoidlates või konfiguratsioonides on peaharu master asemel mainKui ilmnevad vead, kontrollige peamise haru nime ja asendage see ülaltoodud käsus.

Kuidas VSCode'ist projekte Githubisse üles laadida

Kaasaegsed toimetajad, näiteks VSCode Neil on natiivne integratsioon Giti ja GitHubiga. Siin on, kuidas seda hõlpsalt teha:

• Ava redaktoris oma projektikaust („Fail → Ava kaust”).
• Juurdepääs armatuurlauale Allika juhtimine (lähtekoodi kontroll), mis asub külgribal.
• Kui te pole seda veel teinud, klõpsake nuppu „Initsialiseeri hoidla”. See on samaväärne käsuga git init.
• Pärast initsialiseerimist näete nuppu, millega Avalda GitHubisKui see on teie esimene kord, peate autoriseerima ühenduse VSCode'i ja oma GitHubi konto vahel.
• Valige, kas avaldada hoidla avaliku või privaatsena.
• Valmista failid esimeseks commit'iks ette, märkides muudatused ja lisades kirjeldava sõnumi.
• Avaldage oma projekt ja saate redaktorist tehtud muudatusi hõlpsalt sünkroonida.

See valik sobib ideaalselt neile, kes eelistavad jääda arenduskeskkonda ja muudab igapäevase projektijuhtimise palju lihtsamaks.

Laadi failid käsitsi üles GitHubi veebisaidilt

Teine alternatiiv, eriti väikeste projektide puhul, on failide käsitsi üleslaadimine veebiliidese kaudu:

1. Sisestage GitHubis äsja loodud hoidla.
2. Klõpsake rippmenüül "Lisa fail" ja valige Laadi failid üles.
3. Lohistage failid või kaustad arvutist brauseriaknasse.
4. Lisage allosas kinnituskiri ja klõpsake nuppu Muudatuste kinnitamine failide üleslaadimiseks.

See meetod on aktiivses arenduses olevate projektide puhul vähem efektiivne, kuid on kasulik konkreetsete failide, dokumentatsiooni ja muude üksuste lisamiseks.

GitHubiga töötamise täiustatud haldus ja parimad tavad

Projekti üleslaadimine on alles algus. GitHubi maksimaalseks ärakasutamiseks ja professionaalse organisatsiooni säilitamiseks soovitame järgida järgmisi parimaid tavasid:

• Hoidke README.md ajakohasena. See on teie projekti kaaskiri. See selgitab selle eesmärki, installimisviisi, kasutamist ja muid olulisi üksikasju. Saate seda otse veebis või oma redaktorist Markdowni süntaksi abil redigeerida.
• Loo tööharud. Ära tee kõiki muudatusi "main"-is või "master"-is. Kasuta uute funktsioonide või paranduste jaoks eraldi harusid. Hiljem saad need pull requestide abil ühendada.
• Laadi üles .gitignore failid et vältida tundlike või automaatselt genereeritud andmete (nt node_modules kaustade, ajutiste failide või kohalike konfiguratsioonifailide) jagamist.
• Sünkroniseeri perioodiliselt oma kohalikke ja kaughoidlaid. USA git pull et hoida oma kohalikku koopiat ajakohasena kõigi kaastöötajate tehtud muudatustega.
• Halda kaugjuhtimispulte hoolikalt. Kui te kunagi kaugjuhtimispuldi allikat muudate, kasutage git remote -v seotud repositooriumide ülevaatamiseks ja git remote remove origin et vajadusel need eemaldada.

Projektide kloonimine ja koostöö: järgmine samm

Kui teie hoidla on pilves, saate selle kloonida mis tahes teise arvutisse, kasutades järgmist:

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

See loob teie projektist kohaliku koopia, sealhulgas kõik selle muutuste ajaluguKui soovite kaustale teistsuguse nime anda, saate selle käsu lõppu lisada. Selleks, et käsk ei looks uut kausta ja ei paigutaks faile otse praegusesse kataloogi, lisage punkt:

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

GitHubis teiste kasutajatega koostöö tegemine seisneb harude, pull-requestide ja koodiülevaadete voo õppimises. Nii saate vastu võtta väliseid panuseid ja töötada meeskonnana organiseeritult ja tõhusalt.

Levinud vead ja nende parandamine

Projekti üleslaadimisel võib esineda mõningaid levinud probleeme. Siin on kõige levinumad ja kuidas neid lahendada:

• Proovin saata tühja repositooriumisse ilma peaharuta- Kui kaughoidla loodi ilma README.md failita ja ühtegi haru pole kunagi lisatud, siis veenduge, et esimene haru oleks õige nimega, tavaliselt "main" või "master".
• SünkroonimiskonfliktidKui samaaegselt toimuvad muudatused nii kohapeal kui ka eemalt, lahendage need esmalt järgmise toiminguga: git pull ja konfliktide lahendamine enne tegutsemist git push uuesti.
• Ebapiisavad loadVeenduge, et teil on õiged volitused ja et kaug-URL on õigesti kirjutatud (vastavalt vajadusele https või ssh).
• Oluliste failide lisamise unustamineVaadake oma fail üle ja värskendage seda .gitignore et mitte jätta olulisi faile välja ega kogemata üles laadida privaatset teavet.

Projekti üleslaadimine GitHubisse muudab teie töövoogu täielikult: saate alati taastada varasemaid versioone, teha koostööd ja oma tööd maailmale esitleda.