halo-theme-higan-hz - 一个基于 halo-theme-higan 的魔改主题

halo社区发布地址: halo-theme-higan-hz - 一个基于halo-theme-higan的魔改主题 - Halo 社区
dalao论坛发布地址: halo-theme-higan-hz - 一个基于higan的魔改主题发布 - 大佬论坛 (dalao.net)
个站商店论坛发布地址: 个站商店 - 论坛文章 - halo-theme-higan-hz主题发布 (storeweb.cn)

github代码开源地址: HowieHz/halo-theme-higan-hz: halo主题名彼岸，生死为此岸，涅槃为彼岸；有苦无乐为此岸，无苦无乐为彼岸...它代表着对一切美好的精神追求，也代表着生生不息的轮回亦如本主题分黑白两色，阴极阳至，向死而生。 (github.com)

下载地址：Releases · HowieHz/halo-theme-higan-hz (github.com)

前言

为了定制主题，临时学了一点前端知识，wwwww
halo，thymeleaf的文档写的都很完善，所以改的比较顺畅

guqing大佬的代码写的很好，所以改起来很快（实际上因为太菜，走了很多弯路QAQ

没提pr是因为自己写的代码质量不高，没许可证是因为原项目也没有许可证

---

以下为项目README内容
最新维护时间: 2024.4.19

---

说明

该主题是 guqing 的 halo-theme-higan 进行了个人的定制化修改后的主题

快捷跳转:

• halo-theme-higan-hz
  • 说明
  • 相较于原始主题的修改
    • 样式修复
    • 样式修改
    • 配置项增加
    • 配置项修改
    • 其他
  • 已合并至上游的内容
  • 原项目说明
  • 预览截图
  • 主题应用实例
  • 使用方法
    • 可选插件
  • 进行此项目的开发
    • 开发前准备
      • 安装pnpm
      • 安装项目依赖
    • 开发主题
    • 开发之后
      • 求疵
      • 格式化代码
      • 构建主题
  • 版本适用说明
  • 项目状态
  • Star History

相较于原始主题的修改

样式修复

1. 修复行内代码渲染问题 guqing/halo-theme-higan#85
2. 补充了部分缺失的aria-label属性 guqing/halo-theme-higan#83

样式修改

1. 添加了使用多元列表模式时，置顶文章在首页列表的标识（图标与简洁列表模式一致）
2. 新增文章顶部分享栏分享方式: qq空间
3. 页面底部的 Theme is higan Powered by Halo © 2024 sitename 进行了分行避免在小屏上排版错乱 guqing/halo-theme-higan#87
4. 修改主页上的一些固定文字 guqing/halo-theme-higan#86
   • Writing -> 近期发布
   • Read article -> 阅读全文
   • Find me on -> 与我联系
5. 修改文章顶部分享栏 twitter 的链接为 x

配置项增加

1. 样式-配色方案添加跟随系统
2. 样式 添加 内容区域最大宽度, 默认值与原主题一致为48rem
3. 样式 允许同时开启一言和个人简介

配置项修改

1. 样式-配色方案对应的配置名修改: 暗黑 -> 暗色, 白色 -> 亮色, 亮色 -> 灰粉
2. 样式-配色方案对应的配置值修改，修改值详情请看 v1.0.1
3. 样式-个人简介输入框高度修改: 100px -> 150px

其他

1. 修改html标签lang属性值，lang='en'改为lang='zh'
2. 重构样式切换方式 (原来是body标签的class决定样式，现在是body标签的theme属性的值决定样式)
3. 修改原项目链接指向fork后的项目链接，修改元数据避免与原主题冲突

已合并至上游的内容

1. 关闭未关闭的label，使得prettier能正常格式化文件 guqing/halo-theme-higan#92
2. 修复原项目不可用的格式化脚本 (package.json内的npm脚本) guqing/halo-theme-higan#91

原项目说明

该主题的原作者为 Pieter Robberechts，非常感谢做出这么优秀的主题。

原主题地址：hexo-theme-cactus

预览截图

待添加...

主题应用实例

howiehz.top

使用方法

Release版本获取方法:

1. 到 Release 下载最新版的 Source code (zip)
2. 在 Console 端的主题菜单直接上传安装即可使用

最新开发版本获取方法:

1. 点击项目主页 HowieHz/halo-theme-higan-hz 绿色的<> Code按钮
2. 选择Download ZIP下载最新代码
3. 在 Console 端的主题菜单直接上传安装即可使用

可选插件

• 友链页面（/links），需插件 plugin-links
• 图库页面（/photos），需插件 plugin-photos
• 瞬间页面（/moments），需插件 plugin-moments
• 评论功能，需插件 plugin-comment-widget
• 搜索功能，需插件 plugin-search-widget
• 代码渲染，需插件: plugin-highlightjs
• • 暗黑模式下，代码块高亮主题推荐选择an-old-hope.min.css
• 图片灯箱，需插件: plugin-lightgallery
• • 页面匹配规则 推荐设置为

路径匹配	匹配区域
/archives/**	article .content
/moments	article .content .medium
/moments/**	article .content .medium

进行此项目的开发

首先请确保你的编辑器支持EditorConfig

开发前准备

安装pnpm

需要提前安装 Node.js，然后运行以下指令安装 pnpm

npm install -g pnpm

安装项目依赖

之后在项目根目录运行以下指令完成依赖的安装

pnpm install

开发主题

开发时在项目根目录运行运行以下指令可实时渲染修改

pnpm dev

开发之后

求疵

开发完成后请运行以下的指令进行检查（请确保无 error）

pnpm lint

格式化代码

提交前请运行以下的指令的指令格式化代码

pnpm prettier

构建主题

最后在提交前请不要忘记运行以下的指令构建主题

pnpm build

版本适用说明

当前 main 分支适用于 Halo 2.0 版本

适用于 Halo 1.x 版本的主题位于分支 halo-theme-higan 1.x

项目状态

Star History