History

Lee Stott 2daab5271b Update Quiz Link		3 weeks ago
..
README.md	Update Quiz Link	3 weeks ago

README.md

Introduktion till GitHub

Den här lektionen täcker grunderna i GitHub, en plattform för att hosta och hantera ändringar i din kod.

Sketchnote av Tomomi Imura

Förkunskapstest

Introduktion

I den här lektionen kommer vi att gå igenom:

att spåra det arbete du gör på din dator
att arbeta på projekt tillsammans med andra
hur man bidrar till öppen källkod

Förutsättningar

Innan du börjar, kontrollera om Git är installerat. Skriv i terminalen:
git --version

Om Git inte är installerat, ladda ner Git. Ställ sedan in din lokala Git-profil i terminalen:

git config --global user.name "ditt-namn"
git config --global user.email "din-epost"

För att kontrollera om Git redan är konfigurerat kan du skriva:
git config --list

Du behöver också ett GitHub-konto, en kodredigerare (som Visual Studio Code) och du behöver öppna din terminal (eller: kommandotolken).

Gå till github.com och skapa ett konto om du inte redan har ett, eller logga in och fyll i din profil.

✅ GitHub är inte det enda kodförrådet i världen; det finns andra, men GitHub är det mest kända.

Förberedelser

Du behöver både en mapp med ett kodprojekt på din lokala dator (laptop eller PC) och ett offentligt repository på GitHub, som kommer att fungera som ett exempel på hur man bidrar till andras projekt.

Kodhantering

Låt oss säga att du har en mapp lokalt med ett kodprojekt och du vill börja spåra dina framsteg med hjälp av git - versionshanteringssystemet. Vissa jämför att använda git med att skriva ett kärleksbrev till ditt framtida jag. Genom att läsa dina commit-meddelanden dagar, veckor eller månader senare kan du minnas varför du tog ett beslut, eller "rulla tillbaka" en ändring - det vill säga, om du skriver bra "commit-meddelanden".

Uppgift: Skapa ett repository och commit:a kod

Titta på video

Skapa ett repository på GitHub. På GitHub.com, i fliken repositories, eller från navigeringsfältet uppe till höger, hitta knappen new repo.
1. Ge ditt repository (mapp) ett namn.
2. Välj create repository.
Navigera till din arbetsmapp. I din terminal, växla till mappen (även kallad katalogen) du vill börja spåra. Skriv:
```
cd [name of your folder]
```
Initiera ett git-repository. I ditt projekt, skriv:
```
git init
```
Kontrollera status. För att kontrollera statusen för ditt repository, skriv:
```
git status
```
Utdata kan se ut ungefär så här:
```
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)

     modified:   file.txt
     modified:   file2.txt
```
Vanligtvis berättar kommandot git status saker som vilka filer som är redo att sparas till repot eller har ändringar som du kanske vill bevara.
Lägg till alla filer för spårning
Detta kallas också att staga filer/lägga till filer i staging-området.
```
git add .
```
Argumentet git add plus . indikerar att alla dina filer och ändringar ska spåras.
Lägg till valda filer för spårning
```
git add [file or folder name]
```
Detta hjälper oss att lägga till endast valda filer i staging-området när vi inte vill commit:a alla filer på en gång.
Avstaga alla filer
```
git reset
```
Detta kommando hjälper oss att avstaga alla filer på en gång.
Avstaga en specifik fil
```
git reset [file or folder name]
```
Detta kommando hjälper oss att avstaga endast en specifik fil på en gång som vi inte vill inkludera i nästa commit.
Spara ditt arbete. Vid det här laget har du lagt till filerna i ett så kallat staging-område. En plats där Git spårar dina filer. För att göra ändringen permanent behöver du commit:a filerna. För att göra detta skapar du en commit med kommandot git commit. En commit representerar en sparpunkt i historiken för ditt repo. Skriv följande för att skapa en commit:
```
git commit -m "first commit"
```
Detta commit:ar alla dina filer och lägger till meddelandet "first commit". För framtida commit-meddelanden vill du vara mer beskrivande i din beskrivning för att förmedla vilken typ av ändring du har gjort.
Koppla ditt lokala Git-repo till GitHub. Ett Git-repo är bra på din dator, men vid någon tidpunkt vill du ha en backup av dina filer någonstans och även bjuda in andra att arbeta med dig på ditt repo. En sådan bra plats är GitHub. Kom ihåg att vi redan har skapat ett repo på GitHub, så det enda vi behöver göra är att koppla vårt lokala Git-repo till GitHub. Kommandot git remote add gör just det. Skriv följande kommando:

