Purpose: Site statique Jevalide.ca — blogue et pages en français compilés avec Eleventy, stylés en Sass, cherchables via Pagefind, audités avec Pa11y.
Last Updated: 2026-11-20
Update Triggers: Nouveau script npm | Changement de pipeline de build | Nouvelle convention de contenu
Audience: Développeurs, agents IA
| Layer | Technology | Version | Rationale |
|---|---|---|---|
| Générateur | Eleventy (@11ty/eleventy) | via npx | Site statique, data-driven, léger |
| Styles | Sass (input.scss → styles.css) | via npx | Compilation + purge avec purgecss |
| Recherche | Pagefind | via npx | Index statique sur _site |
| Images | sharp (binaries natifs) | npm | Images sociales + optimisation |
| A11y | Pa11y (CI + local) | via npx | Scan obligatoire sur chaque PR/push |
| Node | Node.js 18 | 18.x | Version du CI (.github/workflows/pa11y.yml) |
build:sass → build:check-images → build:social-images → build:optimize-images
→ build:11ty → build:css-purge → build:pagefind
npm ci d’abord (postinstall: npm rebuild sharp — binaire natif plateforme).npm run serve:static → http-server sur _site port 8080.npx pa11y http://localhost:8080 pour valider localement../creer-blog.sh --date 2026-04-06 --title "Mon titre" --category outils \
--tags "tag1,tag2" --description "Court descriptif" --yes
Flux agent : script → git checkout -b add-post-<slug> → commit → push → PR vers main → CI pa11y.
title, date, categories, tags, permalink, description
Catégories : grimoire | alchimie | outils | collaborations (1…4 acceptés).
Images : static/images/blogue/YYYY/SLUG/ (dossier créé par le script).
| Type | Convention | Example |
|---|---|---|
| Articles | blogue/YYYY/<fichier>.md |
blogue/2026/mon-post.md |
| Images d’article | static/images/blogue/YYYY/SLUG/ |
static/images/blogue/2026/mon-post/ |
| Shortcodes | camelCase dans _includes/shortcodes/ |
answerbox.js, testimonial.js |
| Scripts npm | build:*, dev:* (run-s / run-p) |
build:11ty, dev:sass |
bash, yaml).Réponse courte autonome
##/### propre._site/ (généré, non commité)..github/workflows/pa11y.yml sur push/PR vers main.npm ci && npm run build puis serve:static + pa11y.Build & scripts npm : package.json — pipeline complet et scripts dev/deploy.
Création d’article : creer-blog.sh — génère article + dossier d’images.
Shortcodes : _includes/shortcodes/ — answerbox.js, testimonial.js, titleWithImage.js.
Styles : _includes/assets/sass/input.scss → styles.css.
Images/outils : generate_social_images.js, optimize_images.js, find-unused-images.js, generate_permalinks.js.
CI a11y : .github/workflows/pa11y.yml.
Déploiement : deploy.sh (npm run deploy, dry-run dispo).
Conventions agent : AGENTS.md (guide complet pour agents LLM).