Recettes cuisines

Cookbook personnel au format Cooklang, avec génération de site statique (Hugo) et de PDFs (Typst).

Workflow rapide

just serve            # Serveur local avec hot-reload (défaut)
just convert-all      # Génère bundles Hugo + sources Typst + PDFs
just build            # convert-all + hugo (site complet)
just check            # Vérifie la qualité du cookbook (contraste, refs, méta, liens)
just test             # Tests unitaires cookext
just lint             # Lint cookext (ruff)
just typecheck        # Type check cookext (mypy)

Structure du dépôt

content/              # Sources éditables (cookbook, journal, stocks, ressources)
renderers/            # Moteurs de rendu (hugo, typst, icons)
tooling/              # Pipeline de conversion cookext (Python)
docs/                 # Documentation interne
reference/            # Références et sources
build/                # Artefacts générés (gitignored)

Organisation du cookbook

Référence opérationnelle : docs/layout.md — définition stricte de chaque dossier, catalogue des tags, taxonomies Hugo, matrice de décision, cas frontières documentés.

Décisions d'architecture

Les choix structurants sont consignés en ADR dans docs/adr/ :

• Stack technique — Cooklang (source) + Hugo (site) + Typst (PDF) + cookext (pipeline Python)
• Zéro JavaScript côté client — HTML/CSS pur, polices système, pas de ressource externe
• Éco-conception — < 10 KB CSS, < 50 KB/page, zéro cookie, zéro image sur les recettes
• RGAA / WCAG 2.1 AA — HTML sémantique, contraste ≥ 4.5:1, allergènes = icône + texte
• Classement du cookbook par type culinaire — aligné Schema.org recipeCategory, inspiré d'Ottolenghi Simple

Remotes

• origin → GitLab (git@gitlab.com:oalbiez/recettes-cuisine.git)
• forgejo → Forgejo auto-hébergé (ssh://forgejo@git.albiez.family/olivier_albiez/recettes-cuisine.git)

Ressources

• Cooklang spec
• Lucide icons
• https://www.bloc-notes-culinaire.com/2019/08/taillage-des-legumes-et-des-fruits.html