2.3 KiB
2.3 KiB
mint-breeze 皮肤包
由 blue-white 派生的清新薄荷风皮肤（docs/10 契约 §5 工作流）。升级随版本发布，不在站点间复制目录。
注：本包与 fresh-mint 为同源并存的两个车道产物（并发会话分道，2026-09-08），互不依赖；站点二选一即可。
风格定位
清爽、亲和，适合职业院校门户：薄荷青品牌色、圆角 12px、卡片纯白+柔和阴影、细线顶栏+居中 logo（桌面吸顶，移动端取消）、列表卡片网格（一行 3 张）、几何圆点装饰与大留白；无纹理、无通栏大图、无复杂动效。
数据契约（模板可取用的 model 属性全集，契约 §3）
| 页面 | 属性 |
|---|---|
| 全部 | site（快照：config/分类树/轮播/友链组/院系子站）、url（PortalUrlHelper：home/category/article/asset/search/siteHome）、themeBase（=themes/mint-breeze）、navCategories、pageTitle、seoDescription、canonical、themeParams（微调参数，仅 theme.json 声明过的 key）、themeVarsCss（服务端预构建 :root{} 覆盖串，无参数为空） |
| home | banners（时间窗内 home 位）、topArticles（置顶+最新 6）、categoryBlocks（LIST 型根栏目块，各 top 8） |
| list / search | listData（分页）、category（list）、q + searchMode（search） |
| detail | article、prevArticle、nextArticle、currentCategoryId |
| single | category（含 content）、currentCategoryId |
原则：皮肤不得假设"首页一定有轮播"，对空集合优雅降级。
轮播图尺寸约定（bannerSize）
1920x560（管理端上传端按此引导裁剪，D2 决策点）。
可调参数
见 theme.json 的 params：
- color（进 CSS 变量）：
primary主色 /primaryDark主色加深（即强调色，用于品牌文字与悬停加深）/primaryLight主色提亮 /bg页面底色 /cardBg卡片底色 /border边框色 /text正文文字 /textLight次要文字。 - select：
listLayout=grid（默认，卡片网格一行 3 张）或row（传统行列表）。
换色建议：主色系三值同步调整（primary / primaryDark / primaryLight），bg 与 border、primaryLight 保持同族浅色调，避免底色与卡片对比失衡。
优先级：custom_css > themeVarsCss > main.css。