Publicera artiklar till GitLab

Anslut GitLab en gång så kan du publicera valfri Clevera-artikel till ett GitLab-projekt som en Markdown-fil, redo för en dokumentationssida, en docs/-mapp eller en projekthandbok. Den här artikeln täcker anslutning, val av projekt och mapp, hur filen ser ut och hur uppdateringar fungerar.

Innan du börjar#

• Plan: publicering till GitLab ingår i Pro- och Custom-planerna. På Free och Starter visar fliken Publicera "Publicering till dina verktyg ingår i Pro". Se Välj en plan.
• Roll i Clevera: endast arbetsytans ägare eller en administratör kan ansluta eller koppla från GitLab. När det väl är anslutet kan vem som helst som kan redigera en artikel publicera den.
• Endast GitLab.com: Clevera ansluter till GitLab.com. Självhanterade GitLab-servrar stöds inte.
• Roll i GitLab: Clevera listar projekt där det anslutande kontot har rollen Utvecklare eller högre. För att göra en commit till en skyddad standardgren behöver kontot vanligtvis rollen Maintainer (se Skyddade grenar).
• En artikel: du publicerar artikeln som hör till en video eller inspelning. Generera den först; se Gör om en inspelning till en artikel.

Publicering förbrukar inga krediter.

Anslut GitLab#

1. Öppna Integrationer#

   Öppna menyn för arbetsytan i sidofältet och välj Integrationer. Hitta GitLab under Tillgängliga integrationer (eller fliken Utveckling) och klicka på Anslut.

2. Logga in på GitLab och auktorisera#

   Logga in på GitLab.com om du inte redan är det. GitLab ber dig att auktorisera Clevera med följande omfattningar:

   GitLab-omfattning	Varför
   api	GitLabs fil-API behöver det för att skapa och uppdatera filer
   read_user	För att visa ditt GitLab-användarnamn i Clevera
   read_repository	För att kontrollera om en fil redan finns
   write_repository	För att göra en commit av Markdown-filen och dess bilder

   Klicka på Auktorisera.

3. Kontrollera anslutningen#

   Du återvänder till Integrationer med "GitLab anslutet till" följt av ditt GitLab-användarnamn. GitLab flyttas till listan Ansluten med en Ansluten-bricka. Innan du publicerar något står det "Inget publicerat än".

Publicera en artikel#

1. Öppna fliken Publicera#

   I redigeraren, klicka på Dela och öppna fliken Publicera. Under Publicera artikeln, klicka på GitLab-rutan under Redo att publicera.

   Artikeln publiceras på det språk du har öppet i redigeraren. Byt språk i den översta raden först för att publicera en översättning.

2. Välj projekt och mapp#

   Under Vart den går, välj:

   Fält	Vad du ska välja	Anteckningar
   Databas	GitLab-projektet för filen	Projekt där du är Utvecklare eller högre, senast uppdaterade först. Det första är valt åt dig
   Mapp	En sökväg som docs eller articles/guides	"Markdown-filen skapas här. Lämna tom för databasens rot." Börjar som docs. Mappar som inte finns än skapas

   Clevera kommer ihåg vad du valde till nästa gång.

   

3. Publicera#

   Klicka på Publicera till GitLab. Du ser "Letar efter en befintlig kopia i GitLab", sedan Skriver sidan. När det är klart ser du "Publicerad till GitLab." Klicka på Öppna i GitLab för att se filen.

   Du kan stänga Dela-fönstret medan det körs; en avisering talar om för dig när det är klart.

Vart filen går#

• Gren: projektets standardgren (vanligtvis main). Clevera gör en commit direkt till den; den öppnar inte en merge request och du kan inte välja en annan gren.
• Filnamn: titeln med gemener, där mellanslag har ersatts med bindestreck, och som slutar på .md. "Create your first invoice" blir create-your-first-invoice.md. Titlar i andra alfabet eller med accenter stavas med latinska bokstäver först ("Créer une facture" blir creer-une-facture.md). En titel utan tecken att stava, som en gjord av endast emojis, får en kort fast kod istället (article- plus 8 tecken). Namn kapas vid 80 tecken.
• Bilder: artikelns skärmdumpar hamnar i assets/<file name>/ inuti samma mapp, i samma commit.
• Commit-meddelande: Add article: <title>, eller Update article: <title> när du uppdaterar en befintlig fil.
• Commit-författare: GitLab-kontot som anslöt integrationen.

Skyddade grenar#

GitLab skyddar standardgrenen som standard, och vanligtvis kan endast Maintainers pusha till den. Om det anslutna kontot är en Utvecklare nekas commiten med "GitLab refused the commit: you need Developer access or higher, and the branch must not be protected." Ge antingen det kontot rollen Maintainer, eller tillåt Utvecklare att pusha under Inställningar → Databas → Skyddade grenar i projektet.

Hur filen ser ut#

Clevera skriver Markdown som GitLab renderar, med ett kort front matter-block högst upp:

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

Videon som artikeln kom ifrån läggs inte till i filen. En Clevera-video placerad inuti artikeln blir en länk till dess spelare, endast när videons delningslänk är på. Se Visa en video i en artikel.

Bilder#

Skärmdumpar committas till ditt projekt bredvid filen, och Markdown-länkarna pekar på dem via relativ sökväg (assets/<file name>/…). De fortsätter fungera utan Clevera, och i ett privat projekt förblir de lika privata som resten av projektet.

En videofil som du laddat upp i artikeln committas inte. Den förblir en länk till Clevera som går ut efter en tid; publicera igen för att förnya den.

Använd med en dokumentationssida#

Om GitLab Pages eller en annan statisk sajtgenerator (som MkDocs, Docusaurus eller Hugo) bygger din dokumentation från projektet, peka Mapp mot mappen den läser från. Varje publicering är en vanlig commit, så din pipeline körs som vanligt. De flesta generatorer läser title från front matter och ignorerar fält de inte känner till.

Uppdatera en artikel du redan publicerat#

Publicering går bara åt ett håll. Ändringar du gör i Clevera stannar i Clevera tills du publicerar igen, och ändringar som görs i filen i GitLab kommer aldrig tillbaka till Clevera.

När du publicerar till samma projekt och mapp hittar Clevera filen med samma namn och visar "Den här artikeln finns redan i GitLab." Klicka på Visa den för att öppna den befintliga filen, välj sedan:

Om titeln ändrades i Clevera ändras filnamnet också, så publicering skapar en ny fil bredvid den gamla. Ta bort eller döp om den gamla filen i GitLab själv. Ingenting i Clevera tar bort filer från ditt projekt.

Koppla från GitLab#

1. Öppna Integrationer, klicka på ⋯-menyn på GitLab-raden och välj Koppla från (eller klicka på GitLab och sedan Koppla från).
2. Bekräfta. "Du kan inte längre publicera till den från redigeraren. Innehåll du redan publicerat stannar i GitLab."

Att koppla från tar bort Cleveras tokens. För att även återkalla Cleveras åtkomst på GitLab, öppna din GitLab-avatarmeny → Redigera profil → Applikationer, hitta Clevera under Auktoriserade applikationer och klicka på Återkalla.

Felsökning#

Relaterat#