Le Theme Letterbox
Le Letterbox est le thème par défaut livré sous le slug default. Ses templates résident dans builder/site_templates/ (un ensemble de pages Template Toolkit composant chaque URL publique plus l'intégralité de sa feuille de style) et cette reference cartographie tous les fichiers pour que vous puissiez les cloner ou les remplacer en confiance.
Comment le thème par défaut fonctionne sur le disque
Les templates de Letterbox siègent directement dans site_templates/ (contrairement aux thèmes clonés, qui vivent sous builder/themes/<name>). Quand votre thème actif est Letterbox, c'est là que le builder lit et où son empreinte de build verrouille les changements de thème ; quand vous activez plutôt un thème cloné, c'est son propre répertoire sous builder/themes/ qui est utilisé.
Les seuls slots de menu que le thème d'origine déclare sont header et footer, avec un arbre à menu déroulant à un niveau pris en charge dans le header.
Les templates
| Fichier | Lignes | Ce qu'il rend |
|---|---|---|
_head.tt | ~1700 | Le head de chaque page : la feuille de style complète, balisage/styles de la cookie-notice, skip-link, loader d'analytique inline, stylage du password-gate, plus l'include des meta-tags |
_meta_tags.tt | ~60 | Les meta tags Open Graph / Twitter / canonique / hreflang / pagination |
_header.tt | ~66 | Barre logo/identité avec menu de premier niveau + menus déroulants |
_footer.tt | ~20 | Menu de footer, copyright, et (quand des posts existent) lien RSS |
page.tt | ~64 | Une page de contenu |
post.tt | ~120 | Un post de blog : titre, rangée méta, tags, pastille catégorie, temps de lecture, blocks |
blog_index.tt | ~115 | Index de blog paginé avec cartes d'images mises en avant |
_sidebar.tt | ~40 | Widgets de sidebar (paragraphe à propos, posts récents, catégories) |
documents.tt | ~47 | La page documents/téléchargements |
search.tt | ~100 | Résultats de recherche du site adossés à search-index.json |
404.tt | ~20 | La page « Page not found » |
offline.tt | ~20 | Le repli hors ligne de la PWA |
landing.tt + _landing_block_styles.tt | 35 + ~450 | Un layout de landing-page avec stylage de blocks supplémentaire |
raw.tt | ~12 | Passthrough corps-seulement pour les pages exigeant un contrôle total du balisage |
_cookie_notice.tt | ~24 | La bannière de cookies fixe |
_password_gate.tt | ~75 | Gate de mot de passe côté client pour le contenu protégé |
Où vit le stylage
Tout le stylage de l'apparence par défaut est inline dans _head.tt ; il n'y a pas de fichier CSS séparé. Header, hero, typographie des pages et posts, cartes de blog, widgets de sidebar, tables, cookie notice, et les classes wrapper de chaque type de block (.cta-block, .gallery-block, .accordion-block, etc.) y sont définis.
Ce fichier est l'API visuelle du theme : le theme de n'importe quelle page peut déclarer des blocks attendant ces noms de classes. Les tables wrapper/inner de la doc des blocks intégrés sont exactement ce que le Letterbox implémente pour chaque type. Si vous écrivez votre propre theme, reproduisez ce contrat, au minimum, chaque wrapper de block plus son traitement de titre/corps doit être couvert, sinon les blocks rendent quand même mais ressemblent à du non-stylé.
Options qui changent la sortie de Letterbox
- Slots de menu: déclarez des slots de menu supplémentaires dans votre thème (ou clonez le thème) pour ajouter plus que header/footer ; le défaut n'en a que deux.
- Le template de landing-page: une page peut surcharger son template avec un nom de fichier incluant l'extension
.tt(p. ex.landing.ttouraw.tt) ; landing.tt apporte ses propres styles de blocks. - Sortie PWA: activez la PWA et
offline.html/sw.js/manifest.jsonrejoignent la sortie par langue. - Template RAW: une page posée à
raw.ttobtient son corps seul sans aucun échafaudage de thème. - Analytique et consentement: le script GA4/GTM dans
_head.ttne charge qu'après que la cookie notice a enregistré le consentement (ou saute quand aucune notice n'est active), et ne charge jamais du tout en mode air-gap.
Cloner pour faire du Letterbox-plus
L'écran Templates propose Clone (depuis le thème starter configuré, avec Letterbox en repli) et un panneau Generate with Claude qui de même échafaude d'abord un nouveau theme, puis renvoie un prompt à votre assistant pour le travail de templating. Les templates d'un theme peuvent être écrasés directement dans l'éditeur de thème ; leur contenu est scanné pour la sécurité et validé syntaxiquement côté serveur avant d'être accepté. Supprimer un theme n'est permis que pour les thèmes non actifs.
Le mot de la fin
Letterbox est délibérément minimal mais complet ; il rend chaque artefact de sortie du CMS (écrans intégrés compris) avec des classes entièrement orthographiées et de petits templates. Le cloner est le point de départ prévu pour les thèmes personnalisés ; tout ce qu'il vous faut pour cela est dans la doc d'authoring de thème et cette carte de fichiers.