Artikel auf GitHub veröffentlichen

Verbinde GitHub einmalig, um jeden Clevera-Artikel als Markdown-Datei in einem Repository zu veröffentlichen – bereit für eine Dokumentationsseite, einen docs/-Ordner im Wiki-Stil oder eine README-Sammlung. Dieser Artikel behandelt das Verbinden, die Auswahl von Repository und Ordner, das Aussehen der Datei und wie Aktualisierungen funktionieren.

Bevor du beginnst#

• Plan: Das Veröffentlichen auf GitHub ist Teil der Pro- und Custom-Pläne. Bei Free und Starter zeigt der Tab Veröffentlichen den Hinweis "Das Veröffentlichen in deinen Tools ist in Pro enthalten". Siehe Einen Plan wählen.
• Rolle in Clevera: Nur der Workspace-Inhaber oder ein Administrator kann GitHub verbinden oder die Verbindung trennen. Sobald die Verbindung besteht, kann jeder, der einen Artikel bearbeiten darf, diesen auch veröffentlichen.
• Zugriff in GitHub: Die Person, die die Verbindung herstellt, benötigt Schreibzugriff auf die Repositories, in denen veröffentlicht werden soll, sowie das Recht, eine GitHub App auf dem persönlichen Konto oder der Organisation zu installieren (oder die Genehmigung durch einen Organisationsinhaber).
• Ein Artikel: Du veröffentlichst den Artikel, der zu einem Video oder einer Aufnahme gehört. Generiere ihn zuerst; siehe Eine Aufnahme in einen Artikel umwandeln.

Für das Veröffentlichen werden keine Credits verbraucht.

GitHub verbinden#

1. Integrationen öffnen#

   Öffne in der Seitenleiste das Workspace-Menü und wähle Integrationen. Suche unter Verfügbare Integrationen (oder im Tab Entwicklung) nach GitHub und klicke auf Verbinden. Die Schaltfläche erscheint, wenn du mit dem Mauszeiger auf die Karte zeigst.

   

2. Clevera auf GitHub autorisieren#

   GitHub fordert dich auf, die App Clevera AI zu autorisieren. Sie benötigt Lesezugriff auf deine Organisationsmitgliedschaften, damit Clevera die Konten auflisten kann, denen du angehörst. Klicke auf Autorisieren.

3. Die App in deinen Repositories installieren#

   GitHub öffnet daraufhin die Installationsseite für die Clevera AI-App. Wähle dein persönliches Konto oder eine Organisation aus und entscheide dich dann für Alle Repositories oder Nur ausgewählte Repositories. Die App fragt nach folgenden Berechtigungen:

   GitHub-Berechtigung	Grund
   Inhalte: Lesen und Schreiben	Zum Erstellen und Aktualisieren der Markdown-Datei und ihrer Bilder
   Metadaten: Nur Lesen	Von GitHub für jede App erforderlich; ermöglicht Clevera das Auflisten von Repositories

   Klicke auf Installieren. Wiederhole dies für jede Organisation, in der du veröffentlichen möchtest.

4. Verbindung prüfen#

   Zurück unter Integrationen wird GitHub in die Liste Verbunden verschoben, zusammen mit deinem GitHub-Konto- oder Organisationsnamen und einem Verbunden-Badge. Bevor du etwas veröffentlichst, steht dort "Noch nichts veröffentlicht".

   

Repositories später hinzufügen oder entfernen#

Clevera sieht nur Repositories, auf denen die App installiert ist. Um dies zu ändern, öffne Integrationen, klicke auf GitHub und unter Zugriff auf Repository-Zugriff. Öffne auf GitHub das Konto, klicke auf Konfigurieren und passe die Liste der Repositories an. Neue Repositories erscheinen, sobald du das nächste Mal den Tab Veröffentlichen öffnest.

Artikel veröffentlichen#

1. Den Tab Veröffentlichen öffnen#

   Klicke im Editor auf Teilen und öffne den Tab Veröffentlichen. Klicke unter Artikel veröffentlichen auf die GitHub-Kachel unter Bereit zur Veröffentlichung.

   Der Artikel wird in der Sprache veröffentlicht, die du gerade im Editor geöffnet hast. Wechsle zuerst die Sprache in der oberen Leiste, um eine Übersetzung zu veröffentlichen.

2. Konto, Repository und Ordner wählen#

   Wähle unter Zielort Folgendes aus:

   Feld	Auswahl	Hinweise
   Konto	Dein persönliches Konto oder eine Organisation	Wird nur angezeigt, wenn deine Repositories zu mehr als einem Konto gehören
   Repository	Das Repository für die Datei	Zuletzt aktualisierte zuerst. Das erste ist vorausgewählt
   Ordner	Ein Pfad wie docs oder articles/guides	"Die Markdown-Datei wird hier erstellt. Lass es leer für das Stammverzeichnis des Repositorys." Beginnt als docs. Ordner, die noch nicht existieren, werden erstellt

   Clevera merkt sich deine Auswahl für das nächste Mal.

   

