Artikelen publiceren naar Bitbucket

Verbind Bitbucket één keer en je kunt elk Clevera-artikel publiceren naar een Bitbucket-repository als Markdown-bestand, klaar voor een documentatiesite of een docs/-map naast je code. Dit artikel behandelt het verbinden, het kiezen van de repository en map, hoe het bestand eruitziet en hoe updates werken.

Voordat je begint#

• Abonnement: publiceren naar Bitbucket is onderdeel van de Pro- en Custom-abonnementen. Bij Free en Starter toont het tabblad Publiceren "Publiceren naar je tools is inbegrepen in Pro". Zie Kies een abonnement.
• Rol in Clevera: alleen de eigenaar van de workspace of een beheerder kan Bitbucket verbinden of de verbinding verbreken. Zodra het verbonden is, kan iedereen die een artikel kan bewerken, het publiceren.
• Alleen Bitbucket Cloud: Clevera maakt verbinding met bitbucket.org. Bitbucket Data Center en Server worden niet ondersteund.
• Toegang in Bitbucket: het verbindende account moet kunnen bijdragen aan de repositories waarnaar je wilt publiceren, met schrijftoegang tot de hoofd-branch.
• Een artikel: je publiceert het artikel dat bij een video of opname hoort. Genereer het eerst; zie Een opname omzetten in een artikel.

Voor publiceren worden geen credits gebruikt.

Bitbucket verbinden#

1. Open Integraties#

   Open in de zijbalk het workspace-menu en kies Integraties. Zoek Bitbucket onder Beschikbare integraties (of het tabblad Ontwikkeling) en klik op Verbinden.

2. Toegang verlenen in Bitbucket#

   Meld je aan bij Bitbucket als je dat nog niet hebt gedaan. Bitbucket vraagt je om Clevera toegang te verlenen:

   Bitbucket-toestemming	Waarom
   Account: lezen	Om je Bitbucket-naam in Clevera te tonen
   Repositories: lezen	Om repositories weer te geven en te controleren of een bestand al bestaat
   Repositories: schrijven	Om het Markdown-bestand en de afbeeldingen te committen

   Klik op Toegang verlenen.

3. De verbinding controleren#

   Je keert terug naar Integraties met "Bitbucket succesvol verbonden met" gevolgd door je Bitbucket-naam. Bitbucket verplaatst naar de lijst Verbonden met een Verbonden-badge. Voordat je iets publiceert, staat er "Nog niets gepubliceerd".

Een artikel publiceren#

1. Open het tabblad Publiceren#

   Klik in de editor op Delen en open het tabblad Publiceren. Klik onder Het artikel publiceren op de Bitbucket-tegel onder Klaar om te publiceren.

   Het artikel wordt gepubliceerd in de taal die je in de editor hebt geopend. Wissel eerst van taal in de bovenste balk om een vertaling te publiceren.

2. Kies de repository en map#

   Kies onder Waar het naartoe gaat:

   Veld	Wat te kiezen	Opmerkingen
   Repository	De Bitbucket-repository voor het bestand	Repositories waaraan je kunt bijdragen, in je Bitbucket-workspaces, meest recent bijgewerkt eerst. De eerste is voor je geselecteerd
   Map	Een pad zoals docs of articles/guides	"Het Markdown-bestand wordt hier aangemaakt. Laat leeg voor de root van de repository." Begint als docs. Mappen die nog niet bestaan, worden aangemaakt

   Clevera onthoudt wat je de volgende keer hebt gekozen.

   

3. Publiceren#

   Klik op Publiceren naar Bitbucket. Je ziet "Zoeken naar een bestaande kopie in Bitbucket", daarna Pagina schrijven. Wanneer het klaar is, zie je "Gepubliceerd naar Bitbucket." Klik op Openen in Bitbucket om het bestand te bekijken.

   Je kunt het venster Delen sluiten terwijl het proces loopt; een melding vertelt je wanneer het klaar is.

Waar het bestand naartoe gaat#

