đź’ˇ Technical Domain

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

đź’ˇ Quick Reference

Update Triggers: Nouveau script npm | Changement de pipeline de build | Nouvelle convention de contenu
Audience: Développeurs, agents IA

đź’ˇ Primary Stack

💡 Primary Stack — Tableau 1
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 Pipeline (npm run build)

build:sass → build:check-images → build:social-images → build:optimize-images
→ build:11ty → build:css-purge → build:pagefind

đź’ˇ Code Patterns

💡 Créer un article (script)

./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.

💡 Frontmatter d’article (obligatoire)

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).

đź’ˇ Conventions de nommage

💡 Conventions de nommage — Tableau 2
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

đź’ˇ Code Standards

đź’ˇ Security Requirements

đź’ˇ đź“‚ Codebase References

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).