3. Veröffentlichen#

   Klicke auf Auf GitHub veröffentlichen. Du siehst "Suche nach einer vorhandenen Kopie auf GitHub", dann Seite wird geschrieben. Wenn der Vorgang abgeschlossen ist, erscheint "Auf GitHub veröffentlicht". Klicke auf Auf GitHub öffnen, um die Datei anzusehen.

   Du kannst das Teilen-Fenster während des Vorgangs schließen; eine Benachrichtigung informiert dich, wenn er abgeschlossen ist.

Wo die Datei gespeichert wird#

• Branch: Der Standard-Branch des Repositorys (normalerweise main). Clevera committet direkt dorthin; es wird kein Pull Request geöffnet und du kannst keinen anderen Branch wählen.
• Dateiname: Der Titel in Kleinbuchstaben, mit Bindestrichen statt Leerzeichen, endend auf .md. "Create your first invoice" wird zu create-your-first-invoice.md. Titel in anderen Schriften oder mit Akzenten werden zuerst in lateinische Buchstaben umgewandelt ("Créer une facture" wird zu creer-une-facture.md). Ein Titel, der nicht umgewandelt werden kann, wie einer, der nur aus Emojis besteht, erhält stattdessen einen kurzen festen Code (article- plus 8 Zeichen). Namen werden bei 80 Zeichen abgeschnitten.
• Bilder: Die Screenshots des Artikels werden in assets/<file name>/ innerhalb desselben Ordners im selben Commit gespeichert.
• Commit-Nachricht: Add article: <title> oder Update article: <title>, wenn du eine bestehende Datei aktualisierst.
• Commit-Autor: Das GitHub-Konto, das die Integration verbunden hat.

Wie die Datei aussieht#

Clevera schreibt GitHub-flavoured Markdown mit einem kurzen Front-Matter-Block am Anfang:

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

Das Video, aus dem der Artikel stammt, wird der Datei nicht hinzugefügt. Ein Clevera-Video, das in den Artikel eingefügt wurde, wird zu einem Link zum Player, jedoch nur, wenn der Teilen-Link des Videos aktiviert ist. Siehe Ein Video in einem Artikel anzeigen.

Bilder#

Screenshots werden neben der Datei in dein Repository committet, und das Markdown verlinkt sie über einen relativen Pfad (assets/<file name>/…). Sie funktionieren auch ohne Clevera weiterhin, und in einem privaten Repository bleiben sie genauso privat wie der Rest.

Eine Videodatei, die du in den Artikel hochgeladen hast, wird nicht committet. Sie bleibt ein Link zu Clevera, der nach einiger Zeit abläuft; veröffentliche erneut, um ihn zu erneuern.

Verwendung mit einer Dokumentationsseite#

Die meisten Static-Site-Generatoren, die aus einem Repository bauen (wie Docusaurus, MkDocs, Jekyll oder Hugo), lesen title aus dem Front Matter und ignorieren Felder, die sie nicht kennen. Ein gängiges Setup:

1. Zeige mit dem Ordner auf den Ordner, den deine Dokumentationsseite liest, zum Beispiel docs oder content/guides.
2. Veröffentliche jeden Artikel dort; der normale Build deiner Seite übernimmt den neuen Commit.
3. Prüfe, ob dein Generator GitHub-Warnungen, Mathematik und <details> rendert; manche zeigen Warnungen als einfache Zitate an.

Einen bereits veröffentlichten Artikel aktualisieren#

Das Veröffentlichen funktioniert nur in eine Richtung. Änderungen, die du in Clevera vornimmst, bleiben in Clevera, bis du erneut veröffentlichst, und Änderungen, die an der Datei auf GitHub vorgenommen wurden, werden nicht nach Clevera zurückübertragen.

Wenn du im selben Repository und Ordner veröffentlichst, findet Clevera die Datei mit demselben Namen und zeigt "Dieser Artikel ist bereits auf GitHub vorhanden." Klicke auf Ansehen, um die bestehende Datei zu öffnen, und wähle dann:

Wenn sich der Titel in Clevera ändert, ändert sich auch der Dateiname. Daher erstellt das Veröffentlichen eine neue Datei neben der alten. Lösche oder benenne die alte Datei auf GitHub selbst um.

Nichts in Clevera löscht Dateien aus deinem Repository.

GitHub trennen#

1. Öffne Integrationen, klicke auf das ⋯-Menü in der GitHub-Zeile und wähle Trennen (oder klicke auf GitHub und dann auf Trennen).
2. Bestätige dies. „Du kannst nicht mehr aus dem Editor heraus darauf veröffentlichen. Bereits veröffentlichte Inhalte bleiben in GitHub erhalten.“

Das Trennen löscht das Zugriffstoken von Clevera. Um den Zugriff von Clevera auch auf GitHub zu entfernen, deinstalliere die Clevera AI-App (GitHub Einstellungen → Anwendungen → Installierte GitHub-Apps → Konfigurieren → Deinstallieren) und widerrufe die Autorisierung unter Autorisierte GitHub-Apps.

Fehlerbehebung#

Verwandte Themen#