Somo fupi · Kiswahili

Jinsi ya kuchapisha tovuti yako kutoka GitHub

Chapisha ukurasa uliotolewa kutoka kwenye hifadhi ya mazoezi ya GitHub na uhakikishe kwamba uhariri wa baadaye unafika kwenye tovuti ya umma.

Anza somo shirikishiSoma maelezo ya somo

Somo hili ni la nani?

Kwa watu wanaotaka kuweka tovuti mtandaoni na kuisasisha kwa uhakika. Faili tayari za tovuti zimetolewa; unaweza kutumia GitHub Desktop na msaidizi wa programu bila kuandika amri za Git.

Kabla ya kuanza

Unahitaji akaunti zako za GitHub na Netlify na GitHub Desktop au ufikiaji unaolingana. Tumia hazina na mradi wa kupangisha tofauti kwa zoezi. Ukurasa wa P1 uliotolewa unafanya kazi hata kama hujasoma somo la tovuti binafsi. Majibu ya mfano yanaonyesha namna ya kujibu, si majaribio yaliyofanywa katika akaunti yako. Badilisha matokeo ya mfano kwa uliyoyaona mwenyewe, au taja hatua ambayo bado imekwama.

Muda unaokadiriwa: 21–33 dakika

Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Makadirio hayajumuishi kusakinisha GitHub Desktop, kupata ufikiaji wa akaunti na foleni za build. Matumizi ya hosting yanategemea akaunti yako.

Utakachojifunza

  • Unganisha hifadhi ya mazoezi na huduma ya upangishaji.
  • Chapisha badiliko linaloonekana na uhakiki matokeo ya umma.
  • Tafuta hatua iliyoshindwa ukurasa wa umma unapobaki wa zamani.

Faili za mazoezi

Hatua 1

Andaa ukurasa unaoweza kuutambua

Tumia tovuti ya P1 iliyo tayari badala ya kuanza kwa kuunda tovuti.

Fungua faili za warsha na uhifadhi index.html, style.css, netlify.toml na .gitignore katika folda moja ya mradi. Fungua index.html kwenye kompyuta yako uone ukurasa wa P1, kisha mwombe msaidizi wa programu aweke faili hizo katika mzizi wa hazina tofauti ya majaribio.

Ukurasa unapaswa kuonyesha Portfolio version P1. Chagua hazina na mradi wa kupangisha wa zoezi, ukihakikisha kuwa hakuna unaohusu tovuti nyingine inayotumiwa sasa.

Mfano halisi

Tumia kabrasha moja lenye index.html, style.css, netlify.toml na .gitignore. Alama Portfolio version P1 kwenye ukurasa wa kwanza itakusaidia kutambua toleo hili maalumu baadaye.

Tumia tovuti ya P1 na faili za uchapishaji zilizotolewa. Nisaidie kuziweka kwenye mzizi wa hifadhi tofauti ya mazoezi kwa kutumia GitHub Desktop, kukagua faili za faragha kwenye mabadiliko na kuunganisha hifadhi na mradi wangu wa mazoezi wa Netlify. Uliza kabla ya kuchapisha. Eleza jinsi ya kuthibitisha P1 kwenye ukurasa wa umma, kisha nisaidie kuchapisha uhariri mdogo wa P2 bila kubadilisha tovuti halisi iliyopo.

Faili za hatua hii

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Weka tovuti yako mtandaoni kutoka GitHub

Kuchapisha ni kunakili toleo la faili zako kwa mtoa huduma anayehifadhi tovuti mtandaoni ili watu wengine waweze kuzipata.

Ukurasa kwenye kompyuta yako, hifadhi ya msimbo ya GitHub (repository) na toleo lililowekwa kwenye hosting (deployment) ni sehemu tatu tofauti. Kuhifadhi faili kwenye kompyuta hakusasishi ukurasa wa umma moja kwa moja. Commit hurekodi toleo; huduma ya hosting iliyounganishwa inaweza kulichapisha.

Tumia mradi mpya wa mazoezi kwa somo hili. Hakikisha folda ina ukurasa mkuu halisi na stylesheet, wala si folda ya juu yenye mkusanyiko wa faili zisizohusiana.

Ili kukagua toleo kwa alama inayoonekana, ongeza aya “Portfolio version P1” kabla ya commit ya kwanza. Katika kazi ya mwisho, ibadilishe kuwa P2 pamoja na badiliko lako la maudhui lenye maana. Alama inakusaidia kulinganisha faili ya kompyutani, commit ya mbali na ukurasa uliochapishwa bila kubahatisha nakala iliyo wazi.

Mfano uliotatuliwa