• Branch: de hoofd-branch van de repository (meestal main of master). Clevera commit direct hiernaartoe; het opent geen pull request en je kunt geen andere branch kiezen.
• Bestandsnaam: de titel in kleine letters, met spaties veranderd in koppeltekens, eindigend op .md. "Create your first invoice" wordt create-your-first-invoice.md. Titels in andere schriften of met accenten worden eerst in Latijnse letters geschreven ("Créer une facture" wordt creer-une-facture.md). Een titel waar niets meer van te maken valt, zoals een titel die alleen uit emoji bestaat, krijgt een korte vaste code (article- plus 8 tekens). Namen worden afgekapt op 80 tekens.
• Afbeeldingen: de schermafbeeldingen van het artikel komen in assets/<file name>/ in dezelfde map, in dezelfde commit.
• Commit-bericht: Add article: <title>, of Update article: <title> wanneer je een bestaand bestand bijwerkt.
• Commit-auteur: het Bitbucket-account dat de integratie heeft verbonden.

Branch-beperkingen#

Als de repository een branch-beperking heeft op de hoofd-branch (bijvoorbeeld wijzigingen alleen via pull requests, of schrijven beperkt tot bepaalde personen), wordt de commit van Clevera geweigerd, bijvoorbeeld met "You need write access to commit to this Bitbucket repository." Voeg het verbonden account toe aan de personen die naar de branch kunnen schrijven onder Repository settings → Branch restrictions, of publiceer naar een repository zonder die regel.

Hoe het bestand eruitziet#

Clevera schrijft standaard Markdown die de bestandsweergave van Bitbucket kan tonen, met een kort front matter-blok bovenaan. Het bevat geen raw HTML, omdat Bitbucket dit niet rendert.

---
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"
---

De video waar het artikel vandaan komt, wordt niet aan het bestand toegevoegd. Een Clevera-video die in het artikel is geplaatst, wordt een link naar de speler, alleen wanneer de deellink van die video aan staat. Zie Een video tonen in een artikel.

Afbeeldingen#

Schermafbeeldingen worden naar je repository gecommit naast het bestand, en de Markdown linkt ernaar via een relatief pad (assets/<file name>/…). Ze blijven werken zonder Clevera, en in een privé-repository blijven ze net zo privé als de rest.

Een videobestand dat je in het artikel hebt geüpload, wordt niet gecommit. Het blijft een link naar Clevera die na een tijdje verloopt; publiceer opnieuw om deze te vernieuwen.

Gebruik met een documentatiesite#

Als een static-site generator (zoals MkDocs, Docusaurus of Hugo) je documentatie bouwt vanuit de repository, wijs Map dan naar de map die deze leest. Elke publicatie is een normale commit, dus Bitbucket Pipelines of je andere build-runs werken zoals gebruikelijk. De meeste generators lezen title uit de front matter en negeren velden die ze niet kennen.

Een al gepubliceerd artikel bijwerken#

Publiceren werkt maar één kant op. Bewerkingen die je in Clevera maakt, blijven in Clevera totdat je opnieuw publiceert, en wijzigingen die in Bitbucket aan het bestand zijn gemaakt, komen nooit terug in Clevera.

Wanneer je naar dezelfde repository en map publiceert, vindt Clevera het bestand met dezelfde naam en toont "Dit artikel staat al in Bitbucket." Klik op Bekijken om het bestaande bestand te openen en kies vervolgens:

Als de titel in Clevera is gewijzigd, verandert de bestandsnaam ook, dus publiceren maakt een nieuw bestand naast het oude. Verwijder of hernoem het oude bestand zelf in Bitbucket. Niets in Clevera verwijdert bestanden uit je repository.

Bitbucket-verbinding verbreken#

1. Open Integraties, klik op het ⋯-menu op de Bitbucket-rij en kies Verbinding verbreken (of klik op Bitbucket en daarna op Verbinding verbreken).
2. Bevestig. "Je kunt er niet langer naar publiceren vanuit de editor. Inhoud die je al hebt gepubliceerd, blijft in Bitbucket."

Het verbreken van de verbinding verwijdert de tokens van Clevera. Om de toegang van Clevera ook op Bitbucket in te trekken, open je je Bitbucket Personal settings, ga je naar App authorizations en trek je de toegang van Clevera in.

Problemen oplossen#

Gerelateerd#