定制主题的改法

站点私有快照优先于共享模板,这是定制不被升级覆盖的机制。

渲染源的优先级

构建时按这个顺序决定用哪份模板文件:

诊断覆盖参数  >  站点私有快照  >  共享模板目录

站点私有快照在 storage/app/site-templates/{站点ID}/,结构与共享模板完全一致。

为什么定制要落在快照里

共享模板目录 templates/ 随发行包分发,升级会覆盖。站点私有快照不在发行包的 文件清单内,升级不动它——这就是「定制不被升级替换」的实现方式。

所以:

  • 改这一个站的版式 → 改它的私有快照
  • 改所有站的版式 → 改共享模板,随版本发布

反过来也要注意:快照一旦生成就会遮蔽后续共享模板的改动。给某站做过定制之后, 核心侧的模板修复不会自动流到这个站上。

静态资源

assets/ 下的文件随构建拷贝到产物目录,模板里用 $base 拼路径:

<link rel="stylesheet" href="{{ $base }}/assets/css/style.css">