114 lines
5.6 KiB
CSS
114 lines
5.6 KiB
CSS
/* ============================================================================
|
||
主题底稿(scaffold)—— 复制本文件改名为 <slug>.css 即可新增一套主题。
|
||
文件名即 slug:只允许小写字母、数字、连字符(如 sakura / ocean-mist)。
|
||
新增后需在 conf/app.ini 登记:
|
||
|
||
[theme]
|
||
default = default
|
||
available = default,sakura,ocean-mist
|
||
|
||
⚠️ 硬规则(违反会导致深色模式错乱或整页错位):
|
||
1. 两个块都必须写:浅色「html[data-theme-style="SLUG"]」
|
||
与深色「html[data-theme="dark"][data-theme-style="SLUG"]」。
|
||
只写浅色块会连深色模式一起覆盖(同特异性 + 本文件在 base.css 之后加载)。
|
||
2. 只改令牌(下方变量)与「组件微调」段。不要改布局:宽高、margin、padding、
|
||
display / flex / grid、position 一律不动 —— 主题不是换皮模板。
|
||
3. 本文件不参与构建,仅作参考;真正生效的是同目录下的 <slug>.css。
|
||
|
||
── 可用的 20 个令牌 ──────────────────────────────────────────────
|
||
底色层 --tb-bg 页面底色(html/body)
|
||
--tb-surface 卡片、输入框等前景面板
|
||
--tb-surface-2 次级面(标签底、进度条轨道、代码块)
|
||
--tb-surface-hover 悬停底(列表行、下拉项)
|
||
--tb-navbar 顶栏底色(不写则同 --tb-surface;
|
||
页面底色不是白时建议覆盖成 bg 或它的同色,否则顶栏会成为一条白带)
|
||
线条 --tb-border 边框、分隔线
|
||
文字 --tb-text 正文
|
||
--tb-text-secondary 次要文字(说明、meta)
|
||
--tb-text-muted 弱化文字(占位、时间戳)
|
||
强调 --tb-primary 主色:链接、主按钮、进度条
|
||
--tb-primary-weak 主色 10% 左右的浅底(选中态、标签)
|
||
形状 --tb-radius 卡片 12px / --tb-radius-sm 8px / --tb-radius-xs 6px
|
||
阴影 --tb-shadow 卡片默认 / --tb-shadow-hover 悬停
|
||
字体 --tb-font 字体栈(一般不改)
|
||
页面背景 --tb-page-image 整页背景图(cover,fixed)
|
||
--tb-page-pattern 整页图案(平铺,可叠加在背景图之上)
|
||
--tb-page-pattern-size 图案平铺尺寸(默认 auto)
|
||
|
||
── 素材规格(放 R2,不需要重新编译) ─────────────────────────────
|
||
页面背景图 2400×1600(3:2)或 2560×1440,WebP q80,≤300KB;明暗各一张:
|
||
https://r2.337845818.best/tamabox/themes/<slug>/bg-light.webp
|
||
https://r2.337845818.best/tamabox/themes/<slug>/bg-dark.webp
|
||
注意:背景图上还要叠卡片和文字,主题要保证「--tb-surface 不透明」
|
||
或足够对比;照片类背景建议配 10%~20% 的同色半透明遮罩。
|
||
平铺图案 200×200 或 400×400 可无缝平铺,PNG/WebP,≤40KB;
|
||
建议透明度 ≤15%,否则会和正文抢注意力。
|
||
设置页色块 由本文件浅色块的 --tb-bg 与 --tb-primary 自动生成,无需额外素材。
|
||
============================================================================ */
|
||
|
||
/* 1) 浅色(必须)—— 选择器里的 SLUG 换成文件名 */
|
||
html[data-theme-style="SLUG"] {
|
||
--tb-bg: #f7f8fa;
|
||
--tb-surface: #ffffff;
|
||
--tb-surface-2: #f4f6f8;
|
||
--tb-surface-hover: #f3f7ff;
|
||
--tb-navbar: var(--tb-surface); /* 顶栏底色,需要时改成 var(--tb-bg) */
|
||
--tb-border: #e8eaee;
|
||
|
||
--tb-text: #1f2329;
|
||
--tb-text-secondary: #5c6370;
|
||
--tb-text-muted: #8a919c;
|
||
|
||
--tb-primary: #1e87f0;
|
||
--tb-primary-weak: rgba(30, 135, 240, 0.10);
|
||
|
||
--tb-radius: 12px;
|
||
--tb-radius-sm: 8px;
|
||
--tb-radius-xs: 6px;
|
||
|
||
--tb-shadow: 0 1px 2px rgba(16, 24, 40, 0.04), 0 12px 28px -18px rgba(16, 24, 40, 0.20);
|
||
--tb-shadow-hover: 0 1px 2px rgba(16, 24, 40, 0.05), 0 18px 40px -20px rgba(16, 24, 40, 0.28);
|
||
|
||
--tb-font: system-ui, -apple-system, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Noto Sans CJK SC", "Microsoft YaHei", sans-serif;
|
||
|
||
/* 整页背景:两者可同时用,图案叠在图片之上;不需要就保持 none */
|
||
--tb-page-image: none;
|
||
--tb-page-pattern: none;
|
||
--tb-page-pattern-size: auto;
|
||
}
|
||
|
||
/* 2) 深色(必须)—— 深浅两套必须成对,缺一段会让深色用户看到「浅色的深色主题」 */
|
||
html[data-theme="dark"][data-theme-style="SLUG"] {
|
||
--tb-bg: #1a1d23;
|
||
--tb-surface: #242830;
|
||
--tb-surface-2: #2d323c;
|
||
--tb-surface-hover: rgba(92, 141, 255, 0.12);
|
||
--tb-border: #3a404c;
|
||
|
||
--tb-text: #d8dce4;
|
||
--tb-text-secondary: #a8b0bd;
|
||
--tb-text-muted: #8b93a1;
|
||
|
||
--tb-primary: #5c8dff;
|
||
--tb-primary-weak: rgba(92, 141, 255, 0.14);
|
||
|
||
--tb-shadow: 0 1px 2px rgba(0, 0, 0, 0.30), 0 12px 28px -18px rgba(0, 0, 0, 0.55);
|
||
--tb-shadow-hover: 0 1px 2px rgba(0, 0, 0, 0.35), 0 18px 40px -20px rgba(0, 0, 0, 0.65);
|
||
|
||
--tb-page-image: none;
|
||
--tb-page-pattern: none;
|
||
--tb-page-pattern-size: auto;
|
||
}
|
||
|
||
/* 3) 组件微调(可选,默认整段注释掉)
|
||
只允许「外观」层面的补充:边框、阴影、封面遮罩浓度等。
|
||
禁止改尺寸/间距/定位 —— 那属于布局,主题不管。 */
|
||
/*
|
||
html[data-theme-style="SLUG"] .uk-card-default {
|
||
border-color: transparent;
|
||
}
|
||
html[data-theme-style="SLUG"] .tb-pcard {
|
||
box-shadow: var(--tb-shadow);
|
||
}
|
||
*/
|