halo-theme-dream2.0-plus
本仓库为 `Halo 2.x` 主题仓库。
## [主题预览](https://www.hcjike.com/?preview-theme=theme-dream2-plus)
- [主题文档](https://www.hcjike.com/docs/halo-theme-dream2.0)
- [侧边栏组件](https://www.hcjike.com/docs/halo-theme-dream2.0/theme/sidebar-assembly)
## 插件
### KaTeX
- 安装并启用`KaTeX插件`，插件配置如下；
- 行内公式 CSS 选择器：`[math-inline]`；
- 块级公式 CSS 选择器：`[math-display]`。
### highlight.js 代码高亮
- 安装并启用`highlight.js 代码高亮`插件，插件配置如下；
- **开启**`启用主题侧渲染`；
- 页面规则添加`/**`，匹配所有页面；
- **不开启**`显示复制按钮`，主题端已提供复制按钮，不需要额外开启。
## 开发中功能
- 开发中功能已发布为[预发行版](https://github.com/zsjy/halo-theme-dream2.0-plus/releases)，开发中的功能不保证留存到正式版，包括但不限于：主题配置位置、配置方式、页面样式等等。
## 版本适配关系
| 主题版本 | 适配Halo版本 | 测试用Halo版本 |
| ----------- |----------| -------------- |
| x.x | 2.20.0+ | 2+ |
## 安装 & 更新
1. 进入主题 [Release](https://github.com/zsjy/halo-theme-dream2.0-plus/releases/latest) 界面，下载主题压缩包 `halo-theme-dream2.0-plus.zip` 压缩包文件；
2. 进入博客后台管理 `主题->主题管理->安装主题`，选择下载的 `halo-theme-dream2.0-plus.zip` 安装包进行上传；
3. 等待安装完成；
4. 更新方法同上。
## 参与主题开发
1. 开发环境准备
- 安装 `nodejs` 版本需要在 `15+`；
- 主题目录下执行 `npm i` 安装依赖。
2. npm 命令
- `npm run lint` 执行代码风格校验。
- `npm run zip` 执行安装包打包，在无须重新编译 `js/css` 时使用。
- `npm run build` 执行主题打包操作，主题将被打包为压缩包文件存放在 `dist/` 目录下，同时 `source` 目录下的文件也将被更新。
- `npm run build --devel` 开发模式进行主题打包，`js` 和 `css` 不会被做压缩和混淆处理，方便排查问题。
- `npm run release --tag=$version` 发布模式执行主题打包操作，将自动更新主题中的版本号，并使用这个版本标签重新创建 `FreeCDN` 清单文件。