Artikelen publiceren naar GitHub

Verbind GitHub één keer en je kunt elk Clevera-artikel naar een repository publiceren als een Markdown-bestand, klaar voor een documentatiesite, een docs/-map in wiki-stijl of een README-verzameling. 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 GitHub 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 werkruimte of een beheerder kan GitHub verbinden of loskoppelen. Zodra het is verbonden, kan iedereen die een artikel kan bewerken, het publiceren.
• Toegang in GitHub: de persoon die de verbinding maakt, heeft schrijftoegang nodig tot de repositories waarnaar je wilt publiceren, en het recht om een GitHub-app te installeren op dat persoonlijke account of die organisatie (of een organisatie-eigenaar moet het goedkeuren).
• 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.

GitHub verbinden#

1. Integraties openen#

   Open in de zijbalk het menu van de werkruimte en kies Integraties. Zoek GitHub onder Beschikbare integraties (of het tabblad Ontwikkeling) en klik op Verbinden. De knop verschijnt wanneer je op de kaart wijst.

   

2. Clevera autoriseren op GitHub#

   GitHub vraagt je om de Clevera AI-app te autoriseren. Het verzoekt om leestoegang tot je organisatielidmaatschappen, zodat Clevera de accounts kan weergeven waar je lid van bent. Klik op Autoriseren.

3. De app installeren op je repositories#

   GitHub opent vervolgens de installatiepagina voor de Clevera AI-app. Kies je persoonlijke account of een organisatie en kies vervolgens Alle repositories of Alleen geselecteerde repositories. De app vraagt om:

   GitHub-machtiging	Waarom
   Inhoud: lezen en schrijven	Om het Markdown-bestand en de bijbehorende afbeeldingen aan te maken en bij te werken
   Metadata: alleen-lezen	Vereist door GitHub voor elke app; laat Clevera repositories weergeven

   Klik op Installeren. Herhaal dit voor elke organisatie waarnaar je wilt publiceren.

4. De verbinding controleren#

   Terug bij Integraties verplaatst GitHub naar de lijst Verbonden met je GitHub-account of organisatienaam en een Verbonden-badge. Voordat je iets publiceert, staat er "Nog niets gepubliceerd".

   

Later repositories toevoegen of verwijderen#

Clevera ziet alleen repositories waarop de app is geïnstalleerd. Om dit te wijzigen, open je Integraties, klik je op GitHub en klik je onder Toegang op Repository-toegang. Open in GitHub het account, klik op Configureren en wijzig de lijst met repositories. Nieuwe repositories verschijnen de volgende keer dat je het tabblad Publiceren opent.

Een artikel publiceren#

1. Het tabblad Publiceren openen#

   Klik in de editor op Delen en open het tabblad Publiceren. Klik onder Het artikel publiceren op de GitHub-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. Het account, de repository en de map kiezen#

   Kies onder Waar het naartoe gaat:

   Veld	Wat te kiezen	Opmerkingen
   Account	Je persoonlijke account of een organisatie	Alleen getoond wanneer je repositories tot meer dan één account behoren
   Repository	De repository voor het bestand	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 hebt gekozen voor de volgende keer.

   

3. Publiceren#

   Klik op Publiceren naar GitHub. Je ziet "Zoeken naar een bestaande kopie in GitHub", daarna Pagina schrijven. Wanneer het klaar is, zie je "Gepubliceerd naar GitHub." Klik op Openen in GitHub 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 standaard branch van de repository (meestal main). Clevera commit direct naar deze branch; 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 in plaats daarvan een korte vaste code (article- plus 8 tekens). Namen worden afgekapt op 80 tekens.
• Afbeeldingen: de screenshots van het artikel gaan naar 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 GitHub-account dat de integratie heeft verbonden.

Hoe het bestand eruitziet#

Clevera schrijft GitHub-flavored Markdown met een kort front matter-blok bovenaan:

---
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 kwam, 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#

Screenshots 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 van de repository.

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.

Gebruiken met een documentatiesite#

De meeste statische-site-generatoren die bouwen vanuit een repository (zoals Docusaurus, MkDocs, Jekyll of Hugo) lezen title uit de front matter en negeren velden die ze niet kennen. Een veelvoorkomende opzet:

1. Wijs de Map aan naar de map die je documentatiesite leest, bijvoorbeeld docs of content/guides.
2. Publiceer elk artikel daar; de normale build van je site pikt de nieuwe commit op.
3. Controleer of je generator GitHub-waarschuwingen, wiskunde en <details> rendert; sommige tonen waarschuwingen als gewone citaten.

Een artikel bijwerken dat je al hebt gepubliceerd#

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

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

Als de titel in Clevera is gewijzigd, verandert de bestandsnaam ook. Bij het publiceren wordt er dus een nieuw bestand naast het oude aangemaakt. Verwijder of hernoem het oude bestand zelf op GitHub.

Niets in Clevera verwijdert bestanden uit je repository.

GitHub ontkoppelen#

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

Het verbreken van de verbinding verwijdert het toegangstoken van Clevera. Om de toegang van Clevera ook op GitHub te verwijderen, deïnstalleer je de Clevera AI app (GitHub Instellingen → Applicaties → Geïnstalleerde GitHub Apps → Configureren → Verwijderen) en trek je de autorisatie in onder Geautoriseerde GitHub Apps.

Probleemoplossing#

Gerelateerd#