El archivo index.html

DecapCMS es una excelente elección para crear un blog sencillo a empresas. Brinda una interfaz muy limpia para que el o los administradores del blog puedan escribir sus publicaciones, mientras que guarda todo como archivos .md en el proyecto.

Enlace: https://decapcms.org/

Utilizar DecapCMS en un proyecto de astro

Paso 1: Crear la carpeta del administrador

  • En el proyecto de Astro se crea la carpeta del administrador dentro de la carpeta public/.
  • Entra al proyecto, ve a la carpeta public/ y crea una subcarpeta llamada admin.
  • Dentro de public/admin/, se crean dos archivos:
    1. index.html
    2. config.yml

Paso 2: Contenido del archivo index.html

Abre el archivo public/admin/index.html y pega el siguiente código (es la interfaz de Decap CMS cargada desde un CDN estático):

Paso 3: El archivo public/admin/config.yml

Haz clic en el enlace para ver la explicación y el contenido del archivo

Paso 4: Probar en local

Para poder probar la interfaz en local sin necesidad de configurar autenticaciones de GitHub:

  1. Instala un pequeño proxy local para pruebas como administrador:

    pnpm add -D decap-server

  2. Añade a la sección de scripts de tu package.json:

    
"scripts": {
  "dev": "astro dev",
  "cms": "decap-server"
}

  3. Abre dos terminales:

    • En la primera ejecuta: pnpm dev
    • En la segunda ejecuta: pnpm cms

  4. Entra en tu navegador a: http://localhost:4321/admin/index.html

    Decap crea automáticamente el archivo Markdown en tu proyecto, pero Astro necesita dos cosas en el código para que esa entrada se vea en la web:

    • La página dinámica de la entrada individual (para ver el post completo al hacer clic)
    • La página de listado de entradas (un índice o blog donde se listen todos los posts creados).

Estas se guardan en /src/pages/blog, generalmente.(para una única colección destinada a un blog.)