FIT2CLOUD
Cosolar 的图标

Cosolar

4,637
1,630

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

1.1.0
Cosolar 发布于
>=2.20.0

halo-theme-cosolar v1.1.0

一、移动端导航系统重构

导航抽屉优化

  • 子菜单改为手风琴折叠模式,仅展开当前选中的父级菜单
  • 新增半透明毛玻璃遮罩,点击遮罩或按 ESC 键关闭菜单
  • 父级菜单展开时箭头 180° 旋转,提供清晰的状态反馈
  • 顶级菜单以卡片样式呈现(带边框/阴影),子菜单以缩进列表 + 引导线区分层级
  • 菜单打开时锁定背景滚动body.nav-open
  • 窗口 resize 时自动关闭菜单,避免状态残留

导航选中状态修复

  • 修复外部链接(如 https://agentbook.com)导致正则匹配空路径,造成多个按钮同时高亮的问题
  • 将路径匹配条件从 linkPath != "/" 改为 linkPath.length > 1,避免空字符串误匹配

二、首页移动端优化

文章列表布局(仅列表视图,卡片视图不变)

  • 布局改为:标题独占一行 → 图片与(摘要、标签)并列 → 元信息行
  • 摘要可显示 3 行(原为 1 行)
  • 使用 CSS Grid 实现左右分栏,移动端自适应

轮播图优化

  • 移动端轮播高度缩减(768px: 200px,480px: 168px)
  • 新增主题设置项:移动端轮播图仅显示文章封面(默认关闭)
  • 仅封面模式下,优先显示文章自带的封面图(featured.spec.cover),无封面时回退到配置封面或渐变背景

移动端隐藏区域

  • 首页底部「统计信息」和「订阅更新」区块在移动端自动隐藏

三、标签页 / 分类页移动端适配

tag.html / category.html

  • 为文章列表添加 .article-list 容器和 .article-card-text 包装器
  • 使移动端 CSS Grid 布局正确生效(标题 → 图文并列 → 元信息)

四、资讯页(feeds.html)移动端适配

Hero 区域

  • 精简内边距和字号
  • 统计栏改为横向滚动,防止小屏溢出

频道导航重构

  • 移动端隐藏「我的频道」标题和「管理订阅源」按钮
  • 频道标签改为单行横向滚动,胶囊样式,隐藏数字计数
  • 防溢出修复:.feed-sidebar--leftmin-width: 0; overflow: hidden
  • .feed-layout 在 1024px 断点加 min-width: 0

资讯列表

  • 紧凑卡片布局,来源与时间合并一行
  • 标题 + 摘要精简显示

五、友链页(links.html)移动端适配

Hero 区域

  • 768px 断点隐藏第三个装饰性统计项「∞ 无限可能」
  • 统计栏改为横向滚动,适配小屏

筛选 + 搜索工具栏

  • 筛选标签改为单行横向滚动,移动端隐藏标签内数字计数
  • 搜索框从工具栏拆出,独立全宽一行
  • 防溢出修复:.links-toolbarmin-width: 0; overflow: hidden

友链卡片

  • 移动端单列布局,紧凑间距
  • Logo 缩小至 36px(480px: 32px),描述限制 1 行
  • CTA 区域在 480px 隐藏装饰元素

六、全局防溢出修复

  • html 元素添加 overflow-x: hidden,作为防止横向滚动的安全网
  • 所有 CSS Grid 子项在移动端断点添加 min-width: 0,确保 overflow-x: auto 正确生效

升级须知

  1. 在 Halo 后台卸载当前主题
  2. 上传 halo-theme-cosolar.zip重新安装
  3. 清除 Thymeleaf 模板缓存( crucial — 否则模板变更不生效)
  4. 如需启用「移动端轮播图仅显示封面」,前往 主题设置 → 首页轮播 开启

资源下载

  • halo-theme-cosolar.zip