Observera, innan du skriver kommandot, gå till din GitHub-reposida för att hitta repository-URL:en. Du kommer att använda den i kommandot nedan. Ersätt https://github.com/username/repository_name.git med din GitHub-URL.
```
git remote add origin https://github.com/username/repository_name.git
```
Detta skapar en remote, eller anslutning, med namnet "origin" som pekar på GitHub-repositoryt du skapade tidigare.
Skicka lokala filer till GitHub. Hittills har du skapat en anslutning mellan det lokala repot och GitHub-repot. Låt oss skicka dessa filer till GitHub med följande kommando git push, så här:

Observera, ditt branch-namn kan vara annorlunda som standard från main.
```
git push -u origin main
```
Detta skickar dina commits i din "main"-branch till GitHub.
Lägg till fler ändringar. Om du vill fortsätta göra ändringar och skicka dem till GitHub behöver du bara använda följande tre kommandon:
```
git add .
git commit -m "type your commit message here"
git push
```
Tips, du kanske också vill använda en .gitignore-fil för att förhindra att filer du inte vill spåra dyker upp på GitHub - som den där anteckningsfilen du lagrar i samma mapp men som inte hör hemma i ett offentligt repository. Du kan hitta mallar för .gitignore-filer på .gitignore templates.

Commit-meddelanden

Ett bra Git-commit-ämnesrad kompletterar följande mening:
Om det tillämpas, kommer denna commit att <ditt ämnesrad här>

För ämnet, använd imperativ, presens: "ändra" inte "ändrade" eller "ändringar".
Precis som i ämnet, använd också imperativ, presens i brödtexten (valfritt). Brödtexten bör inkludera motivationen för ändringen och kontrastera detta med tidigare beteende. Du förklarar varför, inte hur.

✅ Ta några minuter att surfa runt på GitHub. Kan du hitta ett riktigt bra commit-meddelande? Kan du hitta ett riktigt minimalt? Vilken information tycker du är viktigast och mest användbar att förmedla i ett commit-meddelande?

Uppgift: Samarbeta

Huvudorsaken till att lägga upp saker på GitHub var att göra det möjligt att samarbeta med andra utvecklare.

Arbeta på projekt med andra

Titta på video

I ditt repository, navigera till Insights > Community för att se hur ditt projekt jämförs med rekommenderade community-standarder.

Här är några saker som kan förbättra ditt GitHub-repo:

Beskrivning. Lade du till en beskrivning för ditt projekt?
README. Lade du till en README? GitHub ger vägledning för att skriva en README.
Bidragsriktlinjer. Har ditt projekt bidragsriktlinjer?
Uppförandekod. En uppförandekod.
Licens. Kanske viktigast av allt, en licens?

Alla dessa resurser kommer att gynna onboarding av nya teammedlemmar. Och det är typiskt sådana saker nya bidragsgivare tittar på innan de ens tittar på din kod, för att ta reda på om ditt projekt är rätt plats för dem att spendera sin tid.

✅ README-filer, även om de tar tid att förbereda, förbises ofta av upptagna underhållare. Kan du hitta ett exempel på en särskilt beskrivande? Obs: det finns några verktyg för att skapa bra README-filer som du kanske vill prova.

Uppgift: Slå ihop kod

