@media 不提升特异性:作用域块 html[data-theme-style][data-page-scope="box"] 是 (0,2,1), 媒体查询里写的 html[data-theme-style] 只有 (0,1,1),于是「窄屏装饰层全置 none」这行 从来没生效 —— 手机上照样铺开桌面的花枝与花朵。深色作用域块是 (0,3,1),更压不住。 - 媒体查询里补三条同特异性的通配规则(作用域 0,2,1 / 深色基础 0,2,1 / 深色+作用域 0,3,1), 媒体块在文件更后,同特异性即胜出。 - 新增 TestNarrowMediaOverridesScopedDeco:外层每处非 none 的 --tb-deco,都要求窄屏里有 同属性名、属性数不少于它的声明。变异验证过(删掉深层那条立即 FAIL)。 它同时报出 shiroko 的 900px 块只覆盖浅色 —— 但深色块本就是 none,不算缺陷,故跳过。 - 窄屏改由加强版底纹承担樱花(透明度 ×1.9、格子 180px):桌面那套 0.18~0.34 的透明度 在 390px 上实测接近纯粉。顶栏与卡片之间那条 35px 带子试过放小花,question/admin 页卡片 从 y=110 起会切掉一半,最终不放装饰层。
4.4 KiB
4.4 KiB
2026-10-22
new-sakura 主题:纯 CSS 樱花
用户要求「用编辑器生成 new-sakura,CSS 做樱花、每页位置不同、上传到已配好的 S3」。
- 结论:生成器做不了这个 —— 它的装饰层只支持图片素材(导出打 zip / 传对象存储), 没有内联 SVG 图层。所以改成手写主题 CSS(结构完全遵循生成器输出:令牌 + 10 槽 deco + scope 覆盖),生成器只用来做视觉验证。
- 实现:
dev/theme-tools/gen_new_sakura.py生成static/css/themes/new-sakura.css。 花/瓣/枝/底纹都是内联 SVG 的 data URI(quote(svq, safe="")全编码,避免 URI 里的 逗号被TestDecoSlotCount当成分层符)。CSS 50KB(gzip ≈12KB)。 - 六个 scope 各一套
--tb-deco位置;窄屏(≤640px)装饰全关、底纹缩到 200px; 深色换亮粉 + 关底纹(浅粉压深底=噪点)。 - 调参踩到的:①花枝
auto 390px放右上角时可见部分只剩一团花 → 缩到 300px 并内移; ②枝上 5 朵 scale≈1 的花是一串糖葫芦 → 改成 8 朵 0.4~0.62; ③底纹 260px 双花双瓣读成「包装纸」→ 改成 300px 一朵花 + 两片瓣、各自错位。 - 对比度:primary 候选
#c14a72只有 4.39:1,压深到#b8436a(4.87);muted#77626a(5.27); 深色#ff93b4(8.17)/#ab9099(5.82)。 - i18n 四份词典加
theme.name.new-sakura(插在 shiroko 之后,gofmt_keep_crlf 后每份只 +1 行);conf/app.sample.ini的 available 登记。 - ⚠️ 本机 Chrome/Edge 的 localStorage 里没有生成器的 S3 配置记录,项目也没有
conf/app.ini→ 「已预先配置好的 S3」在本机取不到,上传这一步需要用户给凭据。 纯 CSS 主题本身零素材,严格来说 S3 无事可做(已向用户确认)。
R2 自定义域可用 + 素材包一键上传(接上一条)
r2.337845818.best实测公开可读(7 个对象全部 200、Content-Type 正确);桶的 S3 endpoint 仍 403。- 樱花位图从
gen_new_sakura.py的同一份 SVG 导出(export_assets.py直接 import 它,不另画),--upload一次传 CSS + 5 张 webp + 生成的 INSTALL.txt(域名/体积写实数)。 serve.upload_files支持逐文件cacheControl:原来硬编码 immutable,而INSTALL.txt/ 镜像 CSS 的键不带版本 → 改了看不到。现在位图 1 天、CSS 5 分钟、README 60 秒。- ⚠️ CF 边缘缓存不会因为重传而失效:第一版以 immutable 传过,
cf-cache-status: HIT、Age>800, 重传后拿到的仍是旧副本(带?cb=才是新内容)。清缓存只能去控制台按 URL 清。 - ⚠️ gzip 纠错:服务端
internal/route/gzip.go会压 CSS,内联版 51KB 实际传输 3.9KB, 位图版 2.7KB + 5 张图 48.9KB ≈ 51.6KB。所以"换位图省 CSS 体积"是错的 —— 位图唯一的理由是素材要给非 CSS 场景复用。文档与 INSTALL.txt 都已改。 image_bucket_cdn_host沿用 app.ini 同名键(只写主机名),export_assets.py据此拼公开地址。
6) 窄屏覆盖被作用域块压死(真 bug,已修)
- 现象:
@media (max-width:640px)里把--tb-deco全写 none,手机上却照样是桌面装饰层。 - 根因:媒体查询不提升特异性。作用域块
html[data-theme-style][data-page-scope="box"]是 (0,2,1),媒体里写的html[data-theme-style]只有 (0,1,1) → 压不住;深色作用域块 (0,3,1) 更难。 - 修法:媒体查询里按「作用域通配
[data-page-scope](0,2,1)」+「深色基础(0,2,1)」+ 「深色+作用域(0,3,1)」各写一条,靠文件更晚取胜。shiroko 的 900px 块只对浅色有效, 但它的深色块本来就是 none,所以不算坏。 - 守门:新增
internal/theme/narrow_test.go::TestNarrowMediaOverridesScopedDeco——外层每处非 none 的--tb-deco,媒体查询里必须有「同属性名、属性数不少于它」的选择器; 变异验证过(删掉深色基础那条立刻 FAIL)。 - 手机端最终决定不放装饰层:试过顶栏与卡片之间那条 35px 带子,box 页 OK、question/admin 页卡片从 y=110 起就切半个 → 变成黏在卡片边的粉色碎块。改用加强版底纹(透明度 ×1.9、格子 180px)。
- 埋点:
gofmt -l internal/theme会报slots_test.go(它是 CRLF),新增文件是 LF,别顺手格式化它。