Sut i uwchlwytho prosiect i Github fel dechreuwr

Mae unrhyw ddatblygwr neu weithiwr proffesiynol sy'n gysylltiedig â'r byd technolegol yn gwybod beth ydyw. GitHubFodd bynnag, nid yw pawb yn meistroli'r broses o uwchlwytho prosiect i Github a manteisio'n llawn ar botensial rheoli fersiynau, cydweithio tîm, a gwelededd proffesiynol y mae'r platfform hwn yn ei gynnig.

Felly, yn yr ystyr hwn, mae dechreuwyr ac arbenigwyr yn aml yn colli eu hunain braidd. Yn yr erthygl hon, byddwch chi'n dysgu Rydyn ni'n dweud wrthych chi sut i wneud hynny, gan fod Mae yna sawl opsiwn neu ddullOs ydych chi eisiau gwneud eich prosiect ar gael ar gyfer cydweithio neu i eraill ei weld a'i lawrlwytho'n hawdd, darllenwch ymlaen i ddysgu'r holl fanylion.

Beth yw storfa a pham ei chynnal ar GitHub?

Un repositorio Dyma'r gofod rhithwir lle mae ffeiliau a ffolderi eich prosiect yn cael eu storio, ynghyd â hanes y newidiadau sy'n digwydd iddynt wrth i chi symud ymlaen trwy eu datblygiad. Mae'r hanes hwn yn caniatáu Rheoli fersiynau, dychwelyd i gyflyrau blaenorol, cydweithio ag eraill, a chadw cofnod clir o gynnydd eich gwaith..

Cynnal storfa ar GitHub tiene múltiples ventajas:

• Control de versiones: Mae eich newidiadau'n cael eu cofnodi a gallwch ddadwneud, adolygu neu rannu unrhyw ran o'r datblygiad.
• Copia de seguridad en la nube: rydych chi'n osgoi colli gwybodaeth bwysig pe bai unrhyw ddigwyddiad lleol.
• Visibilidad profesional: Gan ei fod yn gyhoeddus, gall unrhyw un weld eich gwaith, sy'n gwella eich portffolio.
• Colaboración sencilla: Mae GitHub yn ei gwneud hi'n hawdd i eraill gyfrannu at eich prosiect trwy geisiadau tynnu, problemau, neu fforciau.

Dechrau Arni: Rhagofynion a Pharatoi'r Amgylchedd

Cyn uwchlwytho prosiect i Github, gwnewch yn siŵr bod y canlynol wedi'i osod ar eich cyfrifiadur:

• Cyfrif ar GitHub. Mae'n hanfodol creu storfeydd ar y platfform.
• Git instalado. Dyma'r offeryn rheoli fersiynau sylfaenol sy'n eich galluogi i reoli newidiadau. Gallwch ei lawrlwytho a'i osod o'i web oficialAr systemau sy'n seiliedig ar Linux, gallwch chi gyflawni'r gosodiad drwy redeg y gorchymyn sudo apt-get install git en la terminal.
• Golygydd cod neu IDE. Opsiynau fel Visual Studio Code (VSCode) gwneud y broses yn haws. Os ydych chi am fanteisio ar integreiddio uniongyrchol â GitHub o'r golygydd, argymhellir lawrlwytho un o'r offer hyn.

Una vez instalado Git ar eich system, y cam cyntaf yw ei ffurfweddu gyda'ch enw ac e-bost (Bydd y data hwn yn cael ei ddefnyddio i lofnodi eich ymrwymiadau.) O'r derfynell, rhedeg y canlynol:

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

Esta configuración es global a dim ond unwaith y bydd yn rhaid i chi ei wneud ar eich tîm.

Creu'r storfa ar GitHub

Nawr mae'n bryd creu'r lle lle byddwch chi'n cynnal eich prosiect. Gwnewch hyn o ryngwyneb gwe GitHub trwy ddilyn y camau hyn:

1. Accede a tu perfil en GitHub.com y pulsa en el botón «New» i greu storfa newydd.
2. Introduce el nombre a ddymunir ar gyfer y storfa ac yn ychwanegu descripción yn fyr ond yn bendant ynglŷn â phwrpas y prosiect.
3. Dewiswch a fydd y storfa público o privadoOs ydych chi eisiau i eraill allu gweld a chymryd rhan, dewiswch gyhoeddus.
4. Mae gennych chi'r opsiwn i greu ffeil README.md yn awtomatig. Argymhellir y ffeil hon, gan mai dyma'r peth cyntaf y bydd datblygwyr eraill yn ei weld pan fyddant yn cyrchu'r storfa.
5. Cliciwch ar «Create repository» i gwblhau'r broses a bydd eich storfa yn barod i dderbyn ffeiliau.

