Clase 06 · Módulo 05
Contenido editable: blog y colecciones
Contenido editable: blog y colecciones
Qué logras en esta clase
Tu web deja de tener el contenido enterrado en el código.
- Decides qué partes de tu sitio merecen una colección.
- Entiendes las tres piezas: archivos, esquema y páginas.
- Publicas una entrada nueva creando un solo archivo.
02
Contenido y diseño en lugares distintos
Publicar un artículo debería ser escribir un texto, no editar una página.
03
El problema de escribir dentro de la página
Si cada artículo es un archivo .astro con su HTML, pasan tres cosas:
- Cada entrada nueva obliga a copiar la estructura de la anterior.
- Un cambio de diseño hay que repetirlo en todas.
- Nadie garantiza que todas tengan fecha, título o imagen.
Con tres artículos se aguanta. Con treinta, el sitio ya no se puede mantener.
04
Qué es una colección
Una colección de contenido es un grupo de archivos del mismo tipo, por ejemplo todos los artículos del blog, que Astro lee, valida y entrega a tus páginas como datos ordenados.
Cada archivo es una entrada. Lo habitual es escribirlas en Markdown, el formato de texto simple que ya conoces de CLAUDE.md.
05
Las piezas y cómo se conectan
Escribes archivos. El esquema comprueba que estén completos. Dos páginas los muestran: una con la lista y otra que sirve de molde para todas las entradas.
06
Qué conviene para cada contenido
| Contenido | Dónde conviene |
|---|---|
| Una o pocas páginas únicas | Página normal en src/pages |
| Blog, servicios, equipo, catálogo chico | Colección |
| Datos que cambian a cada minuto, como el stock | Base de datos |
| Archivos que se entregan tal cual, como un PDF | Carpeta public |
La documentación de Astro lo dice igual: si solo tienes un par de páginas distintas, no necesitas una colección.
07
Una entrada por dentro
---
titulo: "Cómo conservar el café en casa"
fecha: 2026-11-10
resumen: "Tres reglas simples para que no pierda aroma."
borrador: false
---
Guarda el café en un frasco hermético, lejos de la luz...Arriba, entre guiones, van los datos de la entrada. Abajo, el texto. Los nombres de los campos los decides tú, una sola vez, para toda la colección.
08
El archivo que define las colecciones
import { defineCollection } from "astro:content";
import { glob } from "astro/loaders";
import { z } from "astro/zod";
const blog = defineCollection({
loader: glob({ base: "./src/content/blog", pattern: "**/*.md" }),
schema: z.object({
titulo: z.string(),
fecha: z.coerce.date(),
resumen: z.string(),
}),
});
export const collections = { blog };Vive en src/content.config.ts. Dice dónde están los archivos y qué campos debe tener cada uno.
09
El esquema es un control de calidad
Si una entrada no cumple el esquema, el sitio no se construye y el error dice qué archivo y qué campo fallan.
10
Qué exigir en el esquema
Tú decides los campos; Claude los traduce a código.
- Lista lo que toda entrada debe tener: título, fecha, resumen.
- Marca lo opcional: imagen, autor, etiquetas.
- Define el tipo de cada campo: texto, fecha, número, verdadero o falso.
11
La página que lista las entradas
La página de listado pide todas las entradas con la función getCollection y las recorre para mostrar título, fecha y resumen, cada una con su enlace.
12
Una sola página para todas las entradas
---
import { getCollection, render } from "astro:content";
export async function getStaticPaths() {
const entradas = await getCollection("blog");
return entradas.map((entrada) => ({
params: { id: entrada.id },
props: { entrada },
}));
}
const { entrada } = Astro.props;
const { Content } = await render(entrada);
---
<h1>{entrada.data.titulo}</h1>
<Content />El archivo se llama [id].astro. Los corchetes indican que esa parte de la dirección cambia: Astro genera una página por cada entrada.
13
De dónde sale la dirección
El id de cada entrada viene del nombre de su archivo. Un archivo llamado conservar-cafe.md queda publicado en /blog/conservar-cafe.
Por eso el nombre del archivo importa:
- Minúsculas, sin tildes ni espacios, palabras separadas por guiones.
- Corto y descriptivo.
- No se cambia después de publicar: cambiarlo rompe los enlaces que ya circulan.
14
Publicar una entrada nueva
- Crea un archivo Markdown en la carpeta de la colección.
- Completa los datos del encabezado.
- Escribe el texto.
- Mira el resultado con
npm run dev. - Ejecuta
npm run buildpara confirmar que el esquema la acepta. - Haz commit.
No tocaste ningún componente ni ninguna página. Ese es el objetivo de toda la clase.
15
Borradores
Para escribir sin publicar, agrega al esquema un campo de verdadero o falso, por ejemplo borrador, y pide que las páginas de listado y de entrada descarten las que lo tengan activo.
16
Más de una colección
El mismo mecanismo sirve para cualquier contenido repetido:
| Colección | Campos típicos |
|---|---|
| Servicios | Nombre, descripción, precio desde, orden |
| Equipo | Nombre, cargo, foto |
| Preguntas frecuentes | Pregunta, respuesta, categoría |
| Productos de catálogo chico | Nombre, precio, foto, disponible |
Cada una se declara en el mismo archivo de configuración, con su propio esquema.
17
Cuando el contenido cambia sin reconstruir
Las colecciones normales se leen al construir el sitio: para que un cambio se vea, hay que construir y publicar de nuevo. Con despliegue automático, eso ocurre solo en cada commit.
Astro tiene además colecciones en vivo, que consultan los datos en cada visita. Exigen un sitio con servidor y no admiten todo lo que admiten las normales. Convienen solo cuando el dato no puede esperar, como un stock.
18
Cómo pedírselo a Claude
- Decide tú la colección y sus campos, y escríbelos en el pedido.
- Pide en modo plan: configuración, listado, página de entrada y dos entradas de ejemplo.
- Indícale que use el layout y los componentes existentes.
- Reemplaza las entradas de ejemplo por contenido tuyo antes de publicar.
19
El límite: quién va a editar
Este sistema supone que quien publica puede crear un archivo y hacer un commit. Para ti, con Claude Code, es cómodo y gratis.
No sirve si el contenido lo va a mantener alguien que no usará nunca un editor de código. En ese caso conviene un CMS, un panel web para editar contenido, conectado al sitio. Suma una cuenta, una dependencia y a veces un costo mensual.
20
Lo que te llevas
- Una colección separa el contenido, en archivos Markdown, del diseño, en páginas y componentes.
- El esquema obliga a que cada entrada esté completa antes de construir.
- Una página de listado y una página molde bastan para toda la colección.
- El nombre del archivo define la dirección: no se cambia después de publicar.
- Los borradores se filtran en el listado y en la página de entrada.
21
Hazlo ahora
En 15 minutos:
- Elige el contenido repetido de tu web: artículos, servicios o preguntas frecuentes.
- Escribe en una lista sus campos obligatorios y opcionales.
- Pide a Claude, en modo plan, la colección con su listado y su página de entrada.
- Crea tú una entrada nueva a mano y mírala en el navegador.
- Borra un campo obligatorio, ejecuta
npm run buildy lee el error. Repara y haz commit.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026