Thèmes et Design

Un thème Chinaski est un répertoire de fichiers Template Toolkit que le builder statique rend en chaque page publique : le point de contrôle complet de l'apparence d'un site. Cette section couvre le thème livré, chaque fichier de template dont il est fait, comment créer et cloner le vôtre, et les terrains de variables/blocks/assets qui rendent la sortie sûre.

Le modèle de template (commencez ici)

• Fichiers Template: l'ensemble de templates du site (page.tt, post.tt, blog_index.tt, 404, search, offline, et les partials préfixés _), l'ordre de recherche thème-d'abord avec replis intégrés, et comment les templates par page choisissent leur fichier.
• Les templates par base : le shell non-marqué raw.tt, les listings documents.tt, search.tt et offline.tt: chacun avec sa propre page.

Construire votre theme

• Créer & Cloner des Thèmes: le chemin d'upload (règles d'archive, fichiers requis, le scan de sécurité), cloner n'importe quel theme (ce que signifie cloner le default : un répertoire vide avec comportement de repli), et l'export.
• Le Theme Letterbox: le défaut livré, comme votre base de référence/debug.
• Variables & Helpers de Template: ce que chaque template reçoit dans le stash (champs de contenu, réglages du site, arbres de nav, hreflang, JSON-LD...).
• Blocks dans les Thèmes: comment les shortcodes {{block:name​}} et les templates de blocks rendent à l'intérieur de n'importe quel theme.
• Assets de theming & SRI: gestion des assets statiques ; le comportement de cache-busting et d'intégrité pour le CSS admin (et comment la sortie statique livre les siens).
• Design Tokens et Design Briefs: poser les valeurs de marque une seule fois (tokens) et le flux de génération assisté par IA pour un nouveau theme à partir d'un brief.

Ce que vous devriez savoir avant de commencer

• Les replis le rendent sûr. Le répertoire d'un thème actif est recherché en premier, les intégrés en second. Un theme ne livre que les fichiers qu'il change ; un theme auquel manquent des fichiers standards se construit quand même (il utilise simplement les intégrés inchangés). Un clone du thème default démarre comme répertoire de thème vide précisément pour ce flux.
• Tout est en fichiers .tt. Les bases de Template Toolkit (échappement (| html/| uri), INCLUDE/PROCESS, chomp d'espaces) sont dans les pages sécurité/variables, avec les règles de ce qui doit être échappé (tout ce qui est fourni par l'utilisateur excepté body et json_ld).
• Les erreurs ne tuent pas les builds. Les échecs de rendu par template consignent une erreur dans le log de build et continuent ; le tableau de bord nomme les premiers templates en échec.

Le mot de la fin sur la sécurité

L'éditeur de thème n'accepte que les templates sûrs (le scan tourne à l'upload), et le contenu pédagogique de la doc intégrée d'authoring de thème couvre les règles d'échappement, traitez ces règles (échappez les données utilisateur, scripts inline minimaux, prudence avec les éditeurs de snippets) comme des conseils permanents pour vos propres fichiers de thème.