Bidragsdokument hjälper människor att bidra till projektet. Det förklarar vilka typer av bidrag du letar efter och hur processen fungerar. Bidragsgivare måste gå igenom en serie steg för att kunna bidra till ditt repo på GitHub:

Forka ditt repo. Du kommer förmodligen vilja att folk ska forka ditt projekt. Forkning innebär att skapa en kopia av ditt repository på deras GitHub-profil.
Klona. Därifrån kommer de att klona projektet till sin lokala dator.
Skapa en branch. Du vill be dem att skapa en branch för sitt arbete.
Fokusera ändringen på ett område. Be bidragsgivare att koncentrera sina bidrag på en sak i taget - på så sätt ökar chanserna att du kan slå ihop deras arbete. Föreställ dig att de skriver en buggfix, lägger till en ny funktion och uppdaterar flera tester - tänk om du vill, eller bara kan implementera 2 av 3, eller 1 av 3 ändringar?

✅ Föreställ dig en situation där branches är särskilt kritiska för att skriva och leverera bra kod. Vilka användningsfall kan du tänka dig?

Obs, var den förändring du vill se i världen och skapa branches för ditt eget arbete också. Alla commits du gör kommer att göras på den branch du för närvarande är "utcheckad" till. Använd git status för att se vilken branch det är.

Låt oss gå igenom ett arbetsflöde för en bidragsgivare. Anta att bidragsgivaren redan har forkat och klonat repot så att de har ett Git-repo redo att arbeta med på sin lokala dator:

Skapa en branch. Använd kommandot git branch för att skapa en branch som kommer att innehålla de ändringar de avser att bidra med:
```
git branch [branch-name]
```
Växla till arbetsbranchen. Växla till den angivna branchen och uppdatera arbetskatalogen med git switch:
```
git switch [branch-name]
```
Gör arbete. Vid det här laget vill du lägga till dina ändringar. Glöm inte att berätta för Git om det med följande kommandon:
```
git add .
git commit -m "my changes"
```
Se till att du ger din commit ett bra namn, för din egen skull såväl som för underhållaren av repot du hjälper till med.
Kombinera ditt arbete med main-branchen. Vid någon tidpunkt är du klar med arbetet och du vill kombinera ditt arbete med det i main-branchen. Main-branchen kan ha ändrats under tiden, så se till att du först uppdaterar den till det senaste med följande kommandon:
```
git switch main
git pull
```
Vid det här laget vill du se till att eventuella konflikter, situationer där Git inte enkelt kan kombinera ändringarna, sker i din arbetsbranch. Kör därför följande kommandon:
```
git switch [branch_name]
git merge main
```
Detta kommer att ta in alla ändringar från main till din branch och förhoppningsvis kan du bara fortsätta. Om inte, kommer VS Code att visa dig var Git är förvirrad och du ändrar bara de berörda filerna för att ange vilket innehåll som är mest korrekt.
Skicka ditt arbete till GitHub. Att skicka ditt arbete till GitHub innebär två saker. Att pusha din branch till ditt repo och sedan öppna en PR, Pull Request.
```
git push --set-upstream origin [branch-name]
```
Kommandot ovan skapar branchen på ditt forkade repo.
Öppna en PR. Nästa steg är att öppna en PR. Det gör du genom att navigera till det forkade repot på GitHub. Du kommer att se en indikation på GitHub där det frågar om du vill skapa en ny PR, klicka på det och du tas till ett gränssnitt där du kan ändra commit-meddelandets titel, ge det en mer lämplig beskrivning. Nu kommer underhållaren av repot du forkade att se denna PR och hoppas uppskatta och slå ihop din PR. Du är nu en bidragsgivare, yay :)
Städa upp. Det anses vara god praxis att städa upp efter att du framgångsrikt har slagit ihop en PR. Du vill städa upp både din lokala branch och branchen du pushade till GitHub. Först, låt oss ta bort den lokalt med följande kommando:
```
git branch -d [branch-name]
```

Se till att du går till GitHub-sidan för den forkade repot nästa gång och tar bort den fjärrgren du just pushade till.

Pull request kan verka som ett konstigt begrepp eftersom du egentligen vill pusha dina ändringar till projektet. Men projektets ansvariga (projektägare) eller kärnteamet behöver granska dina ändringar innan de slås ihop med projektets "main"-gren, så du ber egentligen om ett beslut om ändringsförslag från en ansvarig.

En pull request är platsen där man jämför och diskuterar skillnader som introducerats i en gren med hjälp av recensioner, kommentarer, integrerade tester och mer. En bra pull request följer ungefär samma regler som ett commit-meddelande. Du kan lägga till en referens till ett ärende i ärendespåraren, till exempel när ditt arbete löser ett problem. Detta görs med ett # följt av numret på ditt ärende. Till exempel #97.

🤞Håller tummarna för att alla kontroller går igenom och att projektägaren/-ägarna slår ihop dina ändringar med projektet🤞

Uppdatera din aktuella lokala arbetsgren med alla nya commits från motsvarande fjärrgren på GitHub:

git pull

Hur man bidrar till öppen källkod

Först, låt oss hitta ett repository (eller repo) på GitHub som intresserar dig och som du vill bidra med en ändring till. Du kommer att vilja kopiera dess innehåll till din dator.

✅ Ett bra sätt att hitta 'nybörjarvänliga' repos är att söka efter taggen 'good-first-issue'.

Det finns flera sätt att kopiera kod. Ett sätt är att "klona" innehållet i repot, med hjälp av HTTPS, SSH eller GitHub CLI (Command Line Interface).

Öppna din terminal och klona repot så här: git clone https://github.com/ProjectURL

För att arbeta med projektet, byt till rätt mapp: cd ProjectURL

Du kan också öppna hela projektet med Codespaces, GitHubs inbyggda kodredigerare / molnutvecklingsmiljö, eller GitHub Desktop.

Slutligen kan du ladda ner koden i en zippad mapp.

Några fler intressanta saker om GitHub

Du kan stjärnmärka, bevaka och/eller "forka" vilket offentligt repository som helst på GitHub. Du hittar dina stjärnmärkta repos i rullgardinsmenyn uppe till höger. Det är som att bokmärka, fast för kod.

Projekt har en ärendespårare, oftast på GitHub under fliken "Issues" om inget annat anges, där folk diskuterar problem relaterade till projektet. Och fliken Pull Requests är där folk diskuterar och granskar ändringar som är på gång.

Projekt kan också ha diskussioner i forum, e-postlistor eller chattkanaler som Slack, Discord eller IRC.

✅ Ta en titt runt ditt nya GitHub-repo och prova några saker, som att redigera inställningar, lägga till information i ditt repo och skapa ett projekt (som en Kanban-tavla). Det finns mycket du kan göra!

🚀 Utmaning

Arbeta tillsammans med en vän på varandras kod. Skapa ett projekt gemensamt, forka kod, skapa grenar och slå ihop ändringar.

Quiz efter föreläsningen

Granskning & Självstudier

Läs mer om att bidra till öppen källkod.

Git fusklapp.

Öva, öva, öva. GitHub har fantastiska inlärningsvägar tillgängliga via skills.github.com:

Första veckan på GitHub

Du hittar också mer avancerade kurser.

Uppgift

Slutför kursen Första veckan på GitHub

Ansvarsfriskrivning:
Detta dokument har översatts med hjälp av AI-översättningstjänsten Co-op Translator. Även om vi strävar efter noggrannhet, bör du vara medveten om att automatiska översättningar kan innehålla fel eller inexaktheter. Det ursprungliga dokumentet på dess originalspråk bör betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell mänsklig översättning. Vi ansvarar inte för eventuella missförstånd eller feltolkningar som uppstår vid användning av denna översättning.