Alex anaongeza maneno yanayoonekana “Portfolio version P1” kwenye ukurasa. Maneno hayo na kitambulisho cha commit yake hutuwezesha kutofautisha deployment iliyofaulu na kivinjari kinachoonyesha bado toleo la zamani.

Extra implementation exercise

Umehifadhi P1 kwenye kompyuta, lakini ukurasa wa hosting bado unasema P0. Ni hatua zipi mbili za kuchapisha huenda bado hazijafanywa?

Onyesha mfano wa suluhisho

Kagua repository kwanza, kisha rekodi ya deployment kwa mtoa huduma. Kuonyesha upya kivinjari hakuwezi kuchapisha badiliko ambalo halikufika kwa huduma ya hosting.

  • Anakagua kama badiliko limewekwa kwenye commit na kutumwa kwa push.
  • Anakagua kama deployment iliyofaulu ilitumia commit hiyo.

Hatua 2

Pitia badiliko na ulitume GitHub

Kagua orodha ya faili kabla ya kuichapisha.

Katika GitHub Desktop, pitia faili zilizobadilishwa pamoja na msaidizi wako. Fanya commit ya faili za tovuti zilizokusudiwa na utume tawi la mazoezi kwa push ukiwa tayari. Usiweke faili za mazingira au siri za akaunti kwenye hifadhi.

Fungua hifadhi kwenye GitHub na uthibitishe kwamba ukurasa wa mwanzo uliokusudiwa uko kwenye mzizi. Faili ya faragha ikionekana kwenye mabadiliko, iondoe kabla ya kutuma chochote.

Mfano halisi

Linganisha orodha ya faili zilizobadilika kabla ya kuzituma. index.html na style.css ni sehemu ya ukurasa wa umma; faili binafsi ya .env si sehemu yake. Baada ya push, kagua orodha ya mbali badala ya kudhani kuhifadhi ndani kumefika GitHub.

Faili za hatua hii

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Weka faili sahihi kwenye repository

Weka kundi dogo la faili za umma za tovuti kwenye commit, kisha likague kabla ya push.

Njia ya mfano: unda repository ya mazoezi kwenye GitHub, kisha tumia File → Clone repository katika GitHub Desktop kuikopi kwenye folda mpya ya kompyuta. Ongeza .gitignore iliyotolewa kwenye folda hiyo kwanza. Kisha nakili faili zako za umma za tovuti pekee, ukiweka index.html kwenye mzizi, na ukague mabadiliko kabla ya kuyaandaa kwa commit na kuyahifadhi.

Katika GitHub Desktop, kagua orodha ya Changes na tofauti za msimbo, andika muhtasari wa commit, hifadhi commit kwenye tawi (branch) unalokusudia, kisha uchague Push origin. Ikiwa inaonyesha Publish branch badala yake, chapisha tawi hilo kwenye repository ya mbali. Mfano wa amri hapa chini ni njia mbadala kwa nakala iliyokwisha kuanzishwa. Kanuni ya kupuuza faili katika Git haiondoi siri iliyokwisha kuwekwa kwenye commit. Ukifichua ufunguo halisi kwa bahati mbaya, ubatilishe na urekebishe repository; kufuta faili ya sasa hakutoshi.

Mfano uliotatuliwa

Orodha ya amri huandaa faili za tovuti zilizotajwa badala ya kila faili kwenye kompyuta. Kisha huonyesha badiliko lililoandaliwa ili ukague kitakachoingia kwenye commit.

git add index.html style.css netlify.toml .gitignore
git diff --cached
git commit -m "Add personal website"

Extra implementation exercise

Tofauti ulizoandaa kwa commit zinajumuisha .env yenye ufunguo wa huduma. Ufanye nini kabla ya push?

Onyesha mfano wa suluhisho

Ondoa faili kwenye maandalizi ya commit, iweke nje ya udhibiti wa matoleo na ukague tofauti tena. Ikiwa ufunguo ulifika kwenye repository ya mbali au kwa watu wengine, ubatilishe badala ya kudhani kanuni ya kupuuza faili imeufanya kuwa wa siri.

Kabla ya push, kagua tena tofauti zilizoandaliwa. Ikiwa repository ilikuwa na commit za awali, kagua historia yake na repository ya mbali kwa taarifa hiyo ya ufikiaji bila kunakili thamani yake kwenye ripoti. Badilisha ufunguo wowote halisi uliofichuliwa; kuongeza .gitignore hakuwezi kufuta ufichuzi wa zamani.

  • Anaondoa faili yenye siri kwenye mabadiliko yaliyoandaliwa.
  • Anakagua kama taarifa ya ufikiaji ilikwisha kufichuliwa na kuibadilisha inapohitajika.

Hatua 3

Unganisha hifadhi na upangishaji

Mruhusu mtoa huduma achapishe folda yenye ukurasa wa mwanzo.

