Guide - Övningsuppgift

Här hittar du anvisningar som visar dig steg för steg de moment du är tvungen att utföra för att hämta hem en övningsuppgift så att du kan arbeta med den i ditt egna privata repo för övningsuppgifter.

Checklista innan du börjar

Kontrollera att du gjort nedanstående innan du påbörjar denna guide

• Git är installerat och konfigurerat
• Node.js och NPM är installerat
• Visual Studio Code är installerat
• SSH-nycklar är skapade och dess publika nyckel tillagd till GitLab
• Du är inloggad på GitLab

Steg 1. Välj övningsuppgift

På sidan Övningsuppgifter, Delkurs A eller Övningsuppgifter, Delkurs B hittar du länkar till de olika övningsuppgifterna på GitLab. Välj exempelvis övningsuppgift Hello World genom att klicka på dess länk.

Steg 2. “Forka” (skapa din egna kopia av) övningsuppgiften till din “Exercises”-mapp

2.1

Klicka på “Fork” uppe i högra hörnet på övningsuppgiften för att kopiera övningsuppgiften.

Du måste vara inloggad på GitLab

Om du inte är inloggad på GitLab så kan du inte göra en “fork”. Se till att logga in med dina studentkontouppgifter genom att klicka på “Sign in” i övre högra hörnet.

2.2

I listan av möjliga ställen (“Select a namespace”) att placera din kopia av övningsuppgiften, välj

Client-side Web Programming (1DV025) / Student Projects / {ditt användarnamn} / Exercises

Kryssa i “Private”. Det är bara du och kursledningen som kommer att kunna se din kod.

Steg 3. Klona övningsuppgiften till din dator

Din kopia av uppgiften

Titta på URLn till sidan som du blivit omdirigerad till. Denna sida har ditt användarnamn i sig och du har därför nu en kopia av uppgiften “Hello World” kopplad till ditt konto.

I den kopia som skapats kan du helt fritt laborera med övningsuppgiften. Men först behöver vi hämta hem den till den lokala datorn.

3.1

Klicka på “Code” och kopiera texten under “Clone with SSH”.

3.2

Öppna ett terminalfönster (Bash) på din dator.

3.3

Byt till en katalog i vilken du vill lägga dina övningsuppgifter.

Skapa katalogerna med mkdir

Har du inte skapat några kataloger kan du göra det med mkdir -p 1dv025/exercises. Kommandot skapar katalogen 1dv025 i den katalog där du befinner dig. Katalogen 1dv025 kommer i sin tur att innehålla katalogen exercises.

cd 1dv025/exercises

3.4

Klona ner övningsuppgiften.

git clone git@gitlab.lnu.se:1dv025/student/{DITT ANVÄNDARNAMN}/exercises/exercise-hello-world.git

Vilken text du ska klistra in

Texten efter “git clone” ovan är den text du kopierade under 3.1.

Steg 4. Byt till den skapade katalogen

cd exercise-hello-world

Steg 5. Verifiera att kataloger och filer hämtats

Kontrollera att katalogen exercise-hello-world innehåller kataloger och filer.

ls -A

Exempelutskrift:

.git/       .readme/      package.json     test/
.gitignore  README.md     src/

Steg 6. Arbeta med filerna

Nu har du kommit så långt att du kan börja arbeta med filerna som finns lokalt på din dator. Till varje övningsuppgift finns en README.md-fil i vilken du hittar instruktionerna för övningsuppgiften.

6.1 Visual Studio Code

Börja med att starta Visual Studio Code och öppna den katalog i vilken övningsuppgiften ligger.

6.2 Ändra i en fil

Nu kan du läsa instruktionerna (README.md) och börja koda. Testa att ändra ditt namn i någon av filerna.

1. Välj filen “hello.js” (Gäller Hello World).
2. Ta bort texten // TODO: YOUR NAME <YOUR EMAIL> på rad 6 och ersätt den med ditt namn och mejladress. Exempelvis:

* @author Ellen Nu <en999zz@student.lnu.se>

6.3 Spara

Spara filen.

Steg 7. Versionshantera

7.1 Spåra ändringen

Du behöver nu tala om för versionshanteraren Git att du vill att den förändring du nyss gjorde ska tas med i nästa version av övningsuppgiftens historik.

git add .

7.2 Lagra ändringarna

Vi fastslår förändringarna och skriver ett “commit”-meddelande som talar om vad denna förändring gör.

git commit -m "Add name and email of author"

Tips om commit-meddelanden

Tips på hur dina “commit”-meddelanden bör vara utformade hittar du här,

Git commit messages

.

7.3 Synkronisera dina ändringar

Ändringarna du gjort nu ligger fortfarande lokalt på din dator. För att skicka dessa till GitLab skriv:

git push

Exempelutskrift:

Counting objects: 15, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (13/13), done.
Writing objects: 100% (15/15), 4.69 KiB | 0 bytes/s, done.
Total 15 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1), done.
To git@gitlab.lnu.se:1dv025/student/{DITT ANVÄNDARNAMN}/exercises/exercise-hello-world.git
   bc0d25e..1846bc5  main -> main

Dina ändringar finns nu på din övningsuppgift på GitLab. Gå dit och titta efter!

Steg 8. Få tips på lösning?

När du är på GitLab kan du passa på att klicka på nedrullningsmenyn i vilken det står “main”. Där hittar du alla förgreningar (“branches”) av koden. Klickar du på “solutions” så byter du över till lösningsförslaget på uppgiften och du kan gå in i hello.js för att se hur en lösning kan se ut.