定制主题的改法
站点私有快照优先于共享模板,这是定制不被升级覆盖的机制。
渲染源的优先级
构建时按这个顺序决定用哪份模板文件:
诊断覆盖参数 > 站点私有快照 > 共享模板目录
站点私有快照在 storage/app/site-templates/{站点ID}/,结构与共享模板完全一致。
为什么定制要落在快照里
共享模板目录 templates/ 随发行包分发,升级会覆盖。站点私有快照不在发行包的
文件清单内,升级不动它——这就是「定制不被升级替换」的实现方式。
所以:
- 改这一个站的版式 → 改它的私有快照
- 改所有站的版式 → 改共享模板,随版本发布
反过来也要注意:快照一旦生成就会遮蔽后续共享模板的改动。给某站做过定制之后, 核心侧的模板修复不会自动流到这个站上。
静态资源
assets/ 下的文件随构建拷贝到产物目录,模板里用 $base 拼路径:
<link rel="stylesheet" href="{{ $base }}/assets/css/style.css">