halo-theme-dream2.0-plus

本仓库为 Halo 2.x 主题仓库。

主题预览

• 主题文档
• 侧边栏组件

插件

KaTeX

• 安装并启用KaTeX插件，插件配置如下；
  • 行内公式 CSS 选择器：[math-inline],.math-inline,.katex--inline；
  • 块级公式 CSS 选择器：[math-display],.math-display,.katex--display。

highlight.js 代码高亮

• 安装并启用highlight.js 代码高亮插件，插件配置如下；
  • 开启启用主题侧渲染；
  • 页面规则添加/**，匹配所有页面；
  • 不开启显示复制按钮，主题端已提供复制按钮，不需要额外开启。

智阅GPT-智能AI摘要

• 不支持pjax
• 文章选择器：.article
• 样式选择器：night

开发中功能

• 开发中功能已发布为预发行版，开发中的功能不保证留存到正式版，包括但不限于：主题配置位置、配置方式、页面样式等等。

关于PR

• 感谢PR，改善主题；
• 将PR提交到dev分支中

版本适配关系

主题版本	适配Halo版本	测试用Halo版本
x.x	2.20.0+	2+

安装 & 更新

1. 进入主题 Release 界面，下载主题压缩包 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 清单文件。