Docs as Code
Inhalte als Markdown in einem Git-Repository, eine Website, die bei jedem Push neu entsteht. Kein CMS, keine Datenbank.
Lernplattform bauen
Diese Seite ist selbst das Lehrstück. Du baust eine Dokumentations-Website aus Markdown, versionierst sie mit Git, lässt sie von einer Pipeline prüfen und veröffentlichst sie automatisch auf einem Webserver.
Was dich erwartet
Abschnitt betitelt „Was dich erwartet“Astro Starlight
Ein Website-Generator für Dokumentation: Sidebar, Suche, Dark Mode und Komponenten gibt es geschenkt, eigene kommen dazu.
Git und GitLab
Repository, Branches, Merge Requests, Protected Branches und eine Pipeline, die prüft, baut und veröffentlicht.
Betrieb
rsync auf einen Webserver, ein eigener GitLab-Runner auf einer VM, Updates und Fehlersuche.
1 · ProjektstartDocs as Code, Node.js und npm, ein Starlight-Projekt anlegen und lokal laufen lassen.
2 · Inhalte schreibenMarkdown, MDX, Frontmatter, Sidebar, Starlight-Komponenten, Code-Blöcke und Diagramme.
3 · Komponenten und DesignEigene Astro-Komponenten wie Quiz und Lösung, Farben und Layout anpassen.
4 · Git und GitLabRepository anlegen, .gitignore, Protected Branches, Rollen, Merge-Request-Vorlage.
5 · Mehrere KurseEine Seite, mehrere Kurse mit eigener Sidebar: das Plugin starlight-sidebar-topics.
6 · PipelineGitLab-CI verstehen: Stages, Jobs, Images, Regeln. ShellCheck und Build automatisch.
7 · VeröffentlichenApache und .htaccess, rsync über SSH, der Deploy-Job mit CI-Variablen, Fehlersuche.
8 · Eigener RunnerWarum die Pipeline hängt und wie ein GitLab-Runner auf einer eigenen VM entsteht.
9 · Betrieb und ProjektAbhängigkeiten aktualisieren, Schlüssel und Backups, Abschlussprojekt: dein eigener Kurs.