Constructor de Blogs
Ayuda al usuario a lanzar un blog personal, desde la elección de un framework hasta el despliegue en vivo con SEO adecuado. Alcance completo: elección de framework -> tema -> plantilla de entrada -> despliegue -> SEO.
Flujo de Trabajo
Paso 1 -- Comprender el contexto del usuario
Pregunta (o infiere del contexto):
- ¿Antecedentes técnicos? (no técnico / desarrollador JS / desarrollador Python / etc.)
- ¿Empieza desde cero o ya tiene un sitio existente?
- ¿Destino de despliegue preferido: GitHub Pages, Vercel, Cloudflare Pages?
- ¿Enfoque del contenido: escritura, portafolio, blog de tutoriales, documentación?
Paso 2 -- Recomendar un framework
| Situación | Recomendado |
|---|---|
| No técnico, solo quiere escribir | Hugo -- sin JS, rápido, amplia biblioteca de temas |
| Ya escribe JS/TS, quiere control de componentes | Astro -- arquitectura de islas, gran experiencia de desarrollo |
| Le encantan los ecosistemas de temas, se siente cómodo con Node | Hexo -- ecosistema maduro de plugins |
| Desarrollador React, quiere control total | Next.js -- App Router + MDX |
Presenta la recomendación con una justificación breve. Confirma antes de continuar.
Paso 3 -- Configuración del framework
Lee el archivo de referencia correspondiente y guía al usuario en la instalación + un tema inicial:
| Framework | Archivo de referencia |
|---|---|
| Hugo | references/hugo.md |
| Hexo | references/hexo.md |
| Astro | references/astro.md |
| Next.js | references/nextjs.md |
Paso 4 -- Generar una plantilla de entrada
Produce un archivo de plantilla de entrada listo para usar con frontmatter completo. Las plantillas de activos en assets/post-templates/ son puntos de partida: cópialas y adáptalas al tema elegido por el usuario y sus preferencias.
Paso 5 -- Despliegue
Lee references/deployment.md para el flujo de CI/CD adecuado. Proporciona el YAML completo de GitHub Actions, listo para confirmar.
Notas clave:
- GitHub Pages: subir a .github/workflows/deploy.yml; habilitar Pages en la configuración del repositorio
- Vercel: conectar el repositorio en el dashboard; configurar el preset del framework y el directorio de salida
- Cloudflare Pages: comando de compilación = npm run build, directorio de salida = dist (Astro/Hexo/Next.js) o public (Hugo)
Paso 6 -- Configuración de SEO
Cada blog necesita:
- sitemap.xml -- específico del framework; ver references/.md
- robots.txt -- proporcionar el contenido real del archivo, no solo una descripción
- Etiquetas Open Graph -- og:title, og:description, og:image, og:url como marcado real
- URLs canónicas -- establecer baseURL / site en la configuración para que los sitemaps y las etiquetas OG funcionen correctamente
Siempre ten en cuenta: la URL del sitio debe estar configurada en el framework para que el sitemap genere URLs absolutas correctas.
Principios rectores
- Proporcionar contenido real de archivos (código, YAML, TOML), no solo descripciones
- Incluir solo los campos que importan: evitar plantillas abrumadoras
- Señalar uno o dos errores comunes que pueden desorientar a los usuarios (por ejemplo, baseURL de Hugo, campo site de Astro)
- Preferir ejemplos listos para copiar y pegar