Paratoi eich prosiect lleol i'w uwchlwytho i GitHub

Gyda'ch storfa wedi'i chreu, y cam nesaf i uwchlwytho prosiect i GitHub yw paratoi'ch ffolder prosiect ar eich cyfrifiadur. I wneud hyn, dilynwch y cyfarwyddiadau hyn yn y derfynfa, gan ddod o hyd i'r llwybr cywir yn gyntaf gyda cd:

cd tu-carpeta-del-proyecto

Nawr cychwynnwch y storfa Git leol:

git init

Bydd hyn yn creu ffolder gudd o'r enw .git sy'n storio'r historial de versiones a ffeiliau mewnol eraill.

 

Lanlwytho'r cod i GitHub: y broses gyflawn yn y derfynfa

Unwaith y bydd y storfa leol wedi'i chychwyn, byddwn yn uwchlwytho'r holl gynnwys i GitHub trwy redeg y gorchmynion hyn:

1. Ychwanegu pob ffeil at yr ardal llwyfannu gyda:

git add .

2. Gwneud ymrwymiad I gofnodi'r pwynt gwirio cyntaf:

git commit -m "Primer commit"

3. Cysylltwch y storfa leol â'r un anghysbell. Yn disodli NOMBRE_USUARIO y NOMBRE_REPOSITORIO yn ôl data go iawn:

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

