该主题是 guqing 的 halo-theme-higan 进行了定制化修改后的主题
更激进的修改，更高的配置自由度！
文档版本: 1.7.0
（如此处文档版本小于您正在使用的主题版本，说明您正在阅读一份过时的文档，请到项目原地址阅读最新版本。）
- halo-theme-higan-hz
原主题最新版本为：v2.9.0
而本主题修改基于最新开发版：上游提交日志
- 移除导航栏文字前出现的空白 guqing/halo-theme-higan#113
- 使用 PostCSS + Tailwind CSS + daisyUI 重构，修复上游标注在标签的 class 内但没有正常引入的样式，以及没有正常工作的样式。
如果添加的样式修改是可被配置的（如可修改，可关闭），则不会被列举在此处
- 新增文章顶部分享栏分享方式: QQ 空间
- 修改文章顶部分享栏 Twitter 的链接为 X
- 友链页面允许用户在链接描述使用 HTML 代码块
为方便查找，本主题将选项分类到多栏目下，而不是像原主题集中在一个“样式”栏下。
现分类为“全局”，“总体样式”，“首页样式”，“文章页样式”，“分类集合页样式”，“自定义页面样式”，“瞬间页样式”，“RSS”，“社交资料”。
解释：“现主题设置项位置”（原主题设置项位置）-> 小括号内的为“现主题设置项位置”对应的“原主题设置项位置“。
例：在增加于“总体样式”这一章节中有如下文字：
- “配色方案”（样式-配色方案）
其含义为“总体样式-配色方案”对应原主题“样式-配色方案”选项。
- 添加“CSP:upgrade-insecure-requests”选项，避免 HTTPS 协议网页引用 HTTP 资源时报错。相关文档：CSP: upgrade-insecure-requests - HTTP | MDN
- “配色方案”（样式-配色方案）添加“跟随系统”选项
- 可自定义内容区域最大宽度
（默认值为 48rem。允许全部 CSS 长度单位, 如: 48rem, 780px, 70vw, 70%）
（原主题在之后的更新里更新了自适应最大宽度设置，但是实测会让内容显示偏左，因此项默认开启。如果你想体验上游的最大宽度设置模式，请关闭“总体样式-自定义内容区域最大宽度”这一项设置） - 允许关闭页面底部主题信息
- 允许关闭页面底部版权信息
- 允许关闭页面底部菜单
- 允许添加内容到页脚最底部
- 允许设定主页 HTML 标题，而不是取值于“Halo 设置-基本设置-站点标题”
- 允许同时开启一言和个人简介
- 允许用户修改主页上的固定文本 guqing/halo-theme-higan#86
- 默认值相较于原主题的变化
- Writing -> 近期发布
- Read article -> 阅读全文
- Find me on -> 与我联系
- 默认值相较于原主题的变化
- 允许自由选择是否开关文章列表置顶图标，以及选择图标位置
- 将“文章标题大写”（样式-文章标题大写）配置项移动到这一栏下
- 允许选择是否启用文章与评论区间的分隔线
- 允许选择是否启用文章评论区
- 允许选择是否显示每个分类下的文章数量
- 允许设置在“文章数量”左侧的字符
- 允许设置在“文章数量”右侧的字符
- 允许选择是否显示多层分类
- 允许选择是否启用正文内容与评论区间的分隔线
- 允许选择是否启用评论区
- 允许选择是否启用点赞按钮
- 允许选择是否启用评论区
- 将“首页 RSS 展示”（社交资料-RSS）配置项移动到这一栏下
- 允许自定义 RSS 地址
- 允许设置多个重复的社交平台
- 允许设置社交平台的排列顺序
- 在原支持 Dribbble, Email, Facebook, Github, Instagram, QQ, Telegram, X, 微博的基础上
额外增加对 BiliBili, Reddit, Stack Overflow, YouTube, 豆瓣, 网易云音乐, 知乎的支持
注：没有简书和 CSDN(Copy, Steal and pay-Download Net) 的原因是平台过于小众，甚至 iconify 找不到它们的图标
如何找到一篇文章元数据设置位置：
- 方法一：进入后台管理页面 -> 找到文章管理页 -> 点击一篇文章右边的三个点 -> 弹出的上下文菜单中选择“设置” -> 拉到底部即可见元数据设置位
- 方法二：进入后台管理页面 -> 找到文章管理页 -> 进入一篇文章的编辑页 -> 点击右上角“发布”按钮左侧的“设置”按钮 -> 拉到底部即可见元数据设置位
- 增加“页面标题”配置项，可设定此文章的在浏览页的 HTML 标题（如配置值为空，则 HTML 标题取此文章的标题）
- 配色方案（样式-配色方案）对应的配置名修改:
- 暗黑 -> 暗色
- 白色 -> 亮色
- 亮色 -> 灰粉
- 个人简介（样式-个人简介）输入框高度修改: 100px -> 150px
- 修改 html 标签 lang 属性值，从 en 修改为 zh。
- 重构样式切换方式 (原来是 body 标签的 class 决定样式，现在是 body 标签的 theme 属性的值决定样式)
- 修改项目内各种链接指向分叉后的项目链接，并修改元数据避免与原主题冲突
- 清除无用样式，减小最终文件体积
- 配色方案（样式-配色方案）对应的内部配置值修改，修改值详情请看 v1.0.1
点我展开详情
- 关闭未关闭的
label，使得prettier能正常格式化文件 guqing/halo-theme-higan#92 - 修复原项目不可用的格式化脚本 (
package.json内的npm脚本) guqing/halo-theme-higan#91 - 页面底部的版权信息进行了分行避免在小屏上排版错乱 guqing/halo-theme-higan#87#108
- 补充了部分缺失的
aria-label属性 guqing/halo-theme-higan#83#110 - 修复行内代码渲染问题 guqing/halo-theme-higan#85#109
- 修复错误的大纲定位样式 guqing/halo-theme-higan#69#112
该主题的原作者为 Pieter Robberechts，非常感谢做出这么优秀的主题。
原主题地址：hexo-theme-cactus
- 到 Release 下载最新版的 “Source code (zip)”
- 在 Console 端的主题菜单直接上传安装即可使用
Release v1.2.1 包括之后的版本已上架 halo 应用市场，直接到商店页面下载即可
- 市场链接：应用：彼岸-皓改
- 点击项目主页 HowieHz/halo-theme-higan-hz 绿色的 “<> Code” 按钮
- 选择 “Download ZIP” 下载最新代码
- 在 Console 端的主题菜单直接上传安装即可使用
-
友链页面（/links），需插件 plugin-links
-
图库页面（/photos），需插件 plugin-photos
-
瞬间页面（/moments），需插件 plugin-moments
- 瞬间页面可用于展示 github 活动，此用法请看 howiehz/ghu-events-moments 或 guqing/ghu-events-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，这保证了项目代码格式的统一。
需要提前安装 Node.js，然后运行以下指令安装 pnpm
npm install -g pnpm之后在项目根目录运行以下指令完成依赖的安装
pnpm install开发时在项目根目录运行运行以下指令可实时渲染修改
pnpm dev开发完成后请运行以下的指令进行检查（请确保无 error）
pnpm lint提交前请运行以下的指令的指令格式化代码
pnpm format最后在提交前请不要忘记运行以下的指令构建主题
pnpm build在 .\tmp\ 目录输出未压缩的样式文件，便于追踪问题
pnpm dev-build当前 main 分支适用于 Halo 2.0 版本
适用于 Halo 1.x 版本的主题位于分支 halo-theme-higan 1.x
见 项目 Issue 页面
注：社区意愿较大的 Issue 会列为优先项。如果你对某功能有需求，请一定要在对应 Issue 下回复，或进入我的博客通过其他联系方式联系我，谢谢！
