Hello World — Votre premier article

Bienvenue sur votre nouveau site propulse par le CMS AI-first. Cet article vous montre comment tout fonctionne.

Comment ca marche

Le contenu de ce site vit dans des fichiers Markdown (.md) dans le dossier content/. Chaque fichier a un frontmatter YAML qui contient les metadonnees : titre, date de publication, SEO, image de couverture, etc.

---
type: blog
title: "Mon article"
publishedAt: '2026-05-13T10:00:00.000Z'
seo:
  title: "Mon article — SEO title"
  description: "Description pour Google et les reseaux sociaux."
---

Au build, Astro lit ces fichiers, transforme le Markdown en HTML via une pipeline unified (remark + rehype), et genere des pages statiques ultra-rapides.

Structure du contenu

content/
  fr/
    articles/
      hello-world.md          ← cet article
      mon-deuxieme-article.md
      seo/
        guide-seo-2026.md     ← articles imbriques = sous-routes

Les fichiers dans content/fr/articles/ deviennent automatiquement des routes. Le chemin du fichier determine l'URL :

Fichier	URL
hello-world.md	/hello-world/
seo/guide-seo-2026.md	/seo/guide-seo-2026/

Le frontmatter en detail

Chaque article doit avoir ces champs :

• type : "blog" pour les articles
• title : titre affiche en haut de l'article
• publishedAt : date ISO 8601
• seo.title : titre pour Google (peut differer du title)
• seo.description : meta description

Champs optionnels utiles :

• excerpt : resume affiche sur la homepage et les cartes
• tags : tableau de tags pour le classement
• cover.image : URL de l'image de couverture
• draft : true pour masquer l'article
• updatedAt : date de derniere mise a jour
• faq : tableau question/reponse pour le schema FAQ

Edition par AI

C'est la ou ce template devient interessant. Le fichier CLAUDE.md a la racine du projet contient les instructions pour les agents AI :

• Creer un article : l'AI cree un fichier .md avec le bon frontmatter
• Editer du contenu : l'AI modifie directement le Markdown
• SEO : l'AI optimise les titres, descriptions, et structure
• Batch : l'AI peut creer plusieurs articles d'un coup

Pas besoin d'interface admin. Pas de formulaires. L'AI ecrit directement dans les fichiers, comme un developpeur le ferait.

Deploiement

Le site se deploie automatiquement via GitHub Actions :

1. Push sur main
2. GitHub Actions build le site (npm run build)
3. Le dossier dist/ est deploye via rsync (Hetzner) ou Vercel

Le build prend generalement moins de 10 secondes pour un site de 50 articles.

Prochaines etapes

1. Modifiez astro-frontend/src/lib/site.js avec le nom de votre site
2. Remplacez le contenu de cet article par le votre
3. Ajoutez vos propres articles dans content/fr/articles/
4. Configurez le deploiement (voir le README)
5. Laissez l'AI faire le reste