hexo-theme-delicate/README.md

simple but delicate theme for Hexo

# hexo-theme-delicate

> ! 本主题处于 version4 重构开发阶段 !

## 使用
### 方法一
npm 下载使用：
```bash
npm i hexo-theme-delicate
```

然后在根目录的 `_config.yml` 下配置 `theme: delicate` 并重启项目

### 方法二 **推荐**
git clone 本主题的文件：
```bash
git clone https://github.com/can-dy-jack/hexo-theme-delicate.git themes/delicate
```

然后在根目录的 `_config.yml` 下配置 `theme: delicate` 并重启项目

### 主题配置
到主题下的配置文件 `_config.yml` 进行配置。

如果您是使用方法一进行安装的，需要新建 `_config.delicate.yml` 文件，并将主题仓库下的配置文件复制进去进行配置。这种方式的缺点就是**每次更新主题配置并不会热更新，需要重启项目**，所以推荐方式二进行主题安装！

## 使用注意事项
本主题支持的语言如下
- 中文简体 `zh-CN`
- English `en`

## 近期更新
### done
- [x] stylus mixins 和 functions
- [x] 标签和分组颜色支持自定义
- [x] 优化阅读更多按钮设计
- [x] 页面 title 信息
- [x] 更新hexo官网主题图片

### Giscus 评论功能
只有在文档的 Front-matter 里加入
```yml
giscus: true
```
才会在本页面开启 Giscus


### 公式支持
> 使用CDN支持 `mathjax` 和 `katex`

开启方式：在文档的 Front-matter 里加入:
```yml
mathjax: true
```
或
```yml
katex: true
```
即可。

不需要渲染公式的文章请不要开启！避免影响页面加载速度！

`katex`渲染示例：
```katex
$$\begin{pmatrix}a_{11} & a_{12} & a_{13}\ a_{21} & a_{22} & a_{23}\ a_{31} & a_{32} & a_{33}\end{pmatrix}$$

---

$$a^2+b^2=c^2$$
```

![katex.png](https://s2.loli.net/2023/07/16/lcUwDYPa7IOnTQ8.png)

**注：本主题使用CDN加载公式转换脚本的方式支持公式。**  
**您可以在博客根目录下安装[`hexo-filter-mathjax`](https://github.com/next-theme/hexo-filter-mathjax)或`hexo-math`等插件来支持公式，这样就可以在打包的时候就完成公式的渲染，加快请求速度。（使用插件的话记得关闭主题的公式支持）**

## TODOs
- [ ] 代码块复制按钮，mac样式
- [ ] i18n
- [ ] 更新文章

### BUGs 🐛
- [ ] 首页无公式渲染

### In progress
- [ ] scripts
- [ ] 置顶文章功能
- [ ] 移动适配

### Planning ~
- [ ] 接入更多评论系统
- [ ] 广告支持
- [ ] 黑暗模式
- [ ] RSS

## 推荐插件
- [hexo-reference](https://github.com/kchen0x/hexo-reference) markdown脚注

## 主题扩展
- [giscus-theme-delicate](https://github.com/can-dy-jack/giscus-theme-delicate) A theme for giscus, using in hexo-theme-delicate