Statische Website selbst pflegen: Decap CMS als Redaktion
Kurz gesagt: Statische Websites, gebaut mit Werkzeugen wie Hugo, Eleventy, Astro oder Jekyll, sind schnell, sicher und günstig zu betreiben. Der Haken für viele Betriebe: Inhalte liegen als Dateien in einem Git-Repository, und für jede neue Öffnungszeit oder jeden Blogbeitrag muss jemand aus der Technik ran. Decap CMS, früher als Netlify CMS bekannt, schließt diese Lücke. Es ist eine freie Redaktionsoberfläche, die im Browser läuft, Formulare für Seiten und Beiträge anbietet und Änderungen direkt als Commits ins Repository schreibt. Dieser Artikel zeigt, wie Decap CMS funktioniert, wie Sie es einrichten, wie ein Freigabeablauf aussieht und wo die Grenzen liegen.
Wie Decap CMS funktioniert
Laut Projektdokumentation ist Decap CMS ein quelloffenes Content-Management-System für den Git-Ablauf, das Redakteuren eine verständliche Oberfläche und Arbeitsabläufe bietet. Es lässt sich mit jedem Generator für statische Websites verwenden. Die Inhalte liegen im Git-Repository neben dem Code, was laut Dokumentation Versionierung und Veröffentlichung über mehrere Kanäle erleichtert. Technisch ist Decap eine React-Anwendung, die den Git-Ablauf umhüllt.
Für Ihr Team heißt das: Es gibt keine eigene Datenbank und keinen eigenen Server für das CMS. Die Redaktion öffnet eine Adresse wie ihrebetrieb.at/admin, meldet sich an, bearbeitet einen Beitrag in einem Formular und speichert. Decap erzeugt daraus eine Markdown- oder Datendatei im Repository. Ihr Hosting baut die Website danach automatisch neu.
Die Einrichtung in groben Schritten
1. Admin-Ordner anlegen. In Ihrem Projekt entsteht ein Ordner, meist /admin, mit einer kleinen HTML-Datei, die Decap lädt, und einer Konfigurationsdatei. Laut Dokumentation werden alle Optionen in einer Datei config.yml in dem Ordner festgelegt, über den die Redaktionsoberfläche aufgerufen wird.
2. Backend wählen. Decap muss wissen, wo das Repository liegt und wie sich die Redaktion anmeldet. Die Dokumentation listet unter anderem GitHub, GitLab, Bitbucket, Gitea bzw. Forgejo, Azure und Git Gateway als Backends. Für GitHub wird die Anmeldung meist über einen OAuth-Dienst abgewickelt, den Ihr Hosting bereitstellt oder den Sie selbst betreiben.
3. Medienordner festlegen. Laut Dokumentation ist die Einstellung media_folder Pflicht. Sie bestimmt, in welchem Ordner des Repositorys hochgeladene Dateien landen. Eine zweite Einstellung legt fest, unter welchem Pfad diese Dateien auf der fertigen Website erreichbar sind.
4. Sammlungen definieren. In collections beschreiben Sie, welche Inhaltsarten es gibt, etwa „Beiträge“, „Leistungen“ oder „Team“, und welche Felder jede hat: Titel, Datum, Bild, Text, Kategorie. Aus diesen Angaben baut Decap die Formulare.
Ein Formular, das die Redaktion versteht
Die Stärke von Decap liegt darin, dass Sie genau die Felder anbieten, die gebraucht werden. Statt eines leeren Texteditors bekommt das Team zum Beispiel für eine Veranstaltung die Felder Titel, Datum, Ort, Kurzbeschreibung, Bild und Anmeldelink. Pflichtfelder und Auswahllisten verhindern, dass etwas fehlt oder uneinheitlich geschrieben wird. Hilfetexte direkt am Feld erklären, wofür es da ist, etwa „Kurzbeschreibung: maximal zwei Sätze, erscheint in der Übersicht“.
Eine Vorschau zeigt, wie der Beitrag aussehen wird. Sie entspricht nicht immer exakt der fertigen Website, weil Decap die Seite nicht mit Ihrem Generator baut. Für eine echte Vorschau nutzen viele Teams Vorschau-Builds ihres Hostings.
Freigabe vor der Veröffentlichung
Laut Dokumentation werden Änderungen standardmäßig direkt in den Hauptzweig des Repositorys geschrieben, also sofort veröffentlicht. Mit der Option publish_mode: editorial_workflow schalten Sie einen redaktionellen Ablauf ein. Beiträge durchlaufen dann Stufen wie Entwurf, in Prüfung und bereit, und erst die Freigabe veröffentlicht sie. Technisch arbeitet Decap dabei mit eigenen Zweigen und Zusammenführungsanfragen im Repository.
Für Betriebe, in denen mehrere Personen schreiben und eine Person freigibt, ist dieser Ablauf meist die bessere Wahl. Er verhindert, dass ein halbfertiger Beitrag versehentlich online geht.
Grenzen kennen
Decap passt nicht für jede Website. Bedenken Sie:
- Bauzeit. Jede Änderung löst einen neuen Build aus. Bei großen Websites kann es einige Minuten dauern, bis sie online ist.
- Keine Benutzerkonten auf der Website. Decap verwaltet Inhalte, keine Kundenkonten, Shops oder Buchungen. Dafür brauchen Sie andere Lösungen.
- Bilder. Hochgeladene Bilder landen im Repository. Viele große Bilder machen das Repository schwer. Für umfangreiche Mediatheken bietet Decap Anbindungen an externe Mediendienste.
- Zugänge. Wer in Decap schreibt, braucht Zugang zum Repository über das gewählte Backend. Legen Sie Rechte bewusst fest.
Das Team einschulen
Eine Redaktionsoberfläche ist nur dann eine Entlastung, wenn das Team sie sicher bedienen kann. Planen Sie eine kurze Einschulung von einer Stunde, in der jede Person einen Beitrag anlegt, ein Bild hochlädt, einen Entwurf zur Prüfung gibt und eine Änderung zurücknimmt. Halten Sie die wichtigsten Schritte auf einer einseitigen Anleitung fest, die neben dem Feld „Hilfe“ in der Oberfläche verlinkt ist.
Klären Sie außerdem, wer bei Problemen hilft. Wenn ein Build fehlschlägt, etwa weil ein Pflichtfeld in einer alten Datei fehlt, sieht die Redaktion nur, dass die Änderung nicht online erscheint. Eine Benachrichtigung an die Agentur oder eine technisch zuständige Person bei fehlgeschlagenen Builds verhindert, dass Änderungen tagelang unbemerkt hängen. Weil jede Änderung als Commit im Repository steht, lässt sich auch nachvollziehen, wer was wann geändert hat, und eine fehlerhafte Änderung kann gezielt zurückgenommen werden.
Beispiel zur Veranschaulichung
Ein Tiroler Bergführerbüro (Beispiel zur Veranschaulichung) hat eine schnelle statische Website, aber jede neue Tour muss die Agentur einpflegen. Die Agentur richtet Decap CMS unter /admin ein, legt eine Sammlung „Touren“ mit Feldern für Titel, Datum, Schwierigkeit, Treffpunkt, Bild und Beschreibung an und aktiviert den redaktionellen Ablauf. Das Büroteam erstellt Touren selbst als Entwurf, die Leiterin gibt sie frei. Nach der Freigabe baut das Hosting die Seite neu, und die Tour ist wenige Minuten später online.
Typische Fehler
- Direktes Veröffentlichen ohne Freigabe, obwohl mehrere Personen schreiben.
- Allgemeine Textfelder statt klarer Felder für jede Inhaltsart.
- Große Originalfotos ohne Verkleinerung ins Repository laden.
- Redaktionszugänge über ein persönliches Konto der Agentur.
- Keine Erklärung, wie lange es bis zur Veröffentlichung dauert.
Häufige Fragen
Kostet Decap CMS etwas?
Decap ist quelloffen und kostenlos. Kosten können beim Hosting, beim Git-Dienst oder für einen Anmeldedienst entstehen.
Brauche ich dafür einen Server?
Nein, nicht für das CMS selbst. Es läuft im Browser und schreibt über das gewählte Backend ins Repository. Für die Anmeldung kann ein kleiner Dienst nötig sein.
Kann die Redaktion Seiten vorher ansehen?
Decap bietet eine eingebaute Vorschau. Für eine exakte Darstellung nutzen viele Teams zusätzlich Vorschau-Builds ihres Hostings.
Funktioniert das mit meinem Generator?
Laut Dokumentation lässt sich Decap mit jedem Generator für statische Websites verwenden, weil es nur Dateien im Repository schreibt.
Wenn Ihre statische Website schnell ist, aber das Pflegen der Inhalte immer über die Technik laufen muss, richten wir gern eine Redaktionsoberfläche für Ihr Team ein: Redaktion einrichten.