1Introduction
Ce document spécifie le périmètre de publication HTML du projet Cooking et les rubriques de cooking.sliver.lu. Il complète Kit — Documentation — Pipeline HTML sans le dupliquer: ce qui y est déclaré invariant s'applique ici sans dérogation.
| Portée | Objet | Source |
|---|---|---|
| Invariant | Critères de sélection des documents publiés | Kit Pipeline HTML §2.1 |
| Invariant | Règles de livraison — outils, logique delta | Kit Pipeline HTML §2.3 |
| Invariant | Registry — structure et mise à jour | Kit Pipeline HTML §3 |
| Invariant | Déploiement delta et lastDeploy | Kit Pipeline HTML §4 |
| Invariant | Structure du site et chemins relatifs | Kit Pipeline HTML §5 |
| Invariant | Génération des PDF | Kit Pipeline HTML §6 |
| Invariant | Règles de robustesse et setters obligatoires | Kit Pipeline HTML §7 |
| Projet | Rubriques et documents publiés | §2.2 ci-dessous |
| Projet | Page d’accueil | §3 ci-dessous |
| Projet | Flux parallèles — fiches et recettes | §4 ci-dessous |
| Projet | Nommage des archives de déploiement | §5 ci-dessous |
2Périmètre de publication
Le pipeline du Kit publie les documents kit-conformes du projet. Les fiches et les recettes relèvent de flux parallèles, décrits au §4 : elles ne passent pas par ce pipeline.
2.1Critères de sélection
Les critères de sélection sont invariants — Kit Pipeline HTML §2.1. Aucune dérogation projet: un document inscrit au Registry et présent dans le répertoire de travail est publié.
2.2Rubriques et documents publiés
Le tableau ci-dessous fait foi: il est la source de vérité de la constante des rubriques dans le générateur de site. Un document absent du répertoire au moment de la passe est sauté sans arrêter la publication.
| Rubrique | Documents | Fichier HTML | |
|---|---|---|---|
| 01 Bienvenue | Cooking — Documentation — Reading Guide | reading-guide.html | oui |
| 02 Glossaire et conventions | Cooking — Glossaire — Termes | glossaire.html | non |
| Cooking — Projet — Prompt | kit-prompt.html | oui | |
| 03 Pipeline et structure | Cooking — Documentation — Pipeline HTML | pipeline-html.html | oui |
| Cooking — Documentation — Pipeline Fiches | pipeline-fiches.html | oui | |
| Cooking — Documentation — Pipeline Recipes | pipeline-recipes.html | oui |
Les documents communs au Kit — manuel, guide pratique, prompts de dialogue, convention de nommage, structure commune, contrôle qualité — ne sont pas dupliqués sur ce sous-site: la barre de navigation y mène par kit.sliver.lu.
2.3Règles de livraison
Les outils par type de fichier, la distinction entre passe complète et passe delta, les déclencheurs de régénération du CSS et des PDF sont invariants — Kit Pipeline HTML §2.3.
3Page d’accueil
La page d'accueil de cooking.sliver.lu est un modèle propre au projet, hors des formes du Kit: le Registry porte allowNonKitTemplates à true — Cooking — Projet — Prompt §7 et Étendre le Kit §9. Elle mène à chacun des flux du sous-site: les documents du §2.2, les rubriques de fiches et les recettes.
Le texte d'introduction ci-dessous est la source de vérité: le générateur de site le reprend tel quel, sans le réécrire.
Un sous-site de recettes de cuisine, fiches imprimables au format livret A5, photos retouchées maison. Construit avec le Kit de documentation assistée par Claude AI — mêmes conventions, même chaîne de validation que les autres sous-sites de la famille.
4Flux parallèles — fiches et recettes
Les fiches et les recettes sortent du pipeline du Kit et vivent sous leurs propres chemins. Elles ne figurent pas au tableau du §2.2 et ne passent pas par la conversion des documents.
–Rubriques de fiches.Une page par sujet sous son chemin de rubrique — /ingredients/ en premier. Un module de données porte les entrées, les photos vivent sous le dossier de l'entrée. Mécanique: Cooking — Documentation — Pipeline Fiches. Règles de contenu: Cooking — Projet — Prompt §5.
–Recettes.Une page par recette sous /recettes/, et un PDF A4 imposé pour pliage en livret A5. La spécification du rendu vit dans Cooking — Documentation — Pipeline Recipes.
5Nommage des archives de déploiement
Conformément à Kit — Documentation — Pipeline HTML §4.3, l'archive produite par le générateur de site suit le patron du domaine.
| Mode | Nom de fichier |
|---|---|
| Passe complète | cooking.sliver.lu (TS).zip |
| Passe delta | cooking.sliver.lu - delta (TS).zip |
L'horodatage du nom est celui de la session de génération, en heure du Luxembourg. Il est distinct du lastDeploy en temps universel inscrit au Registry, que seul le générateur de site écrit.