Blog Builder
Aidez l'utilisateur à lancer un blog personnel — du choix d'un framework jusqu'au déploiement en ligne avec un SEO correct. Périmètre complet : choix du framework → thème → modèle d'article → déploiement → SEO.
Workflow
Étape 1 — Comprendre le contexte de l'utilisateur
Demandez (ou déduisez du contexte) :
- Niveau technique ? (non-technique / développeur JS / développeur Python / etc.)
- Départ de zéro ou site existant ?
- Cible de déploiement préférée : GitHub Pages, Vercel, Cloudflare Pages ?
- Contenu : écriture, portfolio, blog tutoriel, documentation ?
Étape 2 — Recommander un framework
| Situation | Recommandation |
|---|---|
| Non technique, veut juste écrire | Hugo — zéro JS, rapide, énorme bibliothèque de thèmes |
| Développe déjà en JS/TS, veut du contrôle sur les composants | Astro — architecture en îles, excellente expérience développeur |
| Aime les écosystèmes de thèmes, à l'aise avec Node | Hexo — écosystème de plugins mature |
| Développeur React, veut un contrôle total | Next.js — App Router + MDX |
Présentez la recommandation avec une courte justification. Confirmez avant de passer à la suite.
Étape 3 — Configuration du framework
Lisez le fichier de référence correspondant et guidez l'utilisateur dans l'installation + un thème de démarrage :
| Framework | Fichier de référence |
|---|---|
| Hugo | references/hugo.md |
| Hexo | references/hexo.md |
| Astro | references/astro.md |
| Next.js | references/nextjs.md |
Étape 4 — Générer un modèle d'article
Produisez un fichier modèle d'article prêt à l'emploi avec un Frontmatter complet. Les modèles d'actifs dans assets/post-templates/ sont des points de départ — copiez et adaptez au thème choisi et aux préférences de l'utilisateur.
Étape 5 — Déploiement
Lisez references/deployment.md pour le workflow CI/CD approprié. Fournissez le YAML complet d'Action GitHub, prêt à être commité.
Points clés :
- GitHub Pages : push vers .github/workflows/deploy.yml ; activez Pages dans les paramètres du dépôt
- Vercel : connectez le dépôt dans le tableau de bord ; définissez le preset de framework et le dossier de sortie
- Cloudflare Pages : la commande de build = npm run build, le dossier de sortie = dist (Astro/Hexo/Next.js) ou public (Hugo)
Étape 6 — Configuration SEO
Chaque blog a besoin :
- sitemap.xml — spécifique au framework ; voir references/.md
- robots.txt — fournissez le contenu du fichier réel, pas seulement une description
- Balises Open Graph — og:title, og:description, og:image, og:url comme balisage réel
- URL canoniques — définissez baseURL / site dans la configuration pour que les sitemaps et les balises OG fonctionnent correctement
Rappelez toujours : l'URL du site doit être définie dans la configuration du framework pour que le sitemap génère des URL absolues correctes.
Principes directeurs
- Fournissez le contenu réel des fichiers (code, YAML, TOML), pas seulement des descriptions
- Incluez uniquement les champs qui comptent — évitez les modèles trop longs
- Signalez un ou deux pièges qui surprennent souvent les débutants (par exemple, baseURL de Hugo, champ site d'Astro)
- Privilégiez les exemples prêts pour le copier-coller