GitHub on Microsoftin omistama verkkoalusta, jota käytetään koodin isännöintiin. Sitä käytetään versionhallintaan ja yhteistyöhön, ja sen avulla kehittäjät voivat työskennellä projektin parissa samanaikaisesti mistä tahansa.
GitHubissa kehittäjät voivat helposti luoda arkistoja, joita yleensä käytetään projektien järjestämiseen. Nämä arkistot voivat sisältää kansioita, tiedostoja, kuvia, videoita, laskentataulukoita, tietojoukkoja tai mitä tahansa projektisi tarvitsemaa. Niiden mukana tulee myös Readme.md-tiedosto, jossa voit kuvata projektiasi ja antaa tietoja siitä.
Kuinka luoda arkisto
Noudata näitä ohjeita luodessasi arkiston.
- Klikkaa +, joka sijaitsee sivun oikeassa yläkulmassa. Valitse sitten Uusi arkisto.
- Valitse arkistollesi nimi (käytän "Hei kaikki").
- Kirjoita lyhyt kuvaus arkistosta.
- Valitse Alusta tämä arkisto README-komennolla.
- Klikkaa Luo arkisto -painiketta.
Kuinka luoda haara
Kun eri kehittäjät haluavat työskennellä saman asiakirjan parissa samanaikaisesti, he käyttävät GitHubin ominaisuutta nimeltä Branching. Oletusarvoisesti, kun luot arkiston, siinä on vain yksi haara, jota kutsutaan päähaaroksi. Haaroja käytetään koodin kokeiluun tai muokkaamiseen ennen kuin ne lopulta määritetään päähaaralle.
Kun haara luodaan päähaaraan, uusi toimisto on kopio päähaarasta, kun osasto luotiin. Lisäksi, jos joku tekee muutoksia päähaaraan haarasi luomisen jälkeen, voit tehdä muutokset uuteen haaraasi.
Uuden haaran luomisen vaiheet
- Siirry uuteen arkistoosi "Hei, kaikki".
- Napsauta tiedostoluettelon yläosassa olevaa avattavaa valikkoa, jossa lukee haara: mestari.
- Kirjoita uuden haaran tekstiruutuun nimi, sano "illusBranch".
- Klikkaa Luo haara laatikko tai napauta "Tulla sisään" näppäimistöllä.
Muutosten tekeminen ja toteuttaminen
Olet nyt koodinäkymässä "illusBranchille", joka on kopio päähaarasta. GitHub-alustalla tekemäsi ja tallentamasi muutokset kutsutaan "sitoumuksiksi". Niihin on liitetty merkintä, joka kertoo, mitkä muutokset olivat.
Tee ja tee muutoksia
- Napsauta ensin Readme.md tiedosto.
- Napsauta seuraavaksi kynäkuvaketta tiedostonäkymän oikeassa kulmassa. Sen avulla voit muokata koodia.
- Kun editori avautuu, kirjoita muutokset, jotka haluat tehdä.
- Kirjoita vahvistusviesti, joka parhaiten kuvaa readme.md-tiedostoon tekemiäsi muutoksia.
- Klikkaa Tee muutokset -painiketta.
Vetopyynnön avaaminen
Olet nyt tehnyt muutoksia pääkäyttäjän haaraan ja voit vetää pyynnön. Kun avaat vetopyynnön, esität ehdottamasi muutokset ja pyydät muilta tarkistusta. Jos tarkistajat hyväksyvät tekemäsi muutokset, he yhdistävät ehdottamasi muutokset omiin haaroihinsa. Vetopyynnöt osoittavat eroja molempien haarojen sisällössä. Kaikki muutokset näkyvät joko punaisina tai vihreinä. Pääset sitoumukseen vetopyynnöllä heti sen luomisen jälkeen avataksesi keskustelun siitä.
Kuinka merkitä tiedostot katsotuiksi
Suurten koodikantojen parissa työskentelevien kehittäjien on harvinaista välttää suuria vetopyyntöjä. Tiedostojen etsiminen ja tarkistaminen voi kestää useita tunteja. Etsimiseen käytetty aika saa jonkun helposti unohtamaan missä hän oli. Helppo tapa pitää kirjaa tarkistamistasi tiedoista on merkitä tiedostot katsotuiksi.
Vaiheet tiedoston merkitsemiseksi katsotuksi
Näet edistymisesi vetopyynnön yläosassa. Täällä näet tiedostot, joita olet katsellut ja joita et ole vielä nähnyt. Kun merkitset tiedoston katsotuksi, se kutistuu automaattisesti, mikä helpottaa sen tarkastelua.
Alla olevat kuvat auttavat havainnollistamaan vaiheita.
- Luo Vedä pyyntö.
- Avaa Pull-pyyntö nähdäksesi kaikki äskettäin lisätyt tai muokatut tiedostot.
- Napsauta tiedostoa merkitäksesi sen katsotuksi. Tämä tiivistää tiedoston.
Tiedoston merkitseminen on kätevä GitHubin ominaisuus, joka auttaa arvioijia keskittymään työhönsä ja seuraamaan edistymistään helposti. Katsottu-ominaisuus ilmoittaa myös, kun jokin muuttuu jo katsomassasi koodissa.
Jos esimerkiksi avaat tiedoston ja joku myös tarkistaa ja muuttaa mitä tahansa koodia sen jälkeen, kun olet jo tehnyt niin, Katselutila vaihtuu "Muutettu edellisen katselun jälkeen". Tämän avulla voit myös tarkistaa, mitä muut ovat muuttaneet aikanaan arvostelut.
Käärimistä
Uuden projektin koodaaminen itse voi tuntua pelottavalta, joten älä tee sitä yksin! Microsoft on tehnyt yhteistyöstä helppoa ja tehokasta GitHubin kanssa.