Cosolar

halo-theme-cosolar v1.0.3

✨ 新功能

文章缺省封面图：

• 新增 default_post_cover 配置项，文章未设置封面时自动显示默认图片
• 内置 default_post_cover.png 作为兜底，也可在后台自定义上传

🔧 优化

• 字体设置、图标设置移入「主题样式」分组，设置项更集中
• 分组名称调整：样式设置 > 主题样式，精选文章 > 精选轮播
• 重写 README，分步骤讲解每一组配置的使用场景

🐛 修复

• 修复文章详情页默认封面图不显示的问题（th:if 与 th:with 优先级问题）
• 修复 @{...} 嵌套在 ${...} 内导致的 SpEL 解析错误
• 修复博主名字右上角创作者角标的显示逻辑

halo-theme-cosolar v1.0.2

✨ 新功能

侧边栏新增模块：

• 公告栏 — 在博主信息下方展示公告内容，支持 HTML 富文本，可插入链接和图片
• 热门标签（词云） — 替代旧列表模式，标签字体大小随文章数自动变化，带浮动起伏动画和悬停放大效果
• 公众号二维码 — 在侧边栏展示微信公众号二维码图片，可自定义图片和下方文字

博主信息卡片增强：

• 背景图模式下，遮罩层颜色和透明度现可在后台独立配置
• 博主栏文字颜色可自定义（浅色/深色模式分别配置）
• 深色模式遮罩默认透明度提升至 0.45，阅读体验更佳

社交图标更新：

• 掘金、CSDN、知乎图标更新为官方新版 logo，更清晰现代

🐛 修复

• 修复博主名字右上角创作者角标的显示逻辑

📖 文档

• 重写 README，分步骤讲解每一组配置的使用场景
• 侧边栏各模块说明同步更新

---

⚡ 升级提醒

升级后建议进入 主题设置 > 侧边栏设置，查看新增的公告栏、标签云和公众号二维码配置项，默认均为关闭状态，按需开启即可。

halo-theme-cosolar 是一款为 Halo 2.20+ 打造的现代博客主题，专为技术写作者设计。它把"内容"放回舞台中央 —— 干净的排版、克制的动效、合理的留白，让代码与文字都能舒适呼吸。同时在小屏与移动端做了完整自适应：贴底毛玻璃操作栏、抽屉式目录、自动隐藏的侧边栏，让手机阅读体验与桌面端同样顺滑。

设计亮点

• 🎨 青绿美学 — 默认主色 #10B981，可在后台一键换色，全站按钮 / 链接 / 标签 / 进度条联动
• 🌗 暗色模式 — 跟随系统 / 强制浅色 / 强制暗色三档可切，导航与操作栏毛玻璃风格
• 🖼️ 精选轮播 — 首页顶部卡片轮播，支持手动指定、自动播放、置顶回退
• 🗂️ 分类导航 + 热门标签 + 近期更新 — 侧边栏模块化组件，可单独开关
• 📚 文章目录（TOC） — 桌面端右侧悬浮跟随，移动端抽屉式弹出，1px 极细滚动条
• 📊 阅读进度条 — 顶部 2px 彩色渐变，实时反映阅读位置
• 🖱️ 图片查看器 — 文章图片点击放大，支持滚轮缩放 / 拖动 / 双击复位 / ESC 关闭，零依赖
• 👍 点赞 / 评论 / 分享 / 回顶 — 文章页底部贴底毛玻璃横条，5 按钮平分宽度
• 📱 移动端自适应 — ≤768px 侧边栏自动隐藏，导航汉堡菜单展开，操作栏贴底
• ⚡ Vite 构建 — TypeScript + vite-plugin-halo-theme，产物精简，按模板分块