Publicera artiklar till Bitbucket

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

Innan du börjar#

• Plan: att publicera till Bitbucket 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 Bitbucket. När den väl är ansluten kan alla som kan redigera en artikel publicera den.
• Endast Bitbucket Cloud: Clevera ansluter till bitbucket.org. Bitbucket Data Center och Server stöds inte.
• Åtkomst i Bitbucket: kontot som ansluter måste ha behörighet att bidra till de databaser du vill publicera till, med skrivbehörighet till huvud-branchen.
• 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 Bitbucket#

1. Öppna Integrationer#

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

2. Ge åtkomst i Bitbucket#

   Logga in på Bitbucket om du inte redan är det. Bitbucket ber dig att ge Clevera åtkomst:

   Bitbucket-behörighet	Varför
   Konto: läs	För att visa ditt Bitbucket-namn i Clevera
   Databaser: läs	För att lista databaser och kontrollera om en fil redan finns
   Databaser: skriv	För att committa Markdown-filen och dess bilder

   Klicka på Ge åtkomst.

3. Kontrollera anslutningen#

   Du återvänder till Integrationer med texten "Bitbucket ansluten till" följt av ditt Bitbucket-namn. Bitbucket flyttas till listan Ansluten med en Ansluten-bricka. Innan du publicerar något står det "Inget publicerat ännu".

Publicera en artikel#

1. Öppna fliken Publicera#

   I editorn klickar du på Dela och öppnar fliken Publicera. Under Publicera artikeln, klicka på Bitbucket-rutan under Redo att publicera.

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

2. Välj databas och mapp#

   Under Vart den går, välj:

   Fält	Vad du ska välja	Noteringar
   Databas	Bitbucket-databasen för filen	Databaser du kan bidra till, över dina Bitbucket-arbetsytor, sorterade efter senast uppdaterad. Den första är förvald å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 ännu skapas

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

   

3. Publicera#

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

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

Vart filen går#

• Branch: databasens huvud-branch (vanligtvis main eller master). Clevera committar direkt till den; den öppnar ingen pull request och du kan inte välja en annan branch.
• Filnamn: titeln i gemener, med mellanslag ändrade till bindestreck, 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: Bitbucket-kontot som anslöt integrationen.

Branch-begränsningar#

Om databasen har en branch-begränsning på huvud-branchen (till exempel att ändringar endast får ske via pull requests, eller att skrivning är begränsad till vissa personer), nekas Cleveras commit, till exempel med "You need write access to commit to this Bitbucket repository." Lägg till det anslutna kontot till personerna som kan skriva till branchen under Repository settings → Branch restrictions, eller publicera till en databas utan den regeln.

Hur filen ser ut#

Clevera skriver ren Markdown som Bitbuckets filvy kan visa, med ett kort front matter-block högst upp. Den innehåller ingen rå HTML, eftersom Bitbucket inte renderar det.

---
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 din databas 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 en privat databas förblir de lika privata som resten av den.

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 en statisk sajtgenerator (som MkDocs, Docusaurus eller Hugo) bygger din dokumentation från databasen, peka Mapp på mappen den läser från. Varje publicering är en vanlig commit, så Bitbucket Pipelines eller dina andra byggen 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 Bitbucket kommer aldrig tillbaka till Clevera.

När du publicerar till samma databas och mapp hittar Clevera filen med samma namn och visar "Denna artikel finns redan i Bitbucket." Klicka på Visa den för att öppna den befintliga filen, välj sedan:

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

Koppla från Bitbucket#

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

Att koppla från tar bort Cleveras tokens. För att även återkalla Cleveras åtkomst i Bitbucket, öppna dina Personliga inställningar i Bitbucket, gå till App-auktoriseringar och återkalla Clevera.

Felsökning#

Relaterat#