FIT2CLOUD
Cosolar 的图标

Cosolar

4,637
1,630

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

1.1.2
Cosolar 发布于
>=2.20.0

halo-theme-cosolar v1.1.2

新增功能

  • 邮箱密码找回页面:新增 password_reset_email_send.htmlpassword_reset_email_reset.html 两个官方网关片段,以及 send.html / reset.html 页面,全部中文化(标题、副标题、按钮、提示、错误文案),采用居中的单栏美化布局。
  • 文章页面设置分组:在后台设置中新增独立的「文章页面(post)」分组,集中管理文章相关配置:
    • show_post_title:是否显示文章标题(默认开)。
    • toc_show_h1:右侧目录是否包含正文 H1 级标题(默认关)。
    • show_content_h1:是否渲染显示正文内手动撰写的 H1 标题(默认开),与目录 H1 开关相互独立。
    • toc_width:文章目录宽度(默认 240,范围 180–320),由原「主题样式」分组迁入。
    • default_post_cover:文章缺省封面图,由原「主题样式」分组迁入。

问题修复

  • 注册页邮箱注册不正常
    • 错误提示缺失、协议勾选校验、提交时字段 trim、与官方片段对齐等问题已修复。
    • 注册失败时顶部错误红框无文字的问题修复:增加 !#strings.isEmpty(error) 判断与兜底文案「注册失败,请检查填写内容」。
  • 注册页表单挤压:优化注册表单布局,避免邮箱/验证码区域在窄屏下被挤压,并兼容移动端显示。
  • 注册失败滚动问题:表单在 ≤900px 视口下由框内滚动改为页面自然滚动(height:auto / min-height:100dvh / overflow:visible),不再出现框内滚动条。
  • 退出页头像占位优化:用户未设置头像时展示首字母渐变圆标占位(青绿色渐变)。
  • 退出页 500 错误:修复 SpEL 表达式中混用选择表达式 *{...} 与工具表达式 #strings 导致的 TemplateProcessingException。同时修正头像判断始终走占位逻辑的问题(th:object 上下文下误用 ${spec.avatar} 读不到值),现统一使用 ${user.spec.avatar} 等完整路径,已设置头像时正确显示真实头像。
  • 注册页 / 登录页移动端兼容:补充 iOS 输入防缩放(font-size:16px)、断点响应式(768 / 480 / 360 / 横屏)等适配。

其他

  • 后台「主题样式(style)」分组中的 toc_widthdefault_post_cover 已迁出至新的「文章页面(post)」分组,所有代码引用同步由 style.* 改为 post.*
  • docs/使用教程.md 同步更新:目录与章节重新排序,文章页面成为独立第 17 节,并完整列出 5 个设置项说明。

升级提示

直接覆盖主题文件并重新构建(pnpm build)即可。设置项 post.* 已带默认值,旧站点的 style.toc_width / style.default_post_cover 配置将不再生效,请到「文章页面」分组重新确认。

资源下载

  • halo-theme-cosolar.zip