Unda au chagua mradi wako tofauti wa mazoezi wa Netlify na uunganishe hifadhi na tawi lililokusudiwa. Kwa tovuti hii rahisi iliyotolewa, tumia usanidi wake wa uchapishaji; huhitaji kujenga kwa mfumo wa programu.

Subiri mtoa huduma aripoti uchapishaji uliofaulu. Fungua URL yake ya umma kwenye dirisha la faragha na utafute P1; alama ya mafanikio kwenye dashibodi pekee haithibitishi ukurasa sahihi.

Mfano halisi

Ukurasa wa ndani: P1. GitHub: P1. Mwenyeji anasema umechapishwa, lakini URL ya umma inaonyesha 404. Ukaguzi unaofuata ni kama mwenyeji anachapisha kabrasha lenye index.html kweli.

Netlify: kuunda deployment

Faili za hatua hii

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Unganisha hosting na uchague folda yake ya kuchapisha

Huduma ya hosting inahitaji kujua repository ya kutumia na folda yenye faili za umma.

Katika akaunti yako ya Netlify, unda mradi mpya kutoka repository ya mazoezi na uchague tawi lake linalokusudiwa kwa tovuti ya umma. Ruhusu ufikiaji wa repository unaohitaji pekee. Kwa HTML ya kawaida, acha amri ya build tupu na uchapishe mzizi wa repository.

Faili netlify.toml iliyotolewa inaweka mzizi huo wazi. Mradi wa framework ungetumia matokeo ya build ya framework yake; usinakili mpangilio huu kwenda mradi mwingine bila kukagua muundo wake.

Kagua mti wa folda kabla ya kusanidi hosting: mzizi wa repository → index.html na style.css. Katika njia hii ya HTML ya kawaida, publish='.' huenda pamoja na kutokuwa na amri ya build. Folda ya msimbo wa framework si moja kwa moja folda yake ya kuchapisha; maagizo yake ya build ndiyo huamua matokeo hayo.

Mfano uliotatuliwa

Ikiwa mzizi una index.html, kuchapisha “.” hutumikia faili hiyo kuwa ukurasa mkuu. Kuchapisha folda isiyo na ukurasa mkuu uliotengenezwa kunaweza kuleta deployment yenye 404 kwenye mzizi wake.

[build]
  publish = "."

Netlify: kuunda deployment

Extra implementation exercise

Deployment imefaulu, lakini ukurasa mkuu unaonyesha 404. Ni faili na mpangilio upi ulinganishe?

Onyesha mfano wa suluhisho

Hakikisha saraka iliyochaguliwa kwa kuchapisha ina index.html. Kupakia kwa mafanikio hakuthibitishi kuwa folda sahihi ndiyo iliyopakiwa.

  • Anapata index.html kwenye repository au matokeo halisi ya build.
  • Analinganisha eneo hilo na saraka ya kuchapisha.

Hatua 4

Fuatilia ukurasa wa umma uliopitwa na wakati

Linganisha hifadhi, rekodi ya upangishaji na matokeo ya kivinjari.

Fanya uhariri mdogo wa maudhui na uweke alama ya P2 kwa msaada wa msaidizi wako. Hifadhi, fanya commit na push, kisha kagua uchapishaji unaolingana kwa mtoa huduma. Hifadhi rekodi ya awali ya P1 kwa kulinganisha.

Kagua toleo lililo GitHub, toleo ambalo mtoa huduma amechapisha na kile ambacho URL ya umma inaonyesha. Kuonyesha upya kivinjari hakuwezi kutuma uhariri ambao haujatumwa kwa push.

Mfano halisi

GitHub P2 → mwenyeji P1 → umma P1 inaelekeza hatua ya uchapishaji. GitHub P2 → mwenyeji P2 → umma P1 inahitaji kukagua URL iliyoombwa na jibu lililotolewa. Ukurasa uleule unaoonekana wa zamani unaweza kuwa na sababu tofauti.

Faili za hatua hii

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Linganisha ukurasa wa umma na commit yake

Kagua toleo lililochapishwa na uzoefu wa mgeni; usitegemee tu alama ya kijani ya deployment.

Fungua URL ya umma iliyotolewa na huduma ya hosting katika dirisha la faragha. Hakikisha ukurasa mkuu na stylesheet vinapakia bila kipindi chako cha kuingia kama mmiliki. Bofya viungo vya ndani na ukague alama P1.

Linganisha commit iliyorekodiwa na huduma ya hosting na commit mpya unayokusudia kwenye repository. Ukurasa wa zamani unaweza kutokana na deployment ya awali, tawi lisilotarajiwa au cache. Tumia uchunguzi huo kuchagua ukaguzi unaofuata.

