Decap CMS

Qué es Decap CMS en realidad

Decap CMS (github.com/decaporg/decap-cms) resuelve bien un problema muy concreto: tu sitio es una carpeta de archivos Markdown en un repositorio y la persona que quiere cambiar una frase no usa Git. Se instala bajo la ruta de administración del sitio que ya tienes. La versión rápida, en palabras del propio proyecto, es un único archivo HTML más un archivo de configuración, con el CMS cargado desde una CDN; la instalación completa pasa por npm y te deja más margen para personalizar. Un YAML declara tu modelo de contenido, el editor construye los formularios a partir de él y cada guardado se convierte en un commit.

La superficie de edición se arma con widgets, y el conjunto llega para la mayoría de los sitios: Markdown y texto enriquecido, imágenes y archivos, fechas, números, booleanos, selectores, listas y objetos anidados, además de un widget de relación para apuntar una entrada a otra. El inicio de sesión es conectable en vez de darse por supuesto: el repositorio trae backends para GitHub, GitLab, Bitbucket, Azure, Gitea y Forgejo, una pasarela de Git alojada y un proxy para editar en local. Los medios pueden vivir en el repositorio o irse a Cloudinary o Uploadcare. La licencia es MIT, y existe un plan de pago llamado Decap Turbo para equipos que quieran gestión centralizada de usuarios, roles más finos, un proxy de base de datos o acompañamiento con soporte.

Una nota de nombre que te ahorrará una hora de confusión: esto se llamaba Netlify CMS hasta febrero de 2023, y el propio README lo dice. Buena parte de los tutoriales que encontrarás siguen usando el nombre y el paquete antiguos, y la configuración ha cambiado desde que se escribieron.

El intercambio que estás haciendo

El modelo de un commit por guardado es todo el diseño, y corta por los dos lados. Tu contenido queda versionado por defecto y se puede revisar como una pull request si así lo quieres, de modo que un cambio de texto pasa por el mismo proceso que un cambio de código: algo genuinamente poco común y valioso en un equipo donde nadie sabe quién editó la portada. El coste es la latencia. Corregir una errata es un build, así que si el build tarda cuatro minutos, corregir la errata tarda cuatro minutos. En un sitio que publica cada semana esto da igual. En uno que publica cada hora es la herramienta equivocada, y lo correcto es algo con una base de datos detrás.

Ayuda situarlo frente a sus vecinos en vez de juzgarlo solo. Payload está en el otro extremo del mismo espectro — un framework completo con su propia base de datos, que es lo que quieres cuando el contenido es en realidad una aplicación. Ghost es un producto de publicación acabado más que una capa sobre tu repositorio. Decap es el más delgado de los tres, y lo delgado es justamente el punto: añade una pantalla de edición a un sitio que ya funciona y no se apropia de nada más.

Quién edita la página después de publicarla

No usamos Decap, así que esta página no afirma nada sobre operarlo. Lo que sí podemos contar de primera mano es la pregunta que viene a responder, porque llegamos a ella por el otro lado. Publicamos páginas de aterrizaje para nuestros propios clientes, y la interfaz de edición es una conversación: el cliente pide un cambio y el agente lo hace. Un cliente llevó una página por tres rondas de revisiones en una sola sesión, y lo llamativo fue dónde se fue el tiempo. Nada se fue en el editor. Todo se fue en decidir qué debía decir la página.

Ese es el argumento para mantener aburrida esta capa. Elijas lo que elijas, el cuello de botella se muda al texto en cosa de una semana, así que quédate con la opción que menos te cueste mantener y gasta la diferencia en las palabras. Si aun así pondríamos un editor sobre Git por delante de algo más pesado en un sitio pequeño es por una segunda lección, aprendida por las malas: lo que emite un generador de sitios estáticos es HTML terminado, lo que evita en silencio el fallo que nos costó meses de indexación en nuestras propias páginas renderizadas dinámicamente — que un rastreador reciba un esqueleto en lugar de una página. Un montaje que hace commit de Markdown y reconstruye un sitio estático no puede cometer ese error.

Publicar es también donde el herramental deja de ayudar. Un sitio que alguien puede editar no es un sitio que alguien haya leído, y el trabajo posterior — que te encuentren, que te elijan, que haya seguimiento — es una disciplina distinta de la que puso la página en línea. Ese es el hueco para el que está hecho AgentCeres — el AI Growth Officer, en agentceres.com: un equipo de marketing con IA gestionado que redacta el trabajo y espera a que una persona apruebe cualquier cosa que salga. Y si todavía estás eligiendo la base, AstroWind es una plantilla de partida más que un editor, y Webstudio es la respuesta de constructor visual a la misma pregunta.