Hvordan komme i gang?

En oppstarts-guide for deg som er helt ny på bruk av Git

I denne guiden tar jeg utgangspunkt i at du sitter på Windows, men ting er som regel ganske likt på andre systemer også, det viktigste er at du får tak i omtrentlig noe riktig.

Ting du må installere

• Git. For å kunne hente ned ting må man ha git installert. F.eks herifra: https://git-scm.com/download/win
• Node.js F.eks herifra: https://nodejs.org/en/download/
• Hvis ting feiler senere kan du ha for gammel versjon av node. Det kreves node v.12 eller nyere for å kjøre sass.

Ting du mest sannsynlig allerede har

• En eller annen form for powershell søk etter powershell så bør noen alternativer dukke opp
• En eller annen tekstredigerer som notepad eller lignende. Skal du programmere mye eller gjøre store endringer anbefaler jeg å skaffe noe litt mer fancy som gir deg fine farger på koden som gjør den lettere å lese, samt filhierarki i programmet. Vi bruker Visual Studio Code, men en mer nybegynnervariant er kanskje Notepad++ eller Atom.

Bestem hvor prosjektet skal bo, og naviger deg frem

Aller først må du finne ut hvor du ønsker å plassere ting. For å kjøre prosjektet lokalt må du ha prosjektet liggende en plass lokalt. Det er egentlig ganske enkelt å sette opp.

• Først må du lage deg en mappe for ting du henter ned fra GitHub der du ønsker å ha dem. Jeg slenger dem ofte inn under brukeren min på C-disken så det er kort vei å navigere seg dit.
• Så åpner du poweshell, og navigerer deg til denne mappen.
• For å navigere kan du enten skrive cd "direkte_adresse_til_mappen" hvor direkte_adresse_til_mappen er det som står oppe i adresselinjen når du er i riktig mappe, og det må stå inne i fnutter because windows.
• Alternativt kan du bla deg frem til riktig mappe i powershellet.
  • Det er ofte mest hensiktsmessig om du startet det rett ved dit du skal.
  • For å gå inn i en mappe skriver du cd og så navnet på det du skal gå inn i.
  • Den har autocomplete om du trykker tab, så du kan for eksempel skrive cd g og så trykke på tab til den har fylt ut github om det er det mappa di hette.
  • Du kan gå oppover i filsystemet igjen ved å skrive cd ..
• Nå er du klar for å la prosjektet flytte inn!

Hent ned prosjektet

• Naviger deg frem til riktig plass i powershell
• skriv kommandoen "git clone https://github.com/Artsdatabanken/nin-kart-frontend.git"
• trykk enter
• se på magien av at github plasserer prosjektet for deg. Hvis du skal gjøre dette i andre prosjekter, kan du finne denne lenken du ønsker å kopiere på prosjektets fremside, hvor det er en stor og fin og grønn knapp som det står "Clone or download" på. Det er denne du skal kopiere og skrive etter git clone.

Sett bruker

Den første gangen du lager en commit kan det være github ber deg om å konfigurere deg opp mot riktig github bruker, da gjør du som den forteller deg.

• skriv første kommando som powershell har listet opp
• rediger i editoren og lagre
• skriv neste kommando
• neste gang du nå pusher, vil den be deg logge deg på. Editoren som automatisk dukker opp da heter vim. Når du har redigert det den ber om, kan du lagre eller forlate.
  • fjerne hash-tegnet på to linjer med navn og mail
  • skrive inn ditt github-brukernavn og din github-email,
  • trykke ctrl-c for å aktivere exit-kommandoene.
  • her kan du velge å lagre eller forkaste med å skrive ":wq" for å lagre eller ":qa!" for å forkaste.

Litt viktig:

• vi vil aldri at dere skal putte noe direkte inn i den greina som heter master. Vi har som regel en oppdatert gren som ikke er master-greina, og det kan være lurt å ta en rask titt på "insights" tabben under fanen "network" for å se hvor vi for tiden jobber. Naviger til den siste stabile varianten (navn kan variere, her kommer vi til å endre litt policy etterhvert), og pass på at denne er din aktive branch før du lager dine egne ting.

Git commandoer du kan ha bruk for:

• git fetch
• git checkout branchnavn
• git stash brukes som kommando om det markeres en "M" først i linja, og du ikke vil endre noe (bare se)
• git pull origin branchnavn
• git add filnavn
• git add .
• git commit -m "forklaring"
• git pull origin branchnavn Ja, jeg repeterer fordi alltid pull før push
• git push origin branchnavn
• npm install installerer det du trenger i prosjektet
• npm run start åpner valgte branch i browser
• 'ctrl c' to terminate brach job. (svar Y)

Hvis du får en konflikt og du ikke vet hvordan å fikse det, hent en av oss :)