Von Decap CMS umsteigen

Das Wichtigste zuerst: Ihre Inhaltsdateien ändern sich überhaupt nicht. Decap und PullPress lesen und schreiben dieselben Markdown-Dateien mit demselben Frontmatter (YAML, TOML und JSON bleiben alle drei erhalten) in denselben Ordnern desselben Git-Repositorys. Der Umstieg ersetzt nur die Anmeldung und die Bearbeitungsoberfläche: Jeder Beitrag, jede Seite und jedes Bild bleibt genau, wo es ist, mit der vollständigen Git-Historie.

1. 1

   Ein PullPress-Konto anlegen

   Registrieren Sie sich mit Ihrer E-Mail-Adresse. Redakteure brauchen weder Netlify Identity noch Git Gateway noch ein GitHub-Konto: Sie melden sich mit einem magischen Link an, so wie früher mit den E-Mails von Identity.

2. 2

   Die GitHub App auf dem Repo installieren

   Wählen Sie im Dashboard „Website verbinden“ und installieren Sie die PullPress GitHub App auf dem Repository, in das Decap geschrieben hat. Sie können sie auf genau dieses Repository beschränken; siehe GitHub App einrichten.

3. 3

   Die Decap-Konfiguration importieren

   Wenn PullPress die frisch verbundene Site öffnet, sucht es Ihre Decap-Konfiguration unter static/admin/config.yml, admin/config.yml oder public/admin/config.yml und bietet an, sie zu importieren: Sammlungen, Widgets, Medienordner und mehrsprachige Einstellungen werden automatisch in eine pullpress.config.yml umgewandelt. Wählen Sie „Decap-CMS-Konfiguration importieren“, und PullPress committet die umgewandelte Konfiguration in Ihr Repo; sonst wird nichts angefasst.

   Der Import prüft außerdem eine Stichprobe Ihrer echten Inhalte und gleicht sie mit der Konfiguration ab. Wo beide sich widersprechen (etwa verspricht die Konfiguration flache Dateien, Ihre Einträge liegen aber jeweils in einem eigenen Ordner), gewinnt die Wirklichkeit, und jede Abweichung steht in den Importhinweisen und bleibt als Kommentar in der erzeugten Konfiguration. Widgets, die PullPress nicht zuordnen kann, werden einfache Textfelder und sind ebenfalls aufgeführt; sie fallen nie stillschweigend weg.

   Decap-Widget	PullPress-Feld	Hinweis
   string / text / markdown	string / text / markdown
   number / boolean / color / code / hidden	gleiche Namen
   datetime	datetime (oder date ohne Uhrzeit)
   image	image
   file	image	bestehende Links funktionieren weiter
   select	select, oder multiselect mit multiple: true
   relation	relation
   object	object
   list (plain / field / fields)	list
   list with types	blocks	der Typschlüssel wird übernommen (typeKey); Einträge funktionieren unverändert
   map	map	GeoJSON-Werte müssen eventuell umgewandelt werden
   alles andere	text	in den Importhinweisen aufgeführt

4. 4

   Die umgewandelte Konfiguration prüfen

   Öffnen Sie den visuellen Konfigurationseditor (Site → Konfiguration) und überfliegen Sie das Ergebnis: Beschriftungen, Feldtypen, der Medienordner. Alles, was der Import markiert hat, beheben Sie hier mit einer Zeile. Das vollständige Format steht in der Konfigurationsreferenz.

5. 5

   Die Redakteure per E-Mail einladen

   Fügen Sie über die Mitgliedereinstellungen der Site alle hinzu, die sich bisher über Netlify Identity angemeldet haben. Sie bekommen eine Einladung mit magischem Link und landen direkt im Editor: keine Kontomigration, keine Passwörter zum Zurücksetzen, keine GitHub-Konten. Wählen Sie pro Person, ob sie schreibt, veröffentlicht oder nur prüft.

6. 6

   Die Decap-Admin abschalten (wenn Sie so weit sind)

   Decap und PullPress können nebeneinander laufen, während Sie testen: Sie bearbeiten dieselben Dateien, vermeiden Sie also nur, denselben Eintrag gleichzeitig in beiden zu bearbeiten. Sobald Ihre Redakteure umgestiegen sind, entfernen Sie das Widget aus dem Repo:

   # the Decap admin panel
   git rm -r static/admin        # or admin/ or public/admin/
   
   # the Netlify Identity script, if your layout includes it
   # <script src="https://identity.netlify.com/v1/netlify-identity-widget.js"></script>

   Sie können außerdem Identity und Git Gateway in den Site-Einstellungen von Netlify abschalten. Ihr Hosting ändert sich nicht: PullPress committet auf GitHub, und Ihre bestehende Build- und Deploy-Pipeline greift das auf wie jeden anderen Push.

Häufige Fragen

Ändern sich meine URLs oder Slugs? Nein. Bestehende Dateinamen werden nie umbenannt. Der Import prüft sogar, ob Ihre Einträge Dateinamen mit vorangestelltem Datum nutzen, und hält neue Einträge damit einheitlich.

Wir haben den redaktionellen Workflow von Decap genutzt; gibt es einen Prüfschritt? Ja, eingebaut. Jede Änderung ist ein echter Branch und Pull Request; Prüfer geben mit einem Vergleich in PullPress frei, statt mit dem Beta-Workflow, der nur über GitHub lief.

Und mehrsprachige Inhalte (i18n)? Die Struktur multiple_files von Decap (Geschwisterdateien wie post.de.md) lässt sich direkt übernehmen. Die Strukturen mit einem Ordner pro Sprache und mit einer einzigen Datei werden nicht unterstützt; der Import sagt Bescheid, wenn er auf eine davon stößt.

Wie sich die beiden Produkte Funktion für Funktion vergleichen, sehen Sie unter PullPress vs Decap CMS.