Overstappen van Decap CMS

Eerst het belangrijkste: je contentbestanden veranderen helemaal niet. Decap en PullPress lezen en schrijven dezelfde Markdown-bestanden met dezelfde frontmatter (YAML, TOML en JSON blijven alle drie behouden) in dezelfde mappen van dezelfde Git-repository. De overstap vervangt alleen het inloggen en de bewerkingsomgeving: elk bericht, elke pagina en elke afbeelding blijft precies waar die staat, met de volledige Git-geschiedenis.

1. 1

   Maak een PullPress-account aan

   Registreer je met je e-mailadres. Redacteuren hebben geen Netlify Identity, Git Gateway of GitHub-account nodig: ze loggen in met een magische link, net zoals ze vroeger deden met de mails van Identity.

2. 2

   Installeer de GitHub App op de repo

   Kies op het dashboard “Koppel een website” en installeer de PullPress GitHub App op de repository waarin Decap schreef. Je kunt hem beperken tot die ene repository; zie GitHub App instellen.

3. 3

   Importeer je Decap-configuratie

   Als PullPress de net gekoppelde site opent, zoekt het je Decap-configuratie in static/admin/config.yml, admin/config.yml of public/admin/config.yml en biedt aan om die te importeren: collecties, widgets, mediamap en instellingen voor meerdere talen worden automatisch omgezet naar een pullpress.config.yml. Kies “Decap CMS-configuratie importeren” en PullPress commit de omgezette configuratie naar je repo; verder wordt niets aangeraakt.

   De import bekijkt ook een steekproef van je echte content en vergelijkt die met de configuratie. Waar ze verschillen (bijvoorbeeld de configuratie belooft platte bestanden maar je items staan elk in een eigen map), wint de werkelijkheid, en elk verschil staat in de importnotities en blijft als commentaar in de gemaakte configuratie staan. Widgets die PullPress niet kan omzetten, worden gewone tekstvelden en staan ook in de lijst; ze verdwijnen nooit stilletjes.

   Decap-widget	PullPress-veld	Opmerking
   string / text / markdown	string / text / markdown
   number / boolean / color / code / hidden	dezelfde namen
   datetime	datetime (of date zonder tijdsdeel)
   image	image
   file	image	bestaande links blijven werken
   select	select, of multiselect met multiple: true
   relation	relation
   object	object
   list (plain / field / fields)	list
   list with types	blocks	de typesleutel gaat mee (typeKey); items blijven ongewijzigd werken
   map	map	GeoJSON-waarden moeten mogelijk omgezet worden
   al het andere	text	staat in de importnotities

4. 4

   Kijk de omgezette configuratie na

   Open de visuele configuratie-editor (site → Configuratie) en loop het resultaat door: labels, veldtypes, de mediamap. Alles wat de import markeerde, los je hier in één regel op. Het volledige formaat staat in de configuratiereferentie.

5. 5

   Nodig je redacteuren uit via e-mail

   Voeg via de ledeninstellingen van de site iedereen toe die vroeger via Netlify Identity inlogde. Ze krijgen een uitnodiging met een magische link en komen meteen in de editor terecht: geen accountmigratie, geen wachtwoorden om te resetten, geen GitHub-accounts. Kies per persoon of die schrijft, publiceert of alleen nakijkt.

6. 6

   Hef de Decap-admin op (als je klaar bent)

   Decap en PullPress kunnen naast elkaar bestaan terwijl je test: ze bewerken dezelfde bestanden, dus bewerk alleen niet hetzelfde item tegelijk in beide. Zijn je redacteuren overgestapt, haal de widget dan uit de 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>

   Je kunt ook Identity en Git Gateway uitzetten in de site-instellingen van Netlify. Je hosting verandert niet: PullPress commit naar GitHub, en je bestaande build- en deploypijplijn pikt dat op zoals elke andere push.

Veelgestelde vragen

Veranderen mijn URL’s of slugs? Nee. Bestaande bestandsnamen worden nooit hernoemd. De import kijkt zelfs of je items bestandsnamen met een datum vooraan gebruiken en houdt nieuwe items daarmee in lijn.

We gebruikten de redactionele workflow van Decap; is er een nakijkstap? Ja, ingebouwd. Elke wijziging is een echte branch en pull request; nakijkers keuren goed met een vergelijking binnen PullPress, in plaats van de bètaworkflow die alleen via GitHub werkte.

En content in meerdere talen (i18n)? De structuur multiple_files van Decap (bestanden naast elkaar zoals post.de.md) sluit er rechtstreeks op aan. De structuren met een map per taal en met één bestand worden niet ondersteund; de import meldt het als die er een tegenkomt.

Bekijk hoe de twee producten zich per functie verhouden op PullPress vs Decap CMS.