Forbind GitHub

Notions forbindelse med GitHub giver dig mulighed for problemfrit at forbinde dine udviklingsarbejdsgange. Du kan linke GitHub-indhold direkte på Notion-sider, trække GitHub-oplysninger ind i Notion-databaser og synkronisere pull requests med Notion-opgaver for at holde dit team informeret om projektstatusser. Læs videre for at lære om de forskellige funktioner i forbindelsen, og hvordan du kan konfigurere dem.

Du skal være både ejer af et Notion-arbejdsområde og GitHub-organisationens administrator for at forbinde Notion med GitHub-workspace-appen.

1. Gå til Indstillinger i sidemenuen → Forbindelser.

2. Find GitHub (Workspace).

3. Klik på Connect, og gennemfør godkendelsesflowet.

Link til en fil eller specifikke linjer fra en fil direkte i Notion. Du kan endda linke fra et specifikt commit eller en branch, hvis du vil have, at den kode, du refererer til, skal være opdateret.

1. Kopiér permalink for de ønskede linjer fra GitHub.

2. Indsæt det på en Notion-side, og vælg Paste as preview for at integrere koden på din side.

Du kan synkronisere dine GitHub-repositories (inklusive pull requests og issues) til Notion som databaser. Sådan gør du:

1. I GitHub skal du kopiere linket til en PR eller et issue.

2. Indsæt linket i Notion, og vælg Paste as database.

   • Hvis du ikke allerede har gjort det, bliver du bedt om at logge ind og forbinde Notion med din GitHub-konto.

3. Den Synkroniseret database oprettes i en /tabelvisning, hvor alle GitHub-egenskaber tilføjes automatisk.

4. Databasen vil begynde at blive fyldt automatisk og fortsætte med at synkronisere, hvis du navigerer væk fra siden.

Her er en liste over de GitHub-egenskaber, vi understøtter:

Labels og tags understøttes ikke på nuværende tidspunkt.

Du kan bruge identitetsmapping til at forbinde GitHub-identiteter med teamets Notion-profiler.

1. Naviger til dine GitHub-mailindstillinger, og sørg for, at indstillingen Hold mine mailadresser privateikke er markeret.

2. I din GitHub-profil (https://github.com/{YOUR_USERNAME_HERE}) skal du redigere din profil for at tilføje din Notion-e-mailadresse.

Dette gør det muligt at mappe din identitet til synkroniserede databaser i arbejdsområder, hvor du er medlem.

GitHub Pull Request-egenskaben i din Notion-database holder automatisk dine tværfaglige teams informeret om opgavestatusser. Den har også mange attributter, som du kan bruge i rollups, formler og filtre.

1. I en Notion-database skal du klikke på + for at tilføje en ny egenskab.

2. Søg efter og klik på GitHub Pull Requests for at tilføje denne egenskab til din database.

   • Hvis du ikke kan se listen over GitHub Pull Requests-egenskaber, skal du gå til Indstillinger → Flere indstillinger → Forbindelser → Tilføj GitHub Pull Request.

3. Sørg for, at din database har en Unik ID-egenskab. Denne egenskab tilføjes til din database, hvis den ikke allerede har en.

4. For at bruge GitHub Pull Request-egenskaben skal du sikre dig, at du har forbundet din GitHub-konto med Notion. Tilføj derefter enten det unikke ID for Notion-opgaven til pull-anmodningen, eller indsæt URL'en til GitHub-pull-anmodningen i egenskaben.

Som standard aktiverer Notion backlinks på Notion-opgaver til GitHub. Hvis du vil slå dette fra, skal du klikke på GitHub Pull Request-egenskaben i din database → Rediger egenskab. Slå Tilbagelinks i GitHub fra.

Du kan bruge GitHub Pull Requests-egenskaben til automatisk at opdatere status for dine opgaver i Notion.

1. Vælg titlen på din GitHub Pull Requests-egenskab, og klik på Rediger egenskab.

2. Find sektionen Auto-update, og vælg den status-egenskab, du vil opdatere, fra rullemenuen.

3. Vælg den opgavestatus, der skal indstilles, når GitHub PR'en er åbnet, har anmodet om review, er godkendt og er flettet.

4. Når PR'en skrider frem i GitHub, opdateres din opgavestatus i Notion automatisk baseret på dine indstillinger.

Du kan også vise GitHub-aktivitet i den /tilknyttet Notion-opgave. For at gøre dette skal du klikke på GitHub-egenskaben i din database → Rediger egenskab. Slå Activity Comments til.

Hvis du vil linke en GitHub PR til en eller flere Notion-opgaver, skal du blot indtaste et magisk ord og Notion-opgavernes unique ID i din PR-beskrivelse.

Magiske ord er nøgleord, der hjælper med at etablere relationer mellem Notion-opgaver og GitHub PR'er. Du kan bruge et af følgende ord:

• close, closes, closed

• fix, fixes, fixed

• resolve, resolves, resolved

• complete, completes, completed, completing

• ref, references

• part of

• related to

• contributes to

• towards

Din PR kunne for eksempel have beskrivelsen "fixes CTT-13". Når beskrivelsen er angivet, vil din Notion-opgave med ID'et CTT-13 blive linket til den PR.

Hvis din PR-beskrivelse bruger magiske ord, der er knyttet til at lukke eller færdiggøre en opgave, markeres Notion-opgaven som Færdig, når PR'en flettes.

Hvis din PR-beskrivelse bruger magiske ord, der er knyttet til at referere til eller relatere til en opgave, markeres Notion-opgaven ikke som Færdig, når PR'en flettes.

Du kan linke Notion-opgaver som kun-reference, så disse opgaver ikke markeres som Færdig.

For at afbryde forbindelsen mellem GitHub og Notion skal du være ejer af et Notion-arbejdsområde.

1. Gå til Indstillinger.

2. Vælg Forbindelser.

3. Ud for GitHub skal du vælge ••• → Afbryd forbindelse for alle brugere.

Når du afbryder forbindelse mellem GitHub og Notion, vil ingen i dit arbejdsområde kunne bruge forbindelsen, før den er konfigureret igen.