Migrer depuis Decap CMS

Le plus important d’abord : vos fichiers de contenu ne changent pas du tout. Decap et PullPress lisent et écrivent les mêmes fichiers Markdown avec le même frontmatter (YAML, TOML et JSON sont tous conservés tels quels), dans les mêmes dossiers du même dépôt Git. La migration ne remplace que la connexion et l’interface d’édition : chaque article, chaque page et chaque image reste exactement à sa place, avec tout son historique Git.

1. 1

   Créez un compte PullPress

   Inscrivez-vous avec votre adresse e-mail. Les rédacteurs n’auront besoin ni de Netlify Identity, ni de Git Gateway, ni d’un compte GitHub : ils se connectent avec un lien magique, comme avec les e-mails d’Identity.

2. 2

   Installez la GitHub App sur le dépôt

   Depuis le tableau de bord, choisissez « Connecter un site web » et installez la GitHub App de PullPress sur le dépôt dans lequel Decap écrivait. Vous pouvez la limiter à ce seul dépôt ; voir Configurer la GitHub App.

3. 3

   Importez votre configuration Decap

   Quand PullPress ouvre le site fraîchement connecté, il cherche votre configuration Decap dans static/admin/config.yml, admin/config.yml ou public/admin/config.yml et propose de l’importer : collections, widgets, dossier des médias et réglages multilingues sont convertis automatiquement en un pullpress.config.yml. Choisissez « Importer la configuration Decap CMS » et PullPress commite la configuration convertie dans votre dépôt ; rien d’autre n’est touché.

   L’import examine aussi un échantillon de votre contenu réel et le compare à la configuration. Là où ils divergent (par exemple la configuration promet des fichiers à plat alors que vos entrées sont chacune dans un dossier), la réalité l’emporte, et chaque écart est listé dans les notes d’import et conservé en commentaire dans la configuration générée. Les widgets que PullPress ne sait pas convertir deviennent de simples champs texte et sont listés aussi ; ils ne disparaissent jamais en silence.

   Widget Decap	Champ PullPress	Remarque
   string / text / markdown	string / text / markdown
   number / boolean / color / code / hidden	mêmes noms
   datetime	datetime (ou date sans partie horaire)
   image	image
   file	image	les liens existants continuent de fonctionner
   select	select, ou multiselect avec multiple: true
   relation	relation
   object	object
   list (plain / field / fields)	list
   list with types	blocks	la clé de type est reprise (typeKey) ; les entrées fonctionnent sans changement
   map	map	les valeurs GeoJSON peuvent nécessiter une conversion
   tout le reste	text	listé dans les notes d’import

4. 4

   Vérifiez la configuration convertie

   Ouvrez l’éditeur visuel de configuration (site → Configuration) et parcourez le résultat : libellés, types de champs, dossier des médias. Tout ce que l’import a signalé se corrige ici en une ligne. Le format complet est dans la référence de configuration.

5. 5

   Invitez vos rédacteurs par e-mail

   Ajoutez, depuis les réglages des membres du site, chaque personne qui se connectait via Netlify Identity. Elles reçoivent une invitation avec un lien magique et arrivent directement dans l’éditeur : pas de migration de comptes, pas de mots de passe à réinitialiser, pas de comptes GitHub. Choisissez pour chacune si elle rédige, publie ou se contente de relire.

6. 6

   Retirez l’admin Decap (quand vous êtes prêt)

   Decap et PullPress peuvent cohabiter pendant vos tests : ils modifient les mêmes fichiers, évitez donc simplement de modifier la même entrée dans les deux à la fois. Une fois vos rédacteurs passés à PullPress, retirez le widget du dépôt :

   # 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>

   Vous pouvez aussi désactiver Identity et Git Gateway dans les paramètres du site Netlify. Votre hébergement ne change pas : PullPress commite sur GitHub, et votre chaîne de build et de déploiement existante le prend en charge comme n’importe quel autre push.

Questions fréquentes

Mes URL ou mes slugs changent-ils ? Non. Les noms de fichiers existants ne sont jamais renommés. L’import vérifie même si vos entrées utilisent des noms de fichiers préfixés par une date et garde les nouvelles entrées cohérentes avec eux.

Nous utilisions le workflow éditorial de Decap : y a-t-il une étape de relecture ? Oui, intégrée. Chaque modification est une vraie branche et une vraie pull request ; les relecteurs approuvent avec une comparaison dans PullPress au lieu du workflow bêta réservé à GitHub.

Et le contenu multilingue (i18n) ? La structure multiple_files de Decap (fichiers voisins comme post.de.md) se transpose directement. Les structures avec un dossier par langue ou un seul fichier ne sont pas prises en charge ; l’import vous prévient quand il en rencontre une.

Voyez comment les deux produits se comparent fonction par fonction sur PullPress vs Decap CMS.