About

Documentation technique

Type de ressource : Route Astro (Page SSG)
Fichier source : src/pages/about.astro
Statut : Actif

1. Vue d’ensemble

1.1. Description

Page “About” utilisant le layout BlogPost. Contient du texte placeholder (Lorem ipsum) avec une image héro. Utilise le layout BlogPost pour la structure HTML globale.

1.2. Objectif

Fournir une page “About” pour le site
Tester l’utilisation du layout BlogPost
Afficher du contenu placeholder

1.3. Caractéristiques

Propriété	Valeur
URL publique	`/about`
Mode de rendu	SSG (via layout)
Type	Page HTML
Méthode HTTP	GET
Authentification requise	Non
Cache	Par défaut Cloudflare

2. Architecture et flux

[Requête utilisateur]
     │
     ▼
[Cloudflare Pages / Edge]
     │  • Routage vers Astro
     ▼
[Astro Route (about.astro)]
     │  • Utilisation du layout BlogPost
     │  • Rendu du composant
     ▼
[Réponse HTML]

2.2. Composants impliqués

Composant	Rôle	Couche
`about.astro`	Définition de la route	L2 (Astro)
`BlogPost`	Layout global	L2 (Astro)

3. Implémentation

3.1. Code de la route

---
import AboutHeroImage from '../assets/blog-placeholder-about.jpg';
import Layout from '../layouts/BlogPost.astro';
---

<Layout
  title="About Me"
  description="Lorem ipsum dolor sit amet"
  pubDate={new Date('August 08 2021')}
  heroImage={AboutHeroImage}
>
  <p>
    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut
    labore et dolore magna aliqua...
  </p>
  <!-- ... -->
</Layout>

4. Données et requêtes GROQ

4.1. Requête principale

Aucune requête GROQ n’est utilisée (données locales).

4.2. Requêtes secondaires

Aucune requête secondaire n’est utilisée.

4.3. Types TypeScript associés

Non applicable (pas de types Sanity).

5. Paramètres et validation

5.1. Paramètres d’URL

Aucun paramètre d’URL n’est utilisé.

5.2. Query strings

Aucune query string n’est utilisée.

5.3. Gestion des erreurs

Code HTTP	Condition	Réponse
200	Succès	Page HTML

6. Stratégie de cache

6.1. En-têtes de cache

Mode	`Cache-Control`	`CDN-Cache-Control`	Rationale
SSG (layout)	Non configuré	Non configuré	Par défaut Cloudflare

6.2. Implémentation dans la route

Non implémenté - pas de headers de cache explicites.

7. SEO et métadonnées

7.1. Balises meta

Balise	Source	Fallback
`<title>`	Hardcodé “About Me”	-
`<meta name="description">`	Hardcodé “Lorem ipsum dolor sit amet”	-

7.2. Sitemap

✅ Cette route est-elle incluse dans le sitemap ? Oui
✅ Fréquence de mise à jour : monthly
✅ Priorité : 0.5

7.3. Indexation Pagefind

❌ Cette route est-elle indexée par Pagefind ? Non (Pagefind non configuré)

8. Composants UI utilisés

Composant	Fichier	Rôle	Hydratation
`BlogPost`	`src/layouts/BlogPost.astro`	Layout global	Aucune

9. Sécurité

9.1. Accès et authentification

Condition	Comportement
Accès public	Page accessible sans authentification

9.2. Validation des entrées

Non applicable (pas de paramètres d’entrée).

9.3. En-têtes de sécurité

Non implémenté dans cette route (à configurer via Middleware Cloudflare).

10. Débogage et troubleshooting

10.1. Problèmes courants

Symptôme	Cause probable	Solution
Image non affichée	Image manquante	Vérifier que l’image existe dans `src/assets/`

10.2. Logs et monitoring

# Logs de développement
npm run dev

# Vérification des types
npx astro check

10.3. Tests manuels

# Test de la route en local
curl -I http://localhost:4321/about

11. Bonnes pratiques

11.1. Architecture

✅ Utilisation du layout BlogPost pour la cohérence
✅ Séparation du contenu et de la structure

11.2. Performance

✅ Pas de JavaScript inutile
✅ HTML statique par défaut

11.3. Maintenance

✅ Remplacer le contenu placeholder par du contenu réel

12. Évolutions et roadmap

12.1. Améliorations planifiées

Remplacer le contenu placeholder par du contenu réel
Ajout de structured data (JSON-LD)
Personnalisation du layout (layout dédié “About”)

12.2. Limitations connues

❌ Contenu placeholder (Lorem ipsum)
❌ Layout BlogPost utilisé pour une page non-blog
❌ Pas de structured data (JSON-LD)

13. Ressources liées

Documentation Astro : Routing
Fichiers concernés :
- src/pages/about.astro
- src/layouts/BlogPost.astro
- src/assets/blog-placeholder-about.jpg

14. Historique des modifications

Date	Version	Description	Auteur
2026-09-15	1.0	Création initiale	Devin