Portfolio Hugo

Ce site : créé avec Hugo ; pipeline CSS et qualité orientée accessibilité, maintenance et évolutivité.

Usage de l'IA dans la rédaction de ce contenu
Partiel (plan et relecture).

En bref : un site que je voulais faire depuis longtemps, sans avoir sauté le pas.

D’un point de vue technique, je me suis imposé les contraintes suivantes :

Et ça a été l’occasion d’approfondir l’utilisation d’agents IA dans le développement et le suivi de projet.

Contexte

L’objectif de ce site est multiple : une vitrine professionnelle, un espace d’expérimentation. La réalisation de ce site devait donc me permettre de me réapproprier le CSS, approfondir ma compréhension du templating Go ainsi que de mettre en place une CI GitHub.

Sur un projet personnel de ce genre, mon premier obstacle a toujours été le cadrage et la perte de motivation qui en découle, et c’est ici que l’usage d’agents IA (Claude) a été très efficace : utilisée dès le départ pour le cadrage et le suivi du projet, l’IA a permis de mener le projet à bien, sans (trop) dériver sur des besoins secondaires.

Pourquoi Hugo

Mon cœur d’expertise full-stack se trouve plutôt sur des technos plus lourdes (Drupal, Symfony, Vue.js) : dès le départ, ces choix étaient exclues.

Si une stack PHP ou JS complète présente un intérêt pour la gestion de contenu, le besoin étant un site purement édito, léger et épuré, elles sont éliminées d’office.

D’autres solutions (CMS flat-file type Grav) ont été envisagées, mais quitte à partir dans la simplicité, autant se passer de la stack Apache/Nginx + PHP, pour encore alléger l’hébergement.

Étant très amateur de Go, j’ai donc décidé d’utiliser Hugo et son tooling natif : partials, css.Build, js.Build etc.

Choix techniques

Front

Accessibilité

CI/CD, hébergement

Back

S’il n’y a pas vraiment de back-end comme on l’entend traditionnellement, j’ai tiré parti des fonctionnalités d’Hugo notamment pour le SEO/GEO :

Tous les partials déclarent un contrat, c’est-à-dire que les propriétés qui leur sont passées sont validées, toute valeur invalide provoquant une erreur au build du site.

Utilisation de l’IA dans le projet

L’IA a été capitale pour accélérer le cadrage et le suivi du projet. Utilisé comme assistant, Claude a permis dès le départ de définir un cahier des charges et de réaliser un découpage des tâches macro qui a résolu le plus gros écueil : le cadrage, c’est-à-dire savoir où l’on va.

Il s’agissait d’utiliser l’agent pour exposer mon besoin (prompt type Je souhaite réaliser un portfolio avec telles contraintes et tels buts), puis d’itérer jusqu’à arriver à la rédaction du cahier des charges initial.

De ce cahier des charges, en ont été déduites les tâches initiales, puis, avec un token GitHub, puis transformées en issues, réparties par milestones (Fondation/Scaffolding, Squelette de contenu, identité visuelle, SEO/GEO etc jusqu’à Recette & Post MEP).

En utilisant la version de base de GitHub Projects et en prenant en compte une contrainte temps arbitraire, cela m’a permis de visualiser l’étendue réelle du chantier et de prioriser ou dé-prioriser en fonction du temps que j’avais à y consacrer.

Pour la partie développement agentique, j’ai utilisé l’IA pour débloquer des situations où l’expertise me manquait sur des sujets spécifiques à Hugo, ou faciliter ma prise en main et compréhension des pratiques CSS modernes (nesting, grid-template-columns, gestion des tokens/custom properties).

Pour finir, l’IA a été particulièrement efficace dans la création et maintenance de documentation.

Résultat

Le portfolio a été déployé début octobre, pour une date initiale à mi-septembre. Des métriques de trafic ne sont ni disponibles (pas d’analytics par choix) ni pertinentes, en revanche les objectifs initiaux sont atteints : le site est simple, performant, facile d’utilisation et documenté.

Les choix techniques (Hugo, CSS natif, hébergement) se sont révélés pertinents, même si Hugo souffre d’une prise en main parfois complexe, a minima obscure.

L’utilisation de l’IA a été un vrai atout en termes de gain de temps et d’efficacité, avec un bémol concernant la documentation. Par défaut, un agent écrit pour un autre agent ; la vraie difficulté est de réussir à la contenir pour ne pas perdre la maîtrise technique du projet.

Consulter la version Markdown