Skip to content

About

基于现代前端技术栈的 Halo 2.0 主题 - Sky Theme

Resources

Stars

46 stars

Watchers

1 watching

Forks

Repository files navigation

Sky Blog Theme

基于 Vite + Tailwind CSS v4 + DaisyUI + Alpine.js 构建的现代化 Halo 2.0 博客主题

Halo License Node

📖 简介

Sky Blog Theme 是一款功能丰富、高度可定制的 Halo 2.0 主题,采用现代前端技术栈开发。

核心特点:

  • 🎨 35 套 DaisyUI 主题,可视化预览切换
  • 🧩 首页自由排印 Widget 组件流
  • 👾 独家 Illustration 动态怪兽表情登录
  • 📱 面向移动端和桌面端的响应式布局
  • ⚡ 按页面拆分资源并适配 PJAX 生命周期
  • 🔧 灵活的后台配置
  • 🧩 丰富的插件适配

🌐 演示

链接 说明
在线演示 5ee 博客
完整文档 配置指南和使用说明
应用市场 Halo 官方应用市场

✨ 功能特性

功能 说明
🎨 35 套主题 DaisyUI 预设主题,可视化预览选择
🌓 明暗切换 浅色/深色主题独立配置,全景背景蒙版
🧩 Widget 流 首页可拖拽式/自由排序功能模块组件流
👾 动态插画登录 认证页独家插画视线跟随、害羞看密码体验
📱 响应式 移动端和桌面端布局(带高斯模糊侧边栏)
⚡ 加载动画 多种动画样式,避免闪烁
🎯 悬浮控制栏 多种样式可选
📝 列表风格 卡片/列表/杂志/极简
🌐 背景定制 图片背景、天气联动和 3 种首页背景特效
📊 GitHub 热力图 贡献统计展示
🖼️ 高级图库 JS Masonry 瀑布流、照片详情页、无限滚动、PJAX 适配
📚 文档中心 集成 Docsme 项目、目录、正文和评论
👤 作者主页 独立模板,支持文章/瞬间/动态展示
💻 极客终端 独家终端风格认证界面
🧊 玻璃拟态 全局磨砂质感设计
🏷️ 丰富短代码 提示块/折叠/标签页/时间轴等
🔍 全局搜索 支持文章/页面/瞬间/分类搜索
🎭 Iconify 图标 菜单/分类/标签/装备支持自定义图标选择器
📸 瞬间动态 前端发布瞬间,内置1/2/3/4+多图自适应瀑布流网格及弹性悬浮动画
🧭 归档探索 按年月组织的时间树视图,支持分页

📄 模板适配

核心页面

模板 文件 说明
首页 index.html 文章列表、瞬间、朋友动态 Tab 切换
文章 post.html 文章详情、目录、评论、SEO 优化
页面 page.html 独立页面
作者 author.html 作者主页、文章/瞬间列表
归档 archives.html 按年月归档
分类 categories.html / category.html 分类列表/分类文章
标签 tags.html / tag.html 标签云/标签文章

自定义模板

模板 文件 说明
关于页 page_about.html 个人介绍、技术栈、GitHub 统计
卡片风格 category-card.html 分类文章卡片布局
列表风格 category-list.html 分类文章列表布局
杂志风格 category-magazine.html 分类文章杂志布局
极简风格 category-minimal.html 分类文章极简布局

插件模板

模板 文件 依赖插件 说明
友链 links.html PluginLinks 友情链接、RSS 动态与申请
图库 photos.html / photo.html PluginPhotos 瀑布流图库、照片详情
瞬间 moments.html / moment.html PluginMoments 瞬间列表/详情
文档 docs.html / doc.html / doc-catalog.html plugin-docsme 知识库文档
追番 bangumis.html plugin-bilibili-bangumi Bilibili 追番
Steam steam.html halo-plugin-steam Steam 游戏库
装备 equipments.html plugin-equipment 装备分组展示
豆瓣 douban.html plugin-douban 类型、题材筛选

侧边栏小工具

