Ang pinakahuling hakbang-hakbang na gabay sa pag-upload ng iyong unang gawa sa GitHub

Naisip mo ba Paano i-upload ang iyong unang proyekto sa GitHubHuwag kang mag-alala, hindi ka nag-iisa. Maraming developer at hobbyist ang nakakaramdam ng kaunting pagkawala sa unang pagkakataon na sinubukan nilang ibahagi ang kanilang trabaho sa platform na ito. Ngunit ang magandang balita ay ang proseso ay mas simple kaysa sa tila, at sa isang detalyadong gabay, magagawa mong makabisado ang bawat hakbang sa lalong madaling panahon.

Sa artikulong ito makikita mo isang ganap na detalyadong paglilibot, na may malinaw na mga paliwanag, tunay na halimbawa at kapaki-pakinabang na mga tip upang magawa mo I-upload ang iyong unang gawa sa GitHub bilang isang propesyonal, kahit na ginagawa mo pa rin ang iyong mga unang hakbang sa mundo ng programming o kahit na ang iyong bagay ay pagbabahagi ng tula o anumang iba pang malikhaing proyekto.

Ano ang GitHub at bakit mo dapat i-upload ang iyong mga proyekto?

Ang GitHub ay ang platform na par excellence para sa pagho-host at pagbabahagi ng mga proyekto ng code., bagama't mahahanap mo rin ang lahat mula sa panitikan hanggang sa mga personal na proyekto ng anumang uri. Gumagamit ito ng isang sistema na tinatawag na kontrol sa bersyon na nagbibigay-daan sa iyong i-save ang kasaysayan ng lahat ng mga pagbabagong gagawin mo sa iyong mga file. Nag-aalok ito ng mga pakinabang tulad ng Protektahan ang iyong trabaho mula sa pagkawala, makipagtulungan sa ibang mga user, at ipakita ang iyong pag-unlad sa mga potensyal na employer o kasamahan..

Sa pamamagitan ng pag-upload ng iyong mga file sa GitHub, hindi ka lamang gumagawa ng cloud backup, ngunit nakikinabang ka rin mula sa Napakahusay na pakikipagtulungan, pagsubaybay sa bug, at mga tool sa dokumentasyon. Bilang karagdagan, ang iyong imbakan ay maaaring pampubliko o pribado, depende sa kung gusto mo itong ibahagi nang hayagan o panatilihin ito para lamang sa iyong sarili o sa iyong koponan.

Pagsisimula: paggawa ng iyong account at repositoryo

Upang makapagsimula, kailangan mo ng isang GitHub account. Pumunta ka na lang sa github.com at magparehistro nang libre. Kapag nasa loob na, magkakaroon ka ng access sa iyong dashboard kung saan maaari mong pamahalaan ang lahat ng iyong mga repositoryo at proyekto.

Ang susunod na hakbang ay lumikha ng bagong repositoryo, kung saan iimbak ang iyong mga file sa trabaho. I-click ang button na "Bagong repositoryo" (makikita mo ito sa kanang sulok sa itaas ng halos anumang page). Dito mahalagang pumili ng a makabuluhang pangalan para sa iyong proyekto at, kung gusto mo, magdagdag ng a Maikling PaglalarawanHalimbawa, maaari mong ilagay ang "my-first-project" at tulad ng "This is my first project on GitHub."

Maaari kang magpasya kung ang iyong repository ay magiging pampubliko o pribadoBinibigyang-daan ka ng pampublikong opsyon na ibahagi ang iyong trabaho sa komunidad, habang pinapanatili ito ng pribadong opsyon para lamang sa iyo. Huwag kalimutang i-activate ang magdagdag ng README file Kung gusto mong isama ang isang pagtatanghal ng proyekto mula sa simula, bagama't ito ay opsyonal at maaaring gawin sa ibang pagkakataon.

Ano ang README file at para saan ito?

Ang file README.md ay cover letter ng iyong proyekto sa GitHub. Ito ay karaniwang ang unang bagay na makikita ng mga bisita, kaya ito ay isang magandang pagkakataon upang ipaliwanag kung tungkol saan ang proyekto, ang mga tampok nito, kung paano i-install ito, o anumang iba pang nauugnay na impormasyon.

Ang file na ito ay karaniwang nakasulat sa Markdown, isang simpleng wika sa pag-format na nagbibigay-daan sa iyong i-highlight ang mga pamagat, listahan, link, at higit pa nang hindi kumplikado ang iyong buhay. Nag-aalok ang GitHub ng isang preview upang makita mo sa real time kung paano ito lumalabas at maaari mo itong i-edit nang maraming beses hangga't gusto mo hanggang sa masiyahan ka sa resulta.

