williamandClaude Sonnet 5
746feb3796
Nouvelle colonne _document_pages.vertical_align (top/center/bottom,
"top" par défaut, migration incluse pour les supports existants).
Quand l'onglet "Pages" du panneau gauche est actif, le panneau
Propriétés (droite) affiche maintenant l'alignement de la page active
au lieu des propriétés d'un élément — un contrôle segmenté qui persiste
via une nouvelle route dédiée et met à jour le canevas immédiatement.
Le contenu-seed des thèmes porte désormais aussi ce réglage par page
(seed_pages devient une liste de {vertical_align, blocks} plutôt qu'une
liste de listes de blocs) : la page de titre du thème "Sécurité
Incendie" est centrée verticalement, comme demandé, cohérente avec la
maquette d'origine. L'aperçu de thème (iframe de la modale) reflète
aussi ce réglage par page.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
3.2 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 — une liste de dicts
{"vertical_align": "top"|"center"|"bottom", "blocks": [...]}, voir
document_engine.replace_document_content pour la forme exacte de
blocks). 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]["blocks"])
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.