组件 说明 依赖
作者卡片 头像、名称、简介、社交链接 无
欢迎卡片 天气信息、问候语、日期显示 无
最新文章 最新发布的文章列表 无
热门文章 访问量最高的文章列表 无
分类列表 文章分类导航 无
标签云 文章标签聚合 无
博客统计 文章数、分类数、标签数、最后更新 无
文章目录 当前正文标题导航 无
归档导航 按年月定位文章 无
追番卡片 Bilibili 追番轮播展示 plugin-bilibili-bangumi
Steam 卡片 Steam 游戏信息展示 steam
在线统计 在线人数和访问统计 online

🛠️ 技术栈

技术 版本 说明
Vite 8.x 构建工具
Tailwind CSS 4.x 原子化 CSS
DaisyUI 5.x UI 组件库
Alpine.js 3.x 响应式框架
Thymeleaf 3.x 模板引擎
TypeScript 6.x 类型安全

🔌 插件适配

主题对以下插件提供模板、DOM 或样式集成。当前实装版本、官方稳定目标及本轮验证边界见当前逐插件结果;契约基线见插件适配矩阵,以往测试保留在历史运行态审计。安装后仍需在目标 Halo 站点回归。下表中的 ✅ 只表示仓库存在主题集成,不表示当前站点安装版本已完成运行态测试;未进入矩阵的插件也不能自动视为兼容。

内容类

插件 应用市场 GitHub 主题支持
瞬间管理 app-SnwWD plugin-moments ✅ 前端发布、媒体上传
朋友圈(退役) app-yISsV plugin-friends 不再适配;RSS 动态统一使用 PluginLinks /links?view=friends
Docsme 文档 app-yffxw - ✅ 按 1.7.0 契约集成项目、目录、正文和 DocTree 评论
图库管理 app-BmQJW plugin-photos ✅ 瀑布流相册、照片详情页、PJAX 生命周期适配
链接管理 app-hfbQg plugin-links ✅ 友链、分组、RSS 动态与申请统一展示
友链提交(退役) app-glejqzwk plugin-link-submit 不再适配;访客申请统一使用 PluginLinks 2.3.0 的申请接口
联系表单 app-gSebd - ✅ 兼容 2.1.0 的 embed/trigger/自动展示与 PJAX 清理,保留旧版变量;提交、上传及通知未验
超链接卡片 - plugin-editor-hyperlink-card ✅ 块级/行内 Shadow DOM、390px、暗色与 PJAX 重入通过
抽奖卡片 - plugin-lottery ✅ 宿主布局;参与、验证码和开奖需有效活动回归
限制阅读 app-TzRqd - ✅ 宿主、登录和文章/单页评论依赖;各模式待实站回归
维护模式 - plugin-maintenance ✅ 1.1.0 独立品牌模板与返回入口;真实全站切换未执行

扩展类

插件 应用市场 GitHub 主题支持
Bilibili 追番 app-OTFPN plugin-bilibili-bangumi ✅ 追番列表、轮播卡片
Steam 游戏库 app-0ojqyzfh plugin-steam ✅ 游戏库展示、侧边栏卡片
投票管理 app-veyvzyhv plugin-vote ✅ 1.1.3 的 25 个主题变量与结束态组件通过;有效投票写操作未验收
装备管理 app-ytygyqml plugin-equipment ✅ 装备展示/我的装备
豆瓣记录 app-srBOL plugin-douban ✅ 海报网格/筛选展示

工具类

插件 应用市场 GitHub 主题支持
Shiki 代码高亮 app-kzloktzn plugin-shiki ✅ 代码块美化
KaTeX 数学公式 - plugin-katex ✅ 3.0.0 公式溢出与 PJAX 脚本重执行契约
搜索组件 app-DlacW plugin-search-widget ✅ 全局搜索
评论组件 app-YXyaD plugin-comment-widget ✅ 评论系统
文本绘图 app-ahBRi plugin-text-diagram ✅ 1.5.2 默认节点、SVG、明暗重绘与 PJAX 重入通过
AI 助手 app-riNgb - ✅ 3.0.0 摘要宿主契约;前阶段 3.1.0 + Foundation 1.3.0 的既有摘要读取、展示与 PJAX 离页清理有证据,模型生成、自动注入、RAG/编辑器 AI 未验,见适配状态
lightgallery app-OoggD plugin-lightgallery ✅ 稳定 selector DOM 与 PJAX 后兼容重放
Passkey 认证 app-g7tggrco plugin-auth-passkey ✅ 登录入口和认证 options 请求通过;真实凭据认证未执行
在线统计 - - ✅ 插件可用时显示;禁用或失败时不再请求 API

