Jyf - Halo 极简、高级、设计博客主题

一个极简、高级、设计博客主题

在线预览 • GitHub • Halo

✨ 特性

• 🎨 极简设计 - 纯文字风格，专注内容本身
• 🌓 深色模式 - 支持浅色/深色主题切换
• 📊 热力图 - GitHub 风格的文章发布热力图
• 🎯 高度可定制 - 丰富的主题设置选项
• 📱 响应式设计 - 完美适配各种设备
• ⚡ 轻量快速 - 简洁的代码，极速加载
• 🎭 自定义模板 - 内置关于页面和友链页面模板

🎉 支持

主题支持以下 Halo 插件：

• 友情链接（/links）：https://halo.run/store/apps/app-hfbQg
• 图库（/photos）：https://halo.run/store/apps/app-BmQJW
• 瞬间（/moments）：https://halo.run/store/apps/app-SnwWD

📸 预览

在线预览地址：www.jyf.app

🚀 快速开始

环境要求

• Halo 版本 >= 2.20.0

安装方式

方式一：应用市场安装（推荐）

1. 登录 Halo 后台
2. 进入「外观」->「主题」
3. 点击右上角「安装」按钮
4. 选择「远程下载」
5. 输入主题仓库地址：https://github.com/PpKoK/theme-jyf
6. 点击「下载」并等待安装完成
7. 启用主题

方式二：手动安装

1. 下载主题源码

git clone https://github.com/PpKoK/theme-jyf.git

2. 将主题文件夹上传到 Halo 工作目录的 themes 文件夹下

3. 在 Halo 后台「外观」->「主题」中启用主题

⚙️ 主题配置

主题提供了丰富的配置选项，可在 Halo 后台「外观」->「主题」->「主题设置」中进行配置。

基础设置

• Logo 文字 - 顶部导航栏显示的文字
• 站点标题 - 首页显示的标题
• 站点描述 - 首页显示的描述文字
• 文章热力图 - 是否显示 GitHub 风格的文章发布热力图
• 登录按钮 - 是否显示登录按钮

样式设置

• 默认配色 - 选择浅色或深色模式
• 主色调 - 自定义主题色（推荐：#50E3C2、#F5A623、#4A90E2、#8B572A）
• 文字颜色 - 自定义文字颜色
• 背景色 - 自定义背景颜色

页脚设置

• 版权所有者 - 显示在版权信息中的名称
• 版权起始年份 - 版权起始年份
• 底部版权 - 是否显示 Halo 和主题版本信息
• ICP 备案号 - 网站备案信息

关于页面设置

• 大标题文字 - 关于页面的中心标题
• 标签 - 8 个可自定义的个人标签
• 联系方式 - 联系方式标题和内容
• 关于我 - 个人介绍标题和内容
• 技术栈 - 技术栈展示
• 留言板 - 留言板标题

📄 自定义模板

主题提供了以下自定义页面模板：

关于页面

布贴风格的关于页面，展示个人信息、标签、联系方式等。

使用方法：

1. 创建新页面
2. 选择「关于」模板
3. 在主题设置中配置相关内容

友链页面

友情链接展示页面。

使用方法：

1. 创建新页面
2. 选择「友链」模板
3. 在 Halo 后台添加友情链接

🎨 主题特色

文章热力图

主题内置了 GitHub 风格的文章发布热力图，可以直观地展示你的创作活跃度。热力图会自动统计每天发布的文章数量，并用不同深度的颜色表示。

极简设计

主题采用纯文字风格，去除了多余的装饰元素，让读者能够专注于内容本身。简洁的排版和舒适的阅读体验是主题的核心理念。

深色模式

完美支持深色模式，用户可以通过右上角的按钮自由切换浅色和深色主题，保护眼睛的同时提供更好的阅读体验。

🛠️ 技术栈

• Halo 2.x
• HTML5
• CSS3
• JavaScript
• Thymeleaf 模板引擎

📝 更新日志

v1.1.1 (2026-01-16)

• 修复设置bug

v1.1.0 (2026-01-15)

• 新增背景萤火虫粒子效果
  • 可配置粒子数量：关闭/5个/10个/15个/20个（默认10个）
  • 支持浅色和深色模式自定义颜色（默认 #50E3C2）
  • 粒子从底部向上浮动，带有随机水平漂移
  • 发光效果，不干扰页面交互（pointer-events: none）
  • 性能优化，使用 CSS 动画和随机延迟