Mfano uliotatuliwa

Rekodi yenye manufaa ina commit, URL ya deployment na alama inayoonekana. Ikiwa deployment inataja commit ya P1 lakini ukurasa una P0, kagua URL iliyoombwa na jibu kabla ya kubadilisha mipangilio ya build ovyo.

Extra implementation exercise

Repository ina P2 lakini rekodi ya deployment inataja commit ya P1. Je, hili hasa ni tatizo la kuonyesha upya kivinjari?

Onyesha mfano wa suluhisho

Hapana. Chunguza kwa nini huduma ya hosting haikuchapisha commit ya P2. Chunguza cache ya kivinjari baada tu ya kuthibitisha kuwa toleo linalokusudiwa limechapishwa kweli.

  • Anatambua kuwa P2 haijachapishwa.
  • Anakagua uchaguzi wa tawi na matokeo ya build ya mwisho.

Hatua 5

Chapisha na uhakiki P2

Malizia kwa sasisho halisi la umma unaloweza kulitambua.

Chapisha badiliko la P2 kupitia njia ileile ya mazoezi. Fungua anwani ya mwisho bila kuingia kwenye akaunti na ujaribu kiungo au maudhui yaliyoathiriwa. Hifadhi vitambulisho vya mabadiliko na uchapishaji vya P1 na P2 kutoka kwenye zana.

Hakiki alama na kipengele kilichobadilishwa kweli, si ikoni ya kijani ya uchapishaji pekee. Taja hatua yoyote ambayo hukuweza kumaliza.

Mfano halisi

Makabidhiano yenye maana ya P2 yanaunganisha mambo matatu: badiliko linalolingana katika hazina, rekodi ya kupangisha na sentensi mpya inayoonekana. Alama ya kijani bila maudhui ya umma yanayokusudiwa inaacha hatua ya mwisho bila ukaguzi.

Faili za hatua hii

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Kazi yako: chapisha toleo la pili

Onyesha kuwa mchakato wa kuchapisha unafanya kazi tena baada ya uchapishaji wa kwanza kufaulu.

Fanya badiliko moja linaloonekana lenye maana, kama kuongeza maelezo ya mradi. Liweke kwenye commit na utume kwa push kupitia repository yako. Subiri deployment inayolingana, kisha uhakikishe ukurasa wake wa umma.

Hifadhi rekodi za matoleo yote mawili. Utatumia uhusiano kati ya commit na deployment baadaye unapojifunza hakiki za kabla ya kuchapisha na kurejesha toleo.

Mfano uliotatuliwa

Rekodi yako ya kabla na baada inapaswa kueleza kilichobadilika na kutambua commit zote mbili. URL ya umma pekee haitambui toleo ambalo mtu aliona.

Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.

Extra implementation exercise

Chapisha P2 na utoe ushahidi kuwa huduma ya hosting inatumikia commit unayokusudia.

  1. Badilisha kipengele kimoja kinachoonekana, sasisha alama kutoka P1 hadi P2 na ukague tofauti.
  2. Fanya commit na push; pata deployment inayolingana.
  3. Jaribu URL ya umma na urekodi alama mpya.
Onyesha mfano wa suluhisho

Kabla ya commit ya kwanza, weka “Portfolio version P1” kwenye aya inayoonekana. Hifadhi ukurasa, kagua tofauti za Changes katika GitHub Desktop, weka index.html/style.css/netlify.toml/.gitignore pekee kwenye commit na utume tawi unalokusudia kwa push. Katika mwonekano wa faili wa GitHub, hakikisha faili hizo nne ziko kwenye mzizi wa repository.

Rekodi kitambulisho cha commit kama P1. Katika Netlify chagua repository na tawi hilo hilo, acha amri ya build tupu na utumie publish='.'. Linganisha commit ya deployment iliyofaulu na P1, kisha ufungue URL yake ya umma ukiwa umetoka kwenye akaunti na usome alama. Badilisha alama kuwa P2, rudia commit/push/deploy na uhifadhi rekodi zote mbili.

Uchunguzi wenye manufaa ni: repository=P2, deploy=P1, public marker=P1 → chunguza hali ya tawi/build/deployment. Hali nyingine ni deploy=P2, public marker=P1 → kwanza kagua hostname iliyoombwa, jibu na cache. Usichapishe siri kujaribu kama Git inaweza kuificha; kagua tofauti zilizoandaliwa na historia yoyote iliyopo kabla ya push.

  • Maudhui ya umma yanalingana na badiliko la P2 na commit iliyorekodiwa.
  • Ukurasa mkuu, CSS na urambazaji vinafanya kazi bila kuingia kama mmiliki.

Somo hili lilikufaa?

Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.

Endelea kujifunza

Angalia masomo mengine