Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/can-dy-jack/hexo-theme-delicate
一款 Hexo 主题 / delicate theme for Hexo.
https://github.com/can-dy-jack/hexo-theme-delicate
delicate giscus github-pages hexo hexo-theme hexo-theme-delicate
Last synced: 29 days ago
JSON representation
一款 Hexo 主题 / delicate theme for Hexo.
- Host: GitHub
- URL: https://github.com/can-dy-jack/hexo-theme-delicate
- Owner: can-dy-jack
- License: mit
- Created: 2021-11-05T08:36:29.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-10-09T13:05:55.000Z (about 1 year ago)
- Last Synced: 2024-09-27T12:23:46.767Z (about 1 month ago)
- Topics: delicate, giscus, github-pages, hexo, hexo-theme, hexo-theme-delicate
- Language: Stylus
- Homepage: https://kartjim.cn/delicate/
- Size: 2.66 MB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# hexo-theme-delicate
## 使用
### 方法一
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$$
```
**注：本主题使用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