Halorum
Halorum 是一款面向 Halo 2.x 的轻论坛风格主题，基于 mulingyuer/Typecho_Theme_JJ 的视觉语言移植并重构。主题使用 Astro 预渲染模板，保留原主题偏社区化、偏技术阅读的气质，同时围绕 Halo 的文章、评论、用户中心和主题设置体系做了适配。
预览地址：https://halorum.kdgq.com/
Github仓库：https://github.com/xzyone/halo-theme-halorum
欢迎大家PR、共同完善主题
特性
- 论坛式首页布局：左侧板块导航、中间文章流、右侧信息栏。
- 首页支持分页模式和无限加载模式，可在后台主题设置中切换。
- 支持自定义首页文章数量、分类卡片、最新文章、文章榜、作者榜和标签榜。
- 文章页提供更贴近社区讨论场景的评论区样式。
- 顶部集成发布入口、通知入口和用户中心头像菜单。
- 支持浅色 / 深色主题、Markdown 样式和代码高亮样式切换。
- 支持自定义
Head HTML、CSS和JavaScript。 - 使用 Astro 构建 Halo 模板，源码和产物分离，便于继续维护。
运行要求
- Halo
>= 2.0.0 - Node.js
>= 18.17.1 - pnpm
>= 10
安装
- 从 Release 下载
Halorum.zip。 - 进入 Halo 后台：
外观->主题->安装主题。 - 上传
Halorum.zip并启用主题。 - 进入主题设置，根据站点需要配置 Logo、首页、评论和样式选项。
主题设置
| 分组 | 说明 |
|---|---|
basic |
Logo、联系信息、备案信息、Markdown 样式、代码高亮样式 |
sidebar |
首页文章数量、加载方式、最新文章、分类卡片和右侧模块 |
forum |
评论排序和评论区文案 |
style |
主题强调色、卡片圆角、顶部阴影 |
custom |
自定义 Head HTML、CSS、JavaScript |
目录结构
Halorum/
├─ public/ 静态资源
├─ scripts/ 打包脚本
├─ src/ Astro 源码
├─ templates/ Halo 模板构建产物
├─ settings.yaml 主题设置描述
└─ theme.yaml Halo 主题元信息
版本记录
v0.0.2
新增
- 首页文章标题支持显示
置顶标识。 - 右侧
文章榜、标签榜标题补充 icon。 - 首页分页模式支持更轻量的局部翻页体验，减少整页刷新带来的闪动。
优化
- 首页文章列表调整为更符合论坛场景的展示逻辑：置顶文章优先展示，非置顶文章优先按最后回复时间排序。
- 右侧
最新文章保持按发布时间排序，不受回复排序影响。 - 首页
分页模式与无限瀑布流模式的实现拆分，避免两套逻辑互相干扰。 - 修复首页无限瀑布流在部分情况下只显示首屏文章、不继续加载的问题。
- 修复首页分页、刷新、点击 Logo 返回首页时的首屏样式闪动问题。
- 优化置顶标识与标题文字之间的间距，整体观感更紧凑。
- 首页、分类页、标签页的文章卡片样式与交互细节进一步统一。
修复
- 修复置顶文章在首页瀑布流/分页场景下可能失效的问题。
- 修复测试回复后帖子不能正确提升到前列的问题。
- 修复分页模式下翻页瞬间右侧侧边栏消失、主列放大、链接样式短暂异常的问题。
- 修复
文章榜、标签榜icon 显示不稳定的问题。
v0.0.1
- 初始发布版本。
- 完成 Typecho 主题视觉迁移和 Halo 主题结构适配。
- 完成首页分页 / 无限加载、论坛式评论区、用户菜单、通知入口和主题设置。
- 优化打包脚本，避免将本地开发目录带入发布包。
致谢
- 原主题：
mulingyuer/Typecho_Theme_JJ - Halo：https://www.halo.run
- Astro：https://astro.build
许可证
本项目采用 BSD-3-Clause 许可证，详见 LICENSE。