模板结构总览

一套模板（主题）就是 templates/ 下的一个目录，包含三部分。

目录结构

tech-01/
├── template.php      清单：声明栏目、区块、主题变量与页面模块
├── thumbnail.png     后台模板库里的缩略图
├── views/
│   ├── layout.blade.php    外壳（页头页脚在此引入）
│   ├── pages/              页面级视图，按约定命名
│   ├── sections/           首页区块
│   └── partials/           可复用片段
└── assets/
    ├── css/style.css
    └── js/main.js

视图命名约定

页面视图按「内容种类 + 用途」命名，构建时按这套约定解析：

文件名	用途
home.blade.php	首页
article-list.blade.php	文章类栏目的列表页
article-detail.blade.php	文章类栏目的详情页
product-list.blade.php	产品类栏目的列表页
page.blade.php	通用单页
404.blade.php	404 页

版式变体

同一个栏目想换一套版式时，新增以 -- 连接的变体文件，再到栏目设置里选择：

article-list--grid.blade.php     文章列表的卡片版
article-detail--doc.blade.php    文章详情的文档版

变体名必须以基名加 -- 开头。构建时若选中的变体文件不存在，会静默回退到基名视图—— 换模板后变体消失也不会让站点报错。

引用其它视图

模板内部一律用 tpl:: 命名空间引用，不要写相对路径：

@extends('tpl::layout')
@include('tpl::partials.header')

这样模板被复制成站点私有快照后，引用路径依然成立。