CI/CD-Pipeline einrichten#

So konfigurierst du die GitLab CI/CD-Pipeline, die aus deinen Markdown-Dateien eine statische Webseite baut und veröffentlicht.

Grundkonfiguration#

Erstelle eine .gitlab-ci.yml im Root deines Projekts:

Das ist die Minimalkonfiguration. Die Pipeline baut die Webseite aus dem Ordner dokument und veröffentlicht sie als GitLab Pages.

Alle Inputs der md-to-web-Komponente#

Der einzige Input, den du in der Regel angeben musst, ist md-path — der Pfad zum Ordner mit deinen Markdown-Dateien (Default: "document").

Die vollständige Liste aller verfügbaren Inputs mit Typen, Defaults und Beschreibungen findest du in der Referenz der CI/CD-Komponenten.

Vollständiges Beispiel#

Zusätzliche CI-Komponenten#

Neben der Webseiten-Generierung stehen weitere CI-Komponenten zur Verfügung:

• Barrierefreiheitsprüfung — Automatische Prüfung mit pa11y-ci
• Link-Prüfung — Automatische Prüfung auf tote Links mit Lychee

Pipeline manuell starten#

Nach der ersten Konfiguration musst du die Pipeline einmalig manuell starten:

1. Navigiere unter Build → Pipelines
2. Klicke auf New pipeline
3. Branch auf main, keine Variablen
4. Klicke auf New pipeline

Danach löst jeder Commit automatisch einen neuen Build aus.