Uppdaterad VT 2024
Guiden bygger på att du läst git.md och terminalen.md.
- Lokalt repo
- Skapa repo på GitHub
- Koppla ihop dina båda repon
- Klona ditt repo
- Commit-historik
- Ändra en fil online
- Pull request
Oftast börjar vi med ett lokalt git-repository. Antingen skapar vi det själva med git init, eller så använder vi ett ramverk: npx create-react-app. För att skapa ett nytt repo, skriv i terminalen:
# skapa ett nytt, tomt repo
git init
# skapa vanliga filer
# kom ihåg att fylla i dem när du jobbar med projektet
touch .gitignore
touch README.md
# skapa en package.json fil med standardinställningar
npm init -ySkapa ett nytt repository. Ge det ett namn (gärna samma som mappen det ligger i på din dator) och fyll i lämpliga inställningar.
Nu när du har ett nytt, tomt repo på GitHub få du förslag på hur du ska lägga till filer. Scrolla ner till alternativet "existing repository" och skriv i terminalen. Så här gör du:
# Lägg till en "origin" till ditt lokala repo
# Detta kopplar ihop det med GitHub
git remote add origin https://github.com/your-github-username/your-repo-name.git
# kontrollera att du gjort rätt - git ska visa "origin" i terminalen
git remote
# om branchen heter "master" ska du byta namn på den till main
git branch -M main
# pusha dina committade lokala filer upp till GitHub
git push -u origin mainTips! Nästa gång du ska pusha räcker det med att skriva git push.
Nu när repot även ligger på GitHub och båda är synkroniserade, kan du ladda ner filerna till en ny mapp. Detta kallas för att klona ett repo. Det finns flera anledningar till att man kan vilja klona:
- man vill jobba med projektet på en annan dator
- man har förstört sitt lokala repo och vill börja om i en ny mapp
- man vill titta på någon annans kod
Skriv i terminalen:
git clone https://github.com/your-github-username/your-repo-name.git
cd your-repo-name/
# Om du jobbar med ett frontend-projekt:
# - installera alla npm-paket som står med i package.json
# - kör start-skriptet
npm install
npm run startTips! Öppna VS Code med code . innan du startar appen. När du startat appen kan du inte göra något annat med den terminalen utan att stoppa appen. Det går utmärkt att ha flera terminaler igång samtidigt.
När man gjort några commits kan man behöva se på sin historik. Skriv i terminalen:
# de 10 senaste commits som är gjorda i den aktuella branchen
git log --oneline -10Vi kan göra samma sak på GitHub.
Obs! Main är förvald branch. Om du vill se historik på andra branches behöver du byta.
Det går att ändra en fil direkt på GitHub. Men varje ändring skapar en egen commit. Använd bara den här metoden för små ändringar.
Klicka på pennan för att börja ändra i filen. Om du inte skriver ett commit-meddelande kommer GitHub använda "Edit filens-namn". Du kan även byta namn på filen.
När vi arbetar tillsammans med andra behöver vi sätt att synkronisera vårt arbete, utan att vi får onödigt många merge-konflikter. (Läs om konflikthantering.) En pull request är egentligen ett webbaserat gränssnitt för att göra git merge. Exempel på användningsfall:
- skicka ändringar från en branch till en annan
- man vill bidra till ett open source-projekt
- kontrollera ny kod för buggar, innan den läggs in i main-branchen
Det går till så här:
- Skapa en ny branch, för att jobba med en ny feature:
git checkout -b feature/feature-name - Jobba med koden, gör commits:
git commit -m "Added new feature to app - När du är färdig: pusha till GitHub:
git push origin feature/feature-name - Gå till din branch i repot på GitHub. GitHub märker automatiskt att din branch har ändringar, som inte finns i main. Det dyker upp en button du kan klicka på för att skapa en pull request.
- Det går också att skapa en pull request via meny-alternativet "Pull requests"
- De som äger eller är collaborators för repot behöver nu ta ställning till om de vill godkänna din pull request.
- Efter att en pull request är godkänd kan man ta bort branchen.
Läs mer: