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 主题结构适配。
完成首页分页 / 无限加载、论坛式评论区、用户菜单、通知入口和主题设置。
优化打包脚本，避免将本地开发目录带入发布包。

致谢

许可证

本项目采用 BSD-3-Clause 许可证，详见 LICENSE。