Artikel auf GitLab veröffentlichen

Verbinde GitLab einmalig, um jeden Clevera-Artikel als Markdown-Datei in einem GitLab-Projekt zu veröffentlichen – bereit für eine Dokumentationsseite, einen docs/-Ordner oder ein Projekthandbuch. Dieser Artikel behandelt das Verbinden, die Auswahl von Projekt und Ordner, das Aussehen der Datei und wie Aktualisierungen funktionieren.

Bevor du beginnst#

• Plan: Die Veröffentlichung auf GitLab ist Teil der Pro- und Custom-Pläne. Bei Free und Starter zeigt der Tab Veröffentlichen den Hinweis "Die Veröffentlichung in deinen Tools ist in Pro enthalten". Siehe Einen Plan wählen.
• Rolle in Clevera: Nur der Workspace-Inhaber oder ein Administrator kann GitLab verbinden oder trennen. Sobald es verbunden ist, kann jeder, der einen Artikel bearbeiten darf, diesen auch veröffentlichen.
• Nur GitLab.com: Clevera verbindet sich mit GitLab.com. Selbst gehostete GitLab-Server werden nicht unterstützt.
• Rolle in GitLab: Clevera listet Projekte auf, in denen das verbindende Konto die Rolle „Developer“ oder höher hat. Um in einen geschützten Standard-Branch zu committen, benötigt das Konto in der Regel „Maintainer“-Rechte (siehe Geschützte Branches).
• Ein Artikel: Du veröffentlichst den Artikel, der zu einem Video oder einer Aufnahme gehört. Erstelle ihn zuerst; siehe Eine Aufnahme in einen Artikel umwandeln.

Die Veröffentlichung verbraucht keine Credits.

GitLab 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 GitLab und klicke auf Verbinden.

2. Bei GitLab anmelden und autorisieren#

   Melde dich bei GitLab.com an, falls du es noch nicht getan hast. GitLab bittet dich, Clevera mit den folgenden Berechtigungen zu autorisieren:

   GitLab-Berechtigung	Grund
   api	Die Datei-API von GitLab benötigt dies, um Dateien zu erstellen und zu aktualisieren
   read_user	Um deinen GitLab-Benutzernamen in Clevera anzuzeigen
   read_repository	Um zu prüfen, ob eine Datei bereits existiert
   write_repository	Um die Markdown-Datei und ihre Bilder zu committen

   Klicke auf Autorisieren.

3. Verbindung prüfen#

   Du kehrst zu Integrationen zurück, wo „GitLab erfolgreich verbunden mit“ gefolgt von deinem GitLab-Benutzernamen steht. GitLab verschiebt sich in die Liste Verbunden mit einem Verbunden-Badge. Bevor du etwas veröffentlichst, steht dort „Noch nichts veröffentlicht“.

Artikel veröffentlichen#

1. Tab „Veröffentlichen“ öffnen#

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

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

2. Projekt und Ordner wählen#

   Wähle unter Zielort Folgendes aus:

   Feld	Auswahl	Hinweise
   Repository	Das GitLab-Projekt für die Datei	Projekte, in denen du „Developer“ oder höher bist, sortiert nach letzter Aktualisierung. Das erste ist vorausgewählt
   Ordner	Ein Pfad wie docs oder articles/guides	„Die Markdown-Datei wird hier erstellt. Leer lassen für das Repository-Stammverzeichnis.“ Startet 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 GitLab veröffentlichen. Du siehst „Suche nach einer vorhandenen Kopie in GitLab“, dann Seite wird geschrieben. Wenn der Vorgang abgeschlossen ist, siehst du „Auf GitLab veröffentlicht“. Klicke auf In GitLab öffnen, um die Datei anzusehen.

   Du kannst das Teilen-Fenster schließen, während der Vorgang läuft; eine Benachrichtigung informiert dich, wenn er abgeschlossen ist.

Speicherort der Datei#

• Branch: Der Standard-Branch des Projekts (meist main). Clevera committet direkt dorthin; es wird kein Merge Request geöffnet und du kannst keinen anderen Branch wählen.
• Dateiname: Der Titel in Kleinbuchstaben, wobei Leerzeichen durch Bindestriche ersetzt werden, 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 (z. B. nur Emojis), erhält stattdessen einen kurzen festen Code (article- plus 8 Zeichen). Namen werden bei 80 Zeichen abgeschnitten.
• Bilder: Die Screenshots des Artikels landen in assets/<file name>/ innerhalb desselben Ordners, im selben Commit.
• Commit-Nachricht: Add article: <title> oder Update article: <title>, wenn du eine bestehende Datei aktualisierst.
• Commit-Autor: Das GitLab-Konto, das die Integration verbunden hat.

Geschützte Branches#

GitLab schützt den Standard-Branch standardmäßig, und normalerweise können nur Maintainer dorthin pushen. Wenn das verbundene Konto ein „Developer“ ist, wird der Commit mit „GitLab refused the commit: you need Developer access or higher, and the branch must not be protected“ abgelehnt. Gib dem Konto entweder die „Maintainer“-Rolle oder erlaube „Developer“-Nutzern das Pushen unter Einstellungen → Repository → Geschützte Branches im Projekt.

Aussehen der Datei#

Clevera schreibt Markdown, das von GitLab gerendert wird, 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 nicht zur Datei hinzugefügt. Ein Clevera-Video, das in den Artikel eingefügt wurde, wird zu einem Link zum Player, jedoch nur, wenn der Freigabelink des Videos aktiviert ist. Siehe Ein Video in einem Artikel anzeigen.

Bilder#

Screenshots werden neben der Datei in dein Projekt committet, und die Markdown-Links verweisen per relativem Pfad (assets/<file name>/…) darauf. Sie funktionieren auch ohne Clevera weiter, und in einem privaten Projekt 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#

Wenn GitLab Pages oder ein anderer Static-Site-Generator (wie MkDocs, Docusaurus oder Hugo) deine Dokumentation aus dem Projekt erstellt, verweise mit Ordner auf das Verzeichnis, das er liest. Jede Veröffentlichung ist ein normaler Commit, sodass deine Pipeline wie gewohnt läuft. Die meisten Generatoren lesen title aus dem Front-Matter und ignorieren unbekannte Felder.

Einen bereits veröffentlichten Artikel aktualisieren#

Die Veröffentlichung funktioniert nur in eine Richtung. Änderungen, die du in Clevera vornimmst, bleiben in Clevera, bis du erneut veröffentlichst, und Änderungen an der Datei in GitLab werden nicht nach Clevera zurückübertragen.

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

Wenn sich der Titel in Clevera geändert hat, ändert sich auch der Dateiname, sodass bei der Veröffentlichung eine neue Datei neben der alten erstellt wird. Lösche oder benenne die alte Datei in GitLab selbst um. Nichts in Clevera löscht Dateien aus deinem Projekt.

GitLab trennen#

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

Das Trennen löscht die Token von Clevera. Um den Zugriff von Clevera auch auf GitLab zu widerrufen, öffne dein GitLab-Avatar-Menü → Profil bearbeiten → Anwendungen, suche Clevera unter Autorisierte Anwendungen und klicke auf Widerrufen.

Fehlerbehebung#

Verwandt#