Migrar desde Decap CMS

Lo más importante primero: tus archivos de contenido no cambian en absoluto. Decap y PullPress leen y escriben los mismos archivos Markdown con el mismo frontmatter (YAML, TOML y JSON se conservan tal cual), en las mismas carpetas del mismo repositorio Git. La migración solo sustituye el acceso y la interfaz de edición: cada entrada, página e imagen se queda exactamente donde está, con todo su historial de Git.

1. 1

   Crea una cuenta de PullPress

   Regístrate con tu correo. Los redactores no necesitarán Netlify Identity, Git Gateway ni una cuenta de GitHub: inician sesión con un enlace mágico, igual que hacían con los correos de Identity.

2. 2

   Instala la GitHub App en el repositorio

   En el panel, elige “Conecta un sitio web” e instala la GitHub App de PullPress en el repositorio en el que escribía Decap. Puedes limitarla a ese único repositorio; consulta Configurar la GitHub App.

3. 3

   Importa tu configuración de Decap

   Cuando PullPress abre el sitio recién conectado, busca tu configuración de Decap en static/admin/config.yml, admin/config.yml o public/admin/config.yml y ofrece importarla: colecciones, widgets, carpeta de medios y ajustes multilingües se convierten automáticamente en un pullpress.config.yml. Elige “Importar la configuración de Decap CMS” y PullPress hace commit de la configuración convertida en tu repositorio; no se toca nada más.

   El importador también analiza una muestra de tu contenido real y la contrasta con la configuración. Donde no coinciden (por ejemplo, la configuración promete archivos planos pero tus entradas están cada una en su carpeta), gana la realidad, y cada diferencia aparece en las notas de importación y se conserva como comentario en la configuración generada. Los widgets que PullPress no puede convertir pasan a ser campos de texto y también se listan; nunca desaparecen en silencio.

   Widget de Decap	Campo de PullPress	Nota
   string / text / markdown	string / text / markdown
   number / boolean / color / code / hidden	mismos nombres
   datetime	datetime (o date sin parte horaria)
   image	image
   file	image	los enlaces existentes siguen funcionando
   select	select, o multiselect con multiple: true
   relation	relation
   object	object
   list (plain / field / fields)	list
   list with types	blocks	la clave de tipo se conserva (typeKey); las entradas siguen funcionando sin cambios
   map	map	puede que haya que convertir los valores GeoJSON
   todo lo demás	text	aparece en las notas de importación

4. 4

   Revisa la configuración convertida

   Abre el editor visual de configuración (sitio → Configuración) y repasa el resultado: etiquetas, tipos de campo, la carpeta de medios. Todo lo que el importador señaló se arregla aquí en una línea. El formato completo está en la referencia de configuración.

5. 5

   Invita a tus redactores por correo

   Añade, desde los ajustes de miembros del sitio, a cada persona que antes iniciaba sesión con Netlify Identity. Reciben una invitación con un enlace mágico y llegan directamente al editor: sin migrar cuentas, sin contraseñas que restablecer, sin cuentas de GitHub. Elige para cada persona si redacta, publica o solo revisa.

6. 6

   Retira el admin de Decap (cuando estés listo)

   Decap y PullPress pueden convivir mientras pruebas: editan los mismos archivos, así que solo evita editar la misma entrada en los dos a la vez. Cuando tus redactores se hayan cambiado, quita el widget del repositorio:

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

   También puedes desactivar Identity y Git Gateway en los ajustes del sitio en Netlify. Tu alojamiento no cambia: PullPress hace commit en GitHub y tu canal de build y despliegue lo recoge como cualquier otro push.

Preguntas habituales

¿Cambian mis URL o mis slugs? No. Los nombres de archivo existentes nunca se renombran. El importador incluso comprueba si tus entradas usan nombres de archivo con la fecha delante y mantiene las nuevas entradas coherentes con ellos.

Usábamos el flujo editorial de Decap, ¿hay un paso de revisión? Sí, integrado. Cada cambio es una rama y una pull request reales; los revisores aprueban con una comparación dentro de PullPress en lugar del flujo beta que solo funcionaba en GitHub.

¿Y el contenido multilingüe (i18n)? La estructura multiple_files de Decap (archivos hermanos como post.de.md) se traslada directamente. Las estructuras con una carpeta por idioma o con un solo archivo no se admiten; el importador te avisa cuando encuentra una.

Mira cómo se comparan los dos productos función por función en PullPress vs Decap CMS.