4. Uwchlwytho newidiadau i GitHub (rama main o master fel y bo'n briodol):

git push -u origin main

Mewn rhai hen ystorfeydd neu gyfluniadau, y prif gangen yw master en vez de mainOs cewch wallau, gwiriwch enw'r prif gangen a'i ddisodli yn y gorchymyn uchod.

Sut i uwchlwytho prosiectau i Github o VSCode

Golygyddion modern fel VSCode Maen nhw'n cynnwys integreiddio brodorol gyda Git a GitHub. Dyma sut i wneud hynny'n hawdd:

• Agorwch ffolder eich prosiect yn y golygydd (“Ffeil → Agor Ffolder”).
• Accede al panel Source Control (rheolaeth cod ffynhonnell) wedi'i lleoli yn y bar ochr.
• Cliciwch "Cychwyn y storfa" os nad ydych chi wedi gwneud hynny eisoes. Mae hyn yn cyfateb i'r gorchymyn git init.
• Ar ôl ei gychwyn, fe welwch fotwm i "Cyhoeddi i GitHub"Os mai dyma'ch tro cyntaf, bydd angen i chi awdurdodi'r cysylltiad rhwng VSCode a'ch cyfrif GitHub.
• Dewiswch gyhoeddi'r storfa fel un gyhoeddus neu breifat.
• Paratowch y ffeiliau ar gyfer y cyflawniad cyntaf trwy farcio'r newidiadau ac ychwanegu neges ddisgrifiadol.
• Cyhoeddwch eich prosiect a gallwch gysoni newidiadau o'r golygydd yn hawdd.

Mae'r opsiwn hwn yn berffaith i'r rhai sy'n well ganddynt aros o fewn yr amgylchedd datblygu ac mae'n gwneud rheoli prosiectau bob dydd yn llawer haws.

Lanlwytho ffeiliau â llaw o wefan GitHub

Dewis arall, yn enwedig ar gyfer prosiectau bach, yw uwchlwytho ffeiliau â llaw o'r rhyngwyneb gwe:

1. Rhowch y storfa newydd ei chreu ar GitHub.
2. Haz clic en el menú desplegable «Add file» y selecciona Uwchlwytho ffeiliau.
3. Llusgwch a gollwng ffeiliau neu ffolderi o'ch cyfrifiadur i ffenestr y porwr.
4. Ar y gwaelod, ychwanegwch neges gadarnhau a chliciwch ar Gwneud newidiadau i uwchlwytho'r ffeiliau.

Mae'r dull hwn yn llai effeithlon ar gyfer prosiectau sydd mewn datblygiad gweithredol, ond mae'n ddefnyddiol ar gyfer ychwanegu ffeiliau, dogfennaeth ac eitemau penodol eraill.

Rheolaeth uwch ac arferion gorau wrth weithio gyda GitHub

Dim ond y dechrau yw uwchlwytho prosiect. I gael y gorau o GitHub a chynnal trefniadaeth broffesiynol, rydym yn argymell dilyn yr arferion gorau ychwanegol hyn:

• Cadwch README.md yn gyfredol. Dyma lythyr eglurhaol eich prosiect. Mae'n egluro ei bwrpas, sut i'w osod, sut i'w ddefnyddio, ac unrhyw fanylion perthnasol. Gallwch ei olygu'n uniongyrchol ar-lein neu o'ch golygydd gan ddefnyddio cystrawen Markdown.
• Creu canghennau gwaith. Peidiwch â gwneud eich holl newidiadau yn "main" neu "master". Defnyddiwch ganghennau ar wahân ar gyfer nodweddion neu atgyweiriadau newydd. Gallwch eu huno'n ddiweddarach gan ddefnyddio ceisiadau tynnu.
• Uwchlwytho ffeiliau .gitignore er mwyn osgoi rhannu data sensitif neu ddata a gynhyrchir yn awtomatig, fel ffolderi node_modules, ffeiliau dros dro, neu ffeiliau ffurfweddu lleol.
• Cydamserwch eich ystorfeydd lleol ac anghysbell yn rheolaidd. Defnyddio git pull i gadw eich copi lleol yn gyfredol gydag unrhyw newidiadau a allai fod wedi'u gwneud gan gyfranwyr.
• Rheolwch reolaethau o bell yn ofalus. Os byddwch chi byth yn newid y ffynhonnell o bell, defnyddiwch git remote -v i adolygu'r ystorfeydd cysylltiedig a git remote remove origin i'w tynnu allan os oes angen.

Clonio a chydweithio ar brosiectau: y cam nesaf

Unwaith y bydd eich storfa yn y cwmwl, gallwch ei chlonio i unrhyw gyfrifiadur arall gan ddefnyddio:

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

Bydd hyn yn creu copi lleol o'ch prosiect, gan gynnwys ei holl historial de cambiosOs ydych chi eisiau i'r ffolder gael enw gwahanol, gallwch ei ychwanegu at ddiwedd y gorchymyn. I atal y gorchymyn rhag creu ffolder newydd a gosod ffeiliau'n uniongyrchol yn y cyfeiriadur cyfredol, ychwanegwch atalnod:

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

Mae cydweithio â defnyddwyr eraill ar GitHub i gyd yn ymwneud â dysgu llif canghennau, ceisiadau tynnu, ac adolygiadau cod. Fel hyn, byddwch chi'n gallu derbyn cyfraniadau allanol a gweithio fel tîm mewn modd trefnus ac effeithlon.

Errores comunes y cómo solucionarlos

Wrth uwchlwytho prosiect, efallai y byddwch yn dod ar draws rhai problemau cyffredin. Dyma'r rhai mwyaf cyffredin a sut i'w datrys:

• Yn ceisio gwthio i storfa wag heb gangen feistr- Os crëwyd y storfa anghysbell heb README.md ac nad oes cangen erioed wedi'i gwthio, gwnewch yn siŵr eich bod yn gwthio'r gangen gyntaf gyda'r enw cywir, fel arfer "main" neu "master".
• Conflictos de sincronizaciónPan fydd newidiadau ar yr un pryd yn lleol ac o bell, datryswch nhw trwy wneud a yn gyntaf git pull a datrys gwrthdaro cyn gwneud git push de nuevo.
• Permisos insuficientesGwnewch yn siŵr bod gennych y manylion mewngofnodi cywir a gwiriwch fod yr URL o bell wedi'i sillafu'n gywir (https neu ssh yn ôl yr angen).
• Anghofio ychwanegu ffeiliau pwysigAdolygu a diweddaru eich ffeil .gitignore er mwyn peidio â gadael ffeiliau allweddol allan neu uwchlwytho gwybodaeth breifat ar ddamwain.

Mae uwchlwytho eich prosiect i GitHub yn newid y gêm i'ch llif gwaith: gallwch chi bob amser adfer fersiynau blaenorol, cydweithio, ac arddangos eich gwaith i'r byd.