halo-theme-cosolar v1.1.6
新增功能
主题接入了「知识库」功能——可以把成套的文档像书一样组织起来给访客阅读;同时优化了页脚在极简模式下的留白,并让部分插件页面自动拥有和站点一致的外观。
| 项目 |
说明 |
| 主题版本 |
1.1.6 |
| 发布日期 |
2026-08-30 |
| Halo 版本要求 |
>= 2.25.0(较此前上调,升级前请确认 Halo 已达标) |
| 是否需要重新配置 |
不需要,原有主题设置完整保留 |
| 是否需要装插件 |
仅「知识库」功能需要 plugin-minidocs,不装也不影响博客 |
✨ 新增 1:知识库功能(列表页 + 三栏阅读页)
配套 MiniDocs 插件后,你的站点可以多出两个页面:
- 知识库列表页
/docs:像书架一样展示你所有的知识库。
- 知识库阅读页
/docs/view/{知识库}:像看电子书一样浏览文档。
列表页能做什么
- 顶部统计看板:知识库总数、文档总数、标签数量、访问量、点赞量。
- 搜索(按
/ 键即可聚焦)与标签筛选,支持四种排序:最近更新 / 文档最多 / 名称 A-Z / 最新创建。
- 卡片视图与列表视图一键切换;内容多时自动分页。
- 左侧边栏展示「今日动态」(今日更新数、文档总数、贡献者)、「最近更新」和「标签云」,点标签即可筛选。
- 卡片可直接点赞,访客无需登录(浏览器本地记录,避免重复点赞)。
阅读页能做什么
- 三栏布局:左边文档目录树、中间正文、右边文章大纲。
- 点目录直接换文章,不刷新页面,翻文档时不会被打断阅读节奏;地址栏同步变化,方便复制分享。
- 目录树可搜索、可折叠,当前文档自动高亮并展开所在层级。
- 右侧大纲跟随滚动自动高亮所在章节,支持分组展开 / 收起,点击即平滑跳转。
- 代码块带语言标签和一键复制按钮;
mermaid 图表支持「预览 / 源码」切换。
- 两侧栏宽度可拖拽:文档树 200–520px、大纲 170–480px,宽屏窄屏都能调到舒服的比例。
- 底部信息栏显示文档路径、字数、行数、作者与创建 / 更新时间。
- 顶部工具条提供:返回知识库、加入浏览器书签、复制链接、点赞、访问量。
- 完整支持暗色主题与手机浏览。
怎么开启
- 安装并启用
plugin-minidocs 插件(下载:halo-plugin-minidocs Releases)。
- 在插件设置中开启「允许未登录用户阅读」(希望游客也能看的话)。
- 在后台创建至少一个公开知识库,并在其中发布至少一篇文档。
- 访问
/docs 即可看到效果,无需在主题里额外开关页面。
不需要知识库功能?不装插件即可,博客其他部分完全不受影响,只是 /docs 不可访问。
可以设置什么
在 主题设置 → 知识库页设置 中:
| 设置项 |
作用 |
默认 |
| 显示统计栏 |
列表页顶部的五项数据看板 |
开 |
| 显示左侧边栏 |
列表页的今日动态 / 最近更新 / 标签云 |
开 |
| 最近更新显示条数 |
侧栏「最近更新」显示几条,超出内部滚动 |
5 |
| 标签云显示条数 |
侧栏「标签分类」显示几个标签,超出内部滚动 |
10 |
✨ 新增 2:插件页面自动沿用站点外观
主题适配了 Halo 2.26 的「页面布局契约」。简单说:部分支持该能力的插件,其前台页面会自动带上你站点的页头、页脚、主题色与暗色模式,不再出现「点进插件页面突然换了套皮肤」的割裂感。
- 无需任何配置,升级主题后自动生效。
- 在 主题管理 中查看主题状态时,布局契约一项会显示为「支持」。
🐛 修复
- 关闭「页脚主区域」后,底部版权条上下不再出现大片空白,分割线也一并隐藏,极简页脚更紧凑。
💄 细节优化
- 知识库卡片上的标签徽标改为青绿主题色,与站点配色统一。
⬆️ 升级指南
- 确认 Halo 版本 ≥ 2.25.0(后台「关于」或系统信息查看)。低于该版本请先升级 Halo,否则主题会提示版本不满足。
- 从 Releases 下载
halo-theme-cosolar-1.1.6.zip。
- 进入 后台 → 主题管理 → 安装主题,上传 ZIP;若提示已存在,可先卸载旧版再安装,或直接覆盖安装。
- 启用后无需重新配置,原设置项完整保留;新版本只新增了「知识库页设置」分组。
- 首次使用知识库功能,请先完成上面「怎么开启」的 4 步。
❓ 升级后常见问题
升级提示「Halo 版本不满足」怎么办?
把 Halo 升级到 2.25.0 及以上即可。这是本次唯一一项硬性要求变化。
/docs 打不开或列表是空的?
按顺序检查:① 已安装并启用 plugin-minidocs;② 插件设置已开启「允许未登录用户阅读」;③ 至少有一个公开的知识库;④ 库内至少有一篇状态为已发布的文档。
阅读页点目录没反应 / 提示无权限?
阅读页优先走公开接口;若是私有知识库,需要已登录且有权限的账号才能查看,未登录会提示「无权限查看该文档」。
只想安安静静写博客,可以不用知识库吗?
完全可以。不安装 plugin-minidocs 时,主题所有原有功能不受影响,也不会多出任何入口。
历史版本
更早版本的变更记录见 GitHub Releases。
知识库预览