Paano mag-upload ng mga file sa iyong repository mula sa browser

Ang isa sa mga pinakadirektang paraan upang i-upload ang iyong trabaho sa GitHub ay sa pamamagitan ng paggamit ng web interface. Kung nilikha mo lang ang repositoryo, makikita mo ang opsyon na Magdagdag ng mga file sa kanang tuktok ng pahina ng repositoryo. Mag-click dito at piliin ang 'Mag-upload ng Mga File.' Ngayon, i-drag at i-drop lang ang mga file o folder mula sa iyong computer patungo sa itinalagang lugar sa GitHub.

Kapag nag-upload ka ng iyong mga file, maaari kang magdagdag ng paliwanag na mensahe sa seksyong "Kumpirmahin ang Mga Pagbabago" upang gawing malinaw kung ano ang iyong idinaragdag. Tiyaking napili ang opsyong "Kumpirmahin ang Mga Pagbabago." Direktang mag-commit sa pangunahing sangay ay pinili at mag-click sa gumawa ng mga pagbabago.

At ayun na nga! Nasa cloud na ang iyong mga file at nakaayos sa loob ng iyong GitHub repository. Ang pamamaraang ito ay perpekto para sa maliliit na proyekto o para sa mga mas gustong umiwas sa terminal.

I-upload ang iyong proyekto sa GitHub gamit ang terminal at Git

Kung nakaranas ka na sa isang terminal, ang opsyong ito ay nagbibigay sa iyo ng higit na kontrol at ito ang pundasyon para sa karamihan ng mga propesyonal na daloy ng trabaho. Sa ibaba, ipapaliwanag ko ang mga pangunahing hakbang para sa pag-upload ng lokal na proyekto sa isang GitHub repository:

• Pumunta sa folder kung saan matatagpuan ang iyong mga file ng proyekto gamit ang terminal.
• Simulan ang repositoryo sa pamamagitan ng pagpapatakbo git initGagawa ito ng nakatagong folder na tinatawag na .git na gagamitin ni Git para subaybayan ang mga pagbabago.
• Idagdag ang lahat ng mga file na may git add.Sasabihin ng command na ito sa Git na isama ang lahat ng bago o binagong file sa susunod na commit.
• Gawin ang iyong unang pangako sa git commit -m "Unang commit". Dito maaari kang magpasok ng anumang mensahe na gusto mong tukuyin ang puntong ito sa kasaysayan.
• I-link ang iyong lokal na repository sa remote sa GitHub. Para magawa ito, kopyahin ang URL ng iyong GitHub repository at patakbuhin git remote add origin https://github.com/TU_USER/NOMBRE_REPOSITORIO.git.
• Panghuli, i-upload ang mga file gamit ang git push -u pinanggalingan pangunahing (o master, kung iyon ang tawag sa iyong pangunahing sangay).

Tandaan na ang huling salita ng utos ay maaaring mag-iba depende sa pangalan ng pangunahing sangay ng iyong imbakan (pangunahin o panginoon). Bukod pa rito, maaaring hilingin sa iyo ng GitHub na magpatotoo sa pamamagitan ng paglalagay ng iyong mga kredensyal o paggamit ng access token kung pinagana mo ang dalawang-hakbang na pagpapatotoo.

Paano pamahalaan ang mga pagbabago at update sa iyong repository?

Kapag nasa GitHub na ang iyong proyekto, maaari kang magpatuloy sa pag-upload ng mga file o pagbabago ng mga umiiral na, parehong mula sa web at mula sa terminal. Sa tuwing gagawa ka ng a mahalagang pagbabago, gumawa ng bagong commit na may malinaw na mensahe para ipaliwanag ang dahilan. Nakakatulong ito sa pagpapanatili ng a iniutos na kasaysayan at makakabalik kung may problema.

Maipapayo rin na magtrabaho kasama iba't ibang sangay Kung gusto mong mag-eksperimento sa mga bagong feature nang hindi naaapektuhan ang pangunahing proyekto, maaari kang lumikha ng bagong sangay para sa iyong mga pagsubok at, kapag gumagana nang tama ang lahat, pagsamahin ang mga pagbabago sa pangunahing sangay.

Ibahagi ang iyong repository gamit ang URL ay isa pang kapaki-pakinabang na opsyon, dahil ang ibang mga tao ay maaaring tumingin, magmungkahi ng mga pagbabago, o makipagtulungan sa iyo. Kung pipili ka ng isang imbakan publiko, ipapakita ng iyong profile sa GitHub ang iyong mga proyekto at kasanayan.

Mga tip at trick para sa pag-optimize ng mga pag-upload ng proyekto sa GitHub

Ang pagtatrabaho sa GitHub ay hindi kailangang maging kumplikado.Narito ang ilang karagdagang tip upang gawing mas madali ang iyong karanasan:

• Mag-commit nang madalas upang i-save ang bawat pag-unlad at maiwasan ang pagkawala ng impormasyon.
• Gumamit ng mga mapaglarawang mensahe sa bawat commit para mapadali ang pagsubaybay.
• Palaging magsama ng kumpletong README file na malinaw na nagpapaliwanag sa iyong proyekto.
• Samantalahin ang mga isyu at wiki ng GitHub upang idokumento ang mga problema, ideya at mga pag-unlad sa hinaharap.

Kung mas gusto mong hindi magtrabaho mula sa terminal, maaari mo ring gamitin GitHub Desktop, ang opisyal na app na nagpapasimple sa buong proseso ng grapiko para sa pag-upload, paggawa, at pamamahala ng mga pagbabago sa iyong mga repositoryo.

Mga karaniwang pagkakamali kapag ina-upload ang iyong unang gawa at kung paano maiiwasan ang mga ito

Maraming mga tao ang nakakaranas ng mga hadlang sa una. Ang ilan sa mga pinakakaraniwan ay:

• Hindi nasimulan nang tama ang lokal na imbakan bago ito i-link sa remote.
• Nakalilito ang pangalan ng pangunahing sangay (main vs master) sa push command.
• Hindi pagdaragdag ng lahat ng kinakailangang mga file sa unang commit (gamitin ang git add . para isama silang lahat).
• Kalimutan ang .gitignore file, na nagsisilbing ibukod pansamantalang mga file o mga folder na ayaw mong ibahagi.

Kung natigil ka, tandaan na ang GitHub ay may a malawak na dokumentasyon at isang internasyonal na komunidad kung saan maaari mong lutasin ang anumang mga katanungan. Galugarin ang mga tutorial, forum, o opisyal na tulong upang malutas ang mga problema.

Ang kahalagahan ng kontrol sa bersyon at pakikipagtulungan

Isa sa mga magagandang benepisyo ng GitHub ay ang pagpapahintulot nito itala ang bawat pagbabagong ginawa sa iyong proyekto. Salamat sa kontrol ng bersyon, mayroon kang isang uri ng 'time machine' para sa iyong code o mga file. Dagdag pa, kung nakikipagtulungan ka sa iba, maaari kang magtrabaho nang magkatulad at madaling pagsamahin ang iyong mga kontribusyon, sinusuri kung sino ang gumawa ng bawat pagbabago at kung kailan.

Hindi mo kailangang maging eksperto para masimulang samantalahin ang mga benepisyong ito. Kapag na-upload mo ang iyong unang proyekto at nagsimulang gumamit ng mga branch at commit, mauunawaan mo kung bakit ito ay isang unibersal na tool sa mga developer at creator.

Kailan gagamitin ang web interface at kailan gagamitin ang terminal?

La web interface Ito ay lubhang kapaki-pakinabang para sa mga nagsisimula, upang mag-upload ng ilang mga file o mag-update ng dokumentasyon nang mabilis. Gayunpaman, ang pandulo Mas mainam kapag lumaki ang proyekto, kailangan mong i-automate ang mga proseso o mag-collaborate bilang isang team.

Ang aking rekomendasyon ay gawing pamilyar ang iyong sarili sa parehong mga pamamaraan. Magsimula sa web kung mas madali para sa iyo, pagkatapos ay subukan ang terminal upang lubos na mapakinabangan ang Git at GitHub.

Seguridad, privacy at mga huling tip

Kung nag-aalala tungkol sa privacy ng iyong mga file, tandaan na maaari kang pumili ng a pribadong imbakan kapag nilikha ito. Sa ganitong paraan, ikaw lang o ang mga taong pinahintulutan mo ang makaka-access dito. Kung gusto mong ibahagi ang iyong proyekto sa komunidad at mag-iwan ng bakas, piliin ang pampublikong mode.

Panghuli, maglaan ng oras para kumpletuhin ang iyong repository: isama ang a Detalyadong README, isang naaangkop na lisensya (tulad ng MIT o GPL), nag-aayos ng mga folder at nagpapanatili ng a malinis na rekordAng mga detalyeng ito ay gagawing kapansin-pansin ang iyong profile at ang iyong mga proyekto ay mas kaakit-akit sa mga bisita at collaborator.

Ang pagsisimula sa GitHub ay madali, at ang pag-master ng paggamit nito ay magbibigay-daan sa iyong pamahalaan ang iyong mga proyekto nang may higit na seguridad, organisasyon, at pakikipagtulungan. Magsimula ngayon, i-upload ang unang proyektong iyon, at ibahagi ang iyong mga ideya sa pandaigdigang komunidad ng teknolohiya.