• 新增页面加载进度条动画
  • 固定在页面顶部，高度 3px
  • 颜色使用主题色
  • 平滑的加载动画效果
• 优化主题切换动画
  • 暗亮模式切换图标增加 180 度旋转动画
  • 图标切换时带有透明度渐变效果
  • 动画时长 0.3 秒，流畅自然
• 优化二级菜单样式
  • 增加 2px 圆角
  • 宽度自适应内容（min-width: max-content）
  • 改善视觉效果和用户体验
• 修复点赞功能 Bug
  • 修复点赞后数量不同步的问题
  • 改为从 API 获取最新点赞数
  • 点赞改为单向操作（不可取消）

v1.0.10 (2026-01-13)

• 新增顶部滚动进度条
  • 固定在页面顶部，高度 3px
  • 颜色自动读取主题设置中的主色调
  • 根据页面滚动进度实时更新
  • 平滑过渡效果，性能优化
• 优化文章详情页点赞按钮布局
  • 点赞按钮移至文章标题右侧，与标题在同一行
  • 解决点赞按钮遮挡 AI 总结组件的问题
  • 移动端保持横向布局，按钮不会被压缩

v1.0.9 (2026-01-13)

• 优化分类页面布局
  • 修改文章列表布局，日期和标题在同一行显示
  • 与标签页面保持一致的显示风格
• 优化文章详情页分类显示
  • 修复多个分类标签显示过于紧凑的问题
  • 分类之间添加 / 当作分隔符
  • 修复模板错误，避免500错误

v1.0.8 (2026-01-12)

• 新增图库页面支持
  • 瀑布流布局展示图片
  • 分类筛选功能
  • lightGallery 灯箱查看
  • 响应式设计，完美适配移动端
• 新增瞬间页面支持
  • 类似评论区的列表布局
  • 支持图片、视频、音频展示
  • 标签筛选功能
  • 点赞功能
  • 自动隐藏正文中的标签
• 修复图库页面 initPhotoGallery 函数作用域错误
• 修复 lightGallery 事件监听器问题
• 优化移动端显示效果

v1.0.7 (2026-01-11)

• 优化主题性能
• 修复已知问题

v1.0.6 (2026-01-10)

• 新增首页置顶文章功能
  • 自动显示最新的一篇置顶文章
  • 标题前显示【置顶】标识（使用主色调）
  • 避免在普通列表中重复显示
• 优化友链页面样式
  • 统一所有友链卡片高度（120px）
  • 标题过长时单行显示并用省略号
  • 描述过长时最多显示2行并用省略号

v1.0.5

• 修复暗亮icon的动画 【更加平滑】
• 删除所有的1px线条

v1.0.4

• 增加暗亮icon的动画
• 增加首页图文列表
• 增加页面点赞功能

v1.0.3

• 增加鼠标设置
• 增加文章目录

v1.0.2

• 优化主题配置项
• 改进响应式布局
• 修复已知问题

v1.0.0

• 首次发布
• 基础功能实现

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证与使用条款

本主题采用自定义许可证，仅供个人非商业使用。

使用权限

• ✅ 个人使用 - 可以在个人博客中免费使用
• ✅ 修改 - 可以修改源代码以适配个人需求
• ✅ 学习研究 - 可以学习和研究代码

使用限制

• ❌ 禁止商业使用 - 不得用于任何商业项目或盈利目的
• ❌ 禁止分发 - 不得分发原始代码或修改后的代码
• ❌ 禁止再许可 - 不得以任何形式重新授权或转让
• ❌ 禁止出售 - 不得出售本主题或其衍生作品

重要说明

1. 本主题仅供个人博客使用，不得用于商业网站或企业项目
2. 不得将本主题打包后分发给他人或上传到其他平台
3. 修改后的版本仅供个人使用，不得公开发布
4. 使用本主题时需保留原作者的版权信息

如需商业使用或特殊授权，请联系作者获取许可。

👨‍💻 作者

• Jyf
• 网站：https://www.jyf.app
• GitHub：@PpKoK

💬 支持

如果你喜欢这个主题，欢迎：

• ⭐ Star 本项目
• 🐛 提交 Issue 反馈问题
• 💡 提交 Pull Request 贡献代码
• 📢 分享给更多人

👥 加入交流群

扫码加入微信交流群，与其他用户一起交流使用心得：
微信：P06230411 「可以拉你们」

Made with ❤️ by Jyf