williamandClaude Sonnet 5
64ee7292d4
document_engine.md listait encore seulement 3 sous-dossiers alors que pages/ existait déjà avant cette session — corrigé au passage. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
3.1 KiB
document_engine/themes/
Catalogue des thèmes visuels applicables à un support (bouton "Utiliser
un modèle" à côté d'Aperçu, voir templates/document/document_edit.html
et static/document/js/document-editor.js). Décision du 24/09/2026 : le
moteur ne porte QUE contenu et mécanisme — chaque thème est une feuille
de style externe (static/document/themes/<id>.css, servie telle quelle)
qui habille les classes FIXES du moteur (.docPage/.docText/
.docList/.docCard/.docBadge/.docButton/.docImage/
.docMinigame/...), jamais du code qui en changerait la structure. Une
centaine de thèmes est prévue à terme : ce découpage (données de
catalogue + CSS statique, aucun code Python par thème au-delà d'une
entrée de catalogue) est pensé pour rester gérable à cette échelle.
DOCUMENT_THEMES: list[dict[str, Any]]
Un dict par thème : id (identifiant stable, utilisé dans les URLs et
persisté via db.set_document_theme), name, category, description
(affichage dans la modale), css_path (chemin sous static/, passé à
url_for('static', filename=...)), font_url (optionnel, lien Google
Fonts), seed_pages (contenu de démonstration, voir
document_engine.replace_document_content). L'auteur d'un thème est
responsable de respecter les règles structurelles du moteur dans son
seed_pages (ex. un mini-jeu seul sur sa page — voir
routes/document/document_element_add.py — jamais revérifié
automatiquement puisque ce contenu vient du thème, pas de l'utilisateur ;
voir tests/document/test_document_themes.py pour la vérification
statique de cette règle sur tout le catalogue).
get_document_theme_entry(theme_id: str) -> dict[str, Any] | None
- Retour : l'entrée de
DOCUMENT_THEMESdontid == theme_id, ouNonesi aucun thème de ce catalogue ne porte cet id. - Exceptions : aucune.
seed_blocks_to_elements(blocks: list[dict[str, Any]]) -> list[dict[str, Any]]
Convertit une liste de blocs de contenu-seed (seed_pages[i]) en une
liste d'éléments "à plat" (id/kind/parent_id/attributes) directement
exploitable par document_engine.render_document — ids synthétiques
NÉGATIFS, jamais persistés. Utilisée UNIQUEMENT pour l'aperçu d'un thème
(voir routes/document/document_theme_preview.py, destiné à un
<iframe> dans la modale) : ce qui est prévisualisé est ainsi
RÉELLEMENT rendu par le moteur, jamais une image statique ni une
resucée manuelle du CSS. Pour la persistance réelle du contenu, voir
document_engine.replace_document_content — qui ne réutilise pas cette
fonction, ayant besoin de vrais ids attribués par la base au fil des
insertions.
- Retour : liste d'éléments prête pour
render_document. - Exceptions : aucune.
securite_incendie_seed.py — contenu du premier thème implémenté
SECURITE_INCENDIE_SEED_PAGES : vrai contenu de formation (6 pages —
titre, objectifs, classes de feu, méthode P.A.S.S., évacuation, quiz de
validation à 3 questions), jamais du texte de remplissage. Sert à la
fois de contenu par défaut ("utiliser le contenu du modèle") et de
première validation bout-en-bout du mécanisme de thème.