theme: 启动日志暴露未登记的主题

新增主题后忘了写进 [theme] available，表现只是"设置页里找不到"，日志里没有任何痕迹。现在启动时会打： - info 主题注册表已加载 enabled=... - warn [theme] available 未登记以下主题 themes=shiroko available=... discover() 用 fs.Glob 扫内嵌 css/themes/*.css，按 slug 规则过滤掉 _scaffold.css。示例配置补上 shiroko，文档补「部署后看不到主题」的两步排查。
2026-10-19 21:05:46 +08:00
parent 1a8938f0e1
commit a6059bec1b
5 changed files with 98 additions and 0 deletions
@@ -169,6 +169,10 @@
  必须在任何 i18n 取词之前调用，否则先渲染出的提示会按访客语言。箱主未配语言时才回退访客/站点默认。
 - 主题 = 一个 css 文件只覆盖令牌；新增主题不用改 Go/模板，放 `static/css/themes/<slug>.css` +
  `[theme] available` 登记即可（`static/fs.go` 已嵌整个目录）。底稿 `_scaffold.css`。
+- ⚠️ **`[theme] available` 是硬白名单，启动时读一次**：css 随二进制发布了但没登记，设置页就是看不到，
+  现象和「部署没生效」一模一样。排查先分两类 —— `curl /static/css/themes/<slug>.css` 返回 200 说明文件在
+  （那就是没登记），404 才是旧二进制；`StaticVersion` 只管缓存、不影响列表。
+  启动日志会打 `主题注册表已加载 enabled=...` 与 `[theme] available 未登记以下主题`（2026-10-19 加）。
 - 带图片素材的主题把图放 `static/images/themes/<slug>/`（`static/fs.go` 的 embed 已含 `images/themes`，
  子目录自动覆盖；**新增别的顶层目录才要改清单**）。整页图用 16:9 + 竖版两张，靠 `@media` 切换 ——
  `--tb-page-image` 是 `cover`，贴着图片边缘放的插画会被按视口裁掉。