存储类

瞬间前端发布功能需要配置存储策略。这里描述的是 Halo 通用附件上传能力,不是对每个存储插件版本的兼容承诺。

存储插件 图片 视频 音频 状态 说明
本地存储 ✅ ✅ ✅ 推荐 内置,无需配置
S3/OSS ✅ ✅ ✅ 推荐 云存储,支持 CDN
Lsky 图床 ✅ ❌ ❌ 可用 仅支持图片,有压缩
Alist ❌ ❌ ❌ 不可用 当前主题不支持

Alist 说明:当前主题直接标记 Alist 存储不可用,不作为瞬间前端发布后端,也不安排真实上传复测。请使用本地存储或 S3。


🚀 快速开始

安装主题

方式 1:应用市场(推荐)

  1. Halo 后台 → 外观 → 主题
  2. 点击右上角 "安装主题" → "从应用市场安装"
  3. 搜索 "Sky Blog" 并安装

方式 2:手动安装

  1. 从 Releases 下载最新版本
  2. Halo 后台 → 外观 → 主题 → 安装主题
  3. 上传 .zip 文件并启用

配置主题

  1. 启用主题后,点击主题卡片的 "主题设置"
  2. 根据需要配置各个模块(参考 完整文档)
  3. 建议配置项:
    • 通用设置 → 选择主题和颜色
    • 首页设置 → 配置头部背景
    • 导航设置 → 配置菜单和 Logo

推荐插件

安装以下插件以获得完整体验:

  • 必装:搜索组件、评论组件
  • 推荐:瞬间、图库、链接管理、装备管理
  • 可选:Docsme 文档、追番、Steam、豆瓣、Passkey 认证
  • 友链版本:当前实装和稳定目标为 PluginLinks 2.5.0,主题继续采用 2.3.0 的 Finder/API 契约;访客站内申请需在插件后台开启申请功能,申请/审核写入未验。旧版朋友圈和友链提交插件已退出主题集成。

🔧 开发指南

环境要求

  • Node.js >=24.18.0 <25(本地版本文件与 CI 固定为 24.21.0)
  • pnpm 12.6.0
  • Java 21+ (运行 Halo)

使用 nvm 时,在项目目录执行 nvm use,再运行下方的 pnpm 命令;其他版本管理器可读取 .node-version。

开发命令

pnpm install    # 安装依赖
pnpm dev        # 开发模式(热更新)
pnpm build      # 校验插件契约、构建资源并打包主题
pnpm lint       # 代码检查
pnpm verify:plugin-contracts # 校验版本矩阵与模板契约
pnpm format     # 代码格式化

目录结构

theme-sky-blog-1/
├── src/              # 前端源码
│   ├── common/       # 公共资源(main.js, CSS, Alpine 组件)
│   ├── pages/        # 页面特定资源
│   └── static/       # 静态资源
├── templates/        # Halo 模板文件
│   ├── assets/       # 构建产物(自动生成)
│   └── modules/      # 模板模块
├── docs/             # 主题配置文档
├── theme.yaml        # 主题元数据
├── settings.yaml     # 后台配置表单
└── vite.config.ts    # Vite 构建配置

📚 文档

完整的配置文档请访问:

主要章节


🐛 问题反馈

如果你遇到问题或有功能建议:

  1. GitHub Issues:提交 Issue
  2. 加入社群:与其他用户交流
企业微信(备注进群) QQ 群

⚠️ 卖服务器的广告人,就不要加了。


🤝 贡献

欢迎提交 PR 和 Issue!

贡献指南:

  • Fork 项目并创建分支
  • 遵循项目代码规范(ESLint + Prettier)
  • 提交前运行 pnpm lint、pnpm verify:plugin-contracts 和 pnpm build-only
  • 提交信息遵循 Conventional Commits

⭐ Star History

如果这个主题对你有帮助,欢迎 Star 支持!


📄 许可证

GPL-3.0


💖 鸣谢

感谢以下开源项目:

About

基于现代前端技术栈的 Halo 2.0 主题 - Sky Theme

Resources

Stars

46 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages