halo-theme-dream2.0-plus
本仓库为 Halo 2.x 主题仓库。
主题预览
| 站点名 | 预览地址 |
|---|---|
| 宏尘极客 | https://www.hcjike.com |
主题文档
温馨提示:若您遇到问题,请首先查阅相关文档。对于文档中已明确说明的事项,将不再另行答复。
开源项目声明
为保障各位用户的权益,避免因信息混淆造成不必要的损失,现就本项目的赞助与官方渠道事宜郑重声明如下:
1. 赞助渠道
本项目为个人维护的开源作品。若您认可本项目并愿意支持开发者,以下指定的官方赞助渠道:
- 爱发电(https://afdian.com/a/org-hcjike):此为本项目内明确标注的主要赞助方式。
- 作者个人站点【宏尘极客(https://www.hcjike.com)】文章内所留的微信、支付宝赞赏码。
2. 严正防骗警示
除以上两条明确列出的渠道(项目文档页标注的爱发电、站点文章内的微信/支付宝赞赏)外,作者从未开通、授权或认可任何其他形式的赞助或收款方式。
- 包括但不限于:任何第三方平台的个人转账、QQ/微信群红包、付费入群、商业合作募捐等。任何以本项目名义发起的此类资金索求,均为诈骗行为,请务必警惕,切勿上当。
3. 关于第三方群聊的免责声明
作者从未组建且未授权任何第三方组建与本项目相关的交流群。任何存在的群聊均为用户自发行为,其言论、活动及可能产生的任何纠纷均与作者无关,作者不对此承担任何责任。
4. 利益关系撇清
用户赞助行为纯属自愿支持,作者不对使用本项目的任何后果承担责任。作者完全抛开并拒绝承担任何因用户参与非官方渠道活动(如第三方群聊、非官方赞助等)所产生的一切利益纠纷和法律连带责任。
总结:认准官方渠道,保护个人财产。所有官方信息与链接仅通过项目文档页及【宏尘极客】博客发布,请勿轻信任何其他来源的信息。
开发中功能
- 开发中功能已发布为预发行版,开发中的功能不保证留存到正式版,包括但不限于:主题配置位置、配置方式、页面样式等等。
版本适配关系
| 主题版本 | 适配Halo版本 | 测试用Halo版本 |
|---|---|---|
| 1.6.6+ | 2.21.0+ | 2+ |
| 1.5.3+ | 2.20.19+ | 2+ |
| 1.3.1+ | 2.20.0+ | 2+ |
安装 & 更新
- 进入主题 Release 界面,下载主题压缩包
theme-dream2-plus-xxx.zip压缩包文件,xxx为版本号; - 进入博客后台管理
主题->主题管理->安装主题,选择下载的theme-dream2-plus-xxx.zip安装包进行上传; - 等待安装完成;
- 更新方法同上。
参与主题开发
-
开发环境准备
- 安装
nodejs版本需要在15+,建议使用22+; - 主题目录下执行
npm i安装依赖; - 开发时建议使用
npm run dev进行打包,用于安装调试,此命令无需手动修改版本号,每次打包都会自动更新版本号; - 提交PR时,如非必要请不要提交
theme.yaml、package.json、package-lock.json、.eslintrc.js文件;
- 安装
-
npm 命令
-
npm run lint执行代码风格校验。 -
npm run zip执行安装包打包,在无须重新编译js/css时使用。 -
npm run build-res --tag=$version用于编译特定版本资源,在工作流中发布npm使用,主题中src目录下的js和css文件将会被编译为assets目录下的文件,同时assets目录下的文件将会被更新。 -
npm run dev执行主题打包操作,根据执行时间打包生成0.0.yyyyMMddHHmmss格式的版本号,用于测试环境安装调试。 -
npm run build执行主题打包操作,主题将被打包为压缩包文件存放在dist/目录下,同时assets目录下的文件也将被更新。 -
npm run build --devel开发模式进行主题打包,js和css不会被做压缩和混淆处理,方便排查问题。 -
npm run release --tag=$version发布模式执行主题打包操作,将自动更新主题中的版本号,并使用这个版本标签重新创建FreeCDN清单文件。
-