Temas e Design

Um tema Chinaski é um diretório de arquivos Template Toolkit que o builder estático renderiza em cada página pública : o ponto de controle completo de como um site parece. Esta seção cobre o tema embarcado, cada arquivo de template de que ele é feito, como criar e clonar os seus, e as terras de variáveis/blocos/assets que tornam a saída segura.

O modelo de templates (comece aqui)

• Arquivos de Template : o conjunto de templates de site (page.tt, post.tt, blog_index.tt, 404, search, offline, e os partials com prefixo _), a ordem de busca tema-primeiro com fallbacks embutidos, e como os templates por página escolhem seu arquivo.
• Os templates por base: o shell não identificado raw.tt, as listagens documents.tt, o search.tt, e o offline.tt : cada um com sua própria página.

Construindo seu tema

• Criar & Clonar Temas : o caminho de upload (regras de arquivo, arquivos obrigatórios, a varredura de segurança), clonar qualquer tema (o que clonar o default significa: um diretório vazio com comportamento de fallback), e exportação.
• O Tema Letterbox : o padrão embarcado, como sua base de referência/depuração.
• Variáveis & Helpers : o que cada template recebe no stash (campos de conteúdo, configurações de site, árvores de navegação, hreflang, JSON-LD…).
• Blocos em Temas : como os shortcodes {{block:name​}} e os templates de bloco renderizam dentro de qualquer tema.
• Assets & SRI : tratamento de assets estáticos; o comportamento de cache-busting e integridade do CSS de admin (e como a saída estática embarca os seus).
• Design Tokens e Design Briefs : definindo valores de marca uma vez (tokens) e o fluxo de geração assistido por IA para um tema novo a partir de um brief.

O que você deve saber antes de começar

• Os fallbacks o deixam seguro. O diretório do tema ativo é buscado primeiro, os built-ins em segundo. Um tema só embarca os arquivos que muda; um tema sem os arquivos padrão ainda constrói (apenas usa os built-ins inalterados). Um clone do tema padrão começa como um diretório de tema vazio exatamente para esse fluxo.
• Tudo são arquivos .tt. O básico de Template Toolkit (escapamento (| html/| uri), INCLUDE/PROCESS, chomp de espaços em branco) está nas páginas de segurança/variáveis : com as regras do que deve ser escapado (tudo fornecido pelo usuário exceto body e json_ld).
• Erros não matam builds. Falhas de renderização por template registram um erro no build log e continuam; o dashboard nomeia os primeiros templates que falharam.

O fundamento de segurança

O editor de temas só aceita templates seguros (a varredura executa no upload), e o conteúdo educativo no doc embutido de Theme Authoring cobre as regras de escapamento : trate essas regras (escape os dados do usuário, scripts inline mínimos, trate os editores de snippet com cuidado) como orientação permanente para os seus próprios arquivos de tema.