Använda Git via redigeraren

Introduktion

Vad är Git?

Git är ett versionshanteringssystem för kod som används flitigt i mjukvaruprojekt. Det gör det bland annat möjligt:

att ha en historik över koden, där man kan gå tillbaka i tiden;
att synkronisera flera enheter och arbeta i grupp på samma filer med färre konflikter;
att underhålla flera versioner av samma kod, för att utveckla och experimentera utan att förstöra den fungerande versionen;
att enkelt säkerhetskopiera projektet.

En mapp som versionshanteras med Git kallas ett arkiv (_repository_ eller _repo_ på engelska).

Vad är en forge?

Git är ett program som kan användas lokalt (på din dator eller i Leek Wars redigerare), men det kan också samverka med en forge, alltså en kodplattform. Det är en server som är värd för Git-arkiv.

Leek Wars stöder flera forges; det enklaste är att välja en av dessa:

GitHub, proprietär tjänst från Microsoft (USA). Är också värd för Leek Wars kod.
GitLab.com, officiell instans av GitLab (USA), en fri programvara som man kan hosta själv.
Bitbucket, proprietär tjänst från Atlassian (USA).
Codeberg, officiell instans av Forgejo, en gemenskapsdriven fri programvara som man kan hosta själv, driven av en tysk ideell organisation.

Det går också att använda andra forges baserade på GitLab, Bitbucket, Forgejo, Gitea eller Gogs, till exempel framagit.org eller gitea.com.

Använda Git för en befintlig AI

Först och främst måste AI:n ligga i en mapp, inte i roten. Skapa en mapp, högerklicka på mappen och välj "Initialisera ett Git-arkiv". Den kommer att innehålla alla filer som ska ingå i Git.

En Git-flik med en grenikon visas högst upp i fillistan (vänstermenyn). Gå dit.

Göra commits

(uttalas ungefär "kåmitt"; på svenska kan man också säga "incheckning")

Kontrollera högst upp i Git-fliken, i rullgardinsmenyn, att rätt arkiv är valt (om du har flera).

När filerna i arkivet ändras visas ändringarna i Git-fliken. De är tills vidare inte indexerade: det är som ett utkast som ännu inte har huggits in i historikens sten.

När du vill spara ändringar i historiken klickar du på knappen ➕ för att indexera dem. Sammanfatta ändringarna med några ord i fältet "Commit-meddelande" och bekräfta.

Obs: för att se alla knappar i Git-fliken kan du behöva förstora den åt höger genom att dra i dess högra kant!

Historiken är en lista av commits, där varje commit är en uppsättning ändringar med ett datum och ett meddelande. Tanken är att kunna ta reda på när en viss ändring gjordes, gå tillbaka, gruppera ändringar för att slippa kod som bara fungerar till hälften...

Ansluta till en forge

Konfiguration på forgen

Skapa ett konto på en Git-forge och skapa ett tomt arkiv där. Ta reda på adressen till ditt arkiv, som borde se ut ungefär som https://exemple.net/mon-pseudo/mon-depot.git. Det är adressen till arkivets huvudsida, med .git tillagt på slutet.

Sedan måste du ge Leek Wars tillgång till arkivet. Tillvägagångssättet beror på forgen.

GitHub: det enklaste är att installera Leek Wars GitHub App, direkt från redigeraren (se nedan). Alternativt kan du skapa en token: klicka på din profil, Settings, Developer Settings (längst ner). På sidan som öppnas väljer du Personal access tokens, Tokens (classic). Välj ett utgångsdatum (till exempel 90 dagar) och ge bara de rättigheter som behövs för att bidra till arkivet.
Forgejo: Kontoinställningar, Applikationer, Ny åtkomsttoken. Tillåt läs- och skrivåtkomst till "repository".

Om du har skapat en token, spara den väl så att du inte tappar bort den!

Konfiguration på Leek Wars

Längst ner i Git-fliken klickar du på molnknappen "Inställningar för remote".

Här deklarerar man fjärrarkivet (remoten): ange ett namn (till exempel origin), klistra in arkivets URL och klicka på knappen "Lägg till". Det här steget är nödvändigt innan du kan pusha något över huvud taget.

För autentiseringen väljer du din forge: GitHub, GitLab, Bitbucket eller Forgejo.

GitHub: huvudvägen är knappen "Installera GitHub App". Under installationen väljer du vilka arkiv som ska få åtkomst; tillbaka i Leek Wars kan du sedan välja ett av dessa arkiv direkt som remote. Alternativt klistrar du in en Personal Access Token i fältet "Åtkomsttoken".
GitLab och Bitbucket: klistra in din token i fältet "Åtkomsttoken". Om du använder en självhostad instans i stället för gitlab.com eller bitbucket.org, kryssa i "Självhostad instans" och ange forgens adress (den här rutan finns även för GitHub).
Forgejo: rutan "Självhostad instans" finns inte för den här forgen; fältet för instansens adress visas alltid (förifyllt med codeberg.org). Ange adressen till din instans vid behov, och klistra in din token i fältet "Åtkomsttoken".

Skicka sina commits till servern

Hittills sparas commit-historiken bara i Leek Wars. För att skicka den till forgen gör man en push med knappen ⬆ längst ner i Git-fliken.

Varje gång du vill skicka nya commits gör du en push.

Andra funktioner

Redigeraren och Git-fliken erbjuder också:

Klona ett arkiv: menyn Fil → "Klona ett git-repo", där du anger arkivets URL och målmappen.
Hämta (pull): knappen "Hämta (pull)" för att hämta commits från remoten, med valfri merge- eller rebase-strategi ("Pull-strategi").
Brancher: branch-väljaren låter dig byta branch, skapa nya ("Ny branch...") och se fjärrbrancher.
Historik och diff: knappen "Historik" listar alla commits, och ett klick på en ändrad fil visar dess skillnader.
Konfliktlösning: vid konflikt under en sammanslagning eller en rebase kan du lösa dem i redigeraren och sedan fortsätta.
Ångra senaste commit: ändringarna från den ångrade commiten stannar kvar i indexet.
Komprimera arkivet: minskar utrymmet som arkivet tar upp (användbart för kvoten).
Inbyggd Git-terminal: visar loggen över de Git-kommandon som redigeraren har kört.