hexo-theme-particlex 2.7.0 → 2.7.1
Sign up to get free protection for your applications and to get access to all the features.
- package/README.md +34 -34
- package/package.json +1 -1
package/README.md
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
# Hexo-Theme-ParticleX
|
2
2
|
|
3
|
-
[ParticleX](https://github.com/theme-particlex/hexo-theme-particlex) 主题,诞生原因是因为原来的 [Particle](https://github.com/korilin/hexo-theme-particle)
|
3
|
+
[ParticleX](https://github.com/theme-particlex/hexo-theme-particlex) 主题,诞生原因是因为原来的 [Particle](https://github.com/korilin/hexo-theme-particle) 主题不维护了,但是我觉得还是很好的。
|
4
4
|
|
5
|
-
原来用的是 Vue 2 + Ant Design Vue 1,现更新到 Vue 3,去除 Ant Design Vue 采用自定义样式,图标更改为 Font Awesome 6,CDN 改为 Staticfile
|
5
|
+
原来用的是 Vue 2 + Ant Design Vue 1,现更新到 Vue 3,去除 Ant Design Vue 采用自定义样式,图标更改为 Font Awesome 6,CDN 改为 Staticfile。
|
6
6
|
|
7
7
|
原项目 `README.md` 里说:
|
8
8
|
|
9
|
-
> 目前有 Full、Night 和 Maiden
|
9
|
+
> 目前有 Full、Night 和 Maiden **两个**主题样式。
|
10
10
|
|
11
|
-
但是更改后只有一种了,如果你想改颜色就在 `main.css`
|
11
|
+
但是更改后只有一种了,如果你想改颜色就在 `main.css` 里替换吧。
|
12
12
|
|
13
13
|
# 1. 演示
|
14
14
|
|
@@ -23,7 +23,7 @@ cd themes
|
|
23
23
|
git clone https://github.com/theme-particlex/hexo-theme-particlex.git particlex --depth=1
|
24
24
|
```
|
25
25
|
|
26
|
-
然后在根目录 `_config.yml` 设置主题为 ParticleX
|
26
|
+
然后在根目录 `_config.yml` 设置主题为 ParticleX 即可。
|
27
27
|
|
28
28
|
```yaml
|
29
29
|
theme: particlex
|
@@ -31,7 +31,7 @@ theme: particlex
|
|
31
31
|
|
32
32
|
## 2.1. 关闭自带代码高亮
|
33
33
|
|
34
|
-
Hexo 有自带的代码高亮,但是和 ParticleX
|
34
|
+
Hexo 有自带的代码高亮,但是和 ParticleX 的不兼容。
|
35
35
|
|
36
36
|
```yaml
|
37
37
|
highlight:
|
@@ -40,7 +40,7 @@ prismjs:
|
|
40
40
|
enable: false
|
41
41
|
```
|
42
42
|
|
43
|
-
如果使用 Pandoc
|
43
|
+
如果使用 Pandoc 还需要设置一下:
|
44
44
|
|
45
45
|
```yaml
|
46
46
|
pandoc:
|
@@ -50,7 +50,7 @@ pandoc:
|
|
50
50
|
|
51
51
|
## 2.2. 禁用年度月度归档
|
52
52
|
|
53
|
-
Hexo 会自动生成年度月度归档,可是 ParticleX
|
53
|
+
Hexo 会自动生成年度月度归档,可是 ParticleX 主题没有这个功能。~~我太懒了~~
|
54
54
|
|
55
55
|
```yaml
|
56
56
|
archive_generator:
|
@@ -61,13 +61,13 @@ archive_generator:
|
|
61
61
|
daily: false
|
62
62
|
```
|
63
63
|
|
64
|
-
修改完请 `hexo cl`
|
64
|
+
修改完请 `hexo cl` 清除缓存。
|
65
65
|
|
66
66
|
# 3. 配置
|
67
67
|
|
68
68
|
## 3.1. 基本配置
|
69
69
|
|
70
|
-
`background`
|
70
|
+
`background` 参数是一个列表,打开时会随机加载一个背景。
|
71
71
|
|
72
72
|
```yaml
|
73
73
|
# Avatar image
|
@@ -96,7 +96,7 @@ colors:
|
|
96
96
|
|
97
97
|
### 3.2.1. 导航栏
|
98
98
|
|
99
|
-
为了方便,主题使用的图标是 Font Awesome 6
|
99
|
+
为了方便,主题使用的图标是 Font Awesome 6 图标。
|
100
100
|
|
101
101
|
```yaml
|
102
102
|
# ParticleX theme icon is adopts the Font Awesome 6
|
@@ -128,9 +128,9 @@ menu:
|
|
128
128
|
|
129
129
|
### 3.2.2. 主页信息卡片
|
130
130
|
|
131
|
-
`description` 支持 Markdown
|
131
|
+
`description` 支持 Markdown 格式。
|
132
132
|
|
133
|
-
|
133
|
+
图标链接 `iconLinks` 配置和导航栏配置相同。
|
134
134
|
|
135
135
|
```yaml
|
136
136
|
# Side info card
|
@@ -146,9 +146,9 @@ card:
|
|
146
146
|
|
147
147
|
### 3.2.3. 页脚
|
148
148
|
|
149
|
-
|
149
|
+
考虑到博客部署在服务器并使用自己域名的情况,按规定需要在网站下边添加备案消息。
|
150
150
|
|
151
|
-
|
151
|
+
如没有需要显示备案消息的可以关闭。
|
152
152
|
|
153
153
|
```yaml
|
154
154
|
# Footer info
|
@@ -165,9 +165,9 @@ footer:
|
|
165
165
|
|
166
166
|
### 3.3.1. Polyfill
|
167
167
|
|
168
|
-
使用 [Polyfill.io](https://polyfill.io) 自动根据 UA 处理新的 JS API
|
168
|
+
使用 [Polyfill.io](https://polyfill.io) 自动根据 UA 处理新的 JS API 兼容。
|
169
169
|
|
170
|
-
可以配合 [Hexo-Babel](https://github.com/theme-particlex/hexo-babel) 插件处理 JS
|
170
|
+
可以配合 [Hexo-Babel](https://github.com/theme-particlex/hexo-babel) 插件处理 JS 语法兼容。
|
171
171
|
|
172
172
|
```yaml
|
173
173
|
# Polyfill
|
@@ -180,9 +180,9 @@ polyfill:
|
|
180
180
|
|
181
181
|
### 3.3.2. 代码高亮
|
182
182
|
|
183
|
-
使用 Highlight.js
|
183
|
+
使用 Highlight.js 代码高亮。
|
184
184
|
|
185
|
-
样式可以在[这里](https://highlightjs.org/static/demo)选择,默认为 GitHub
|
185
|
+
样式可以在[这里](https://highlightjs.org/static/demo)选择,默认为 GitHub。
|
186
186
|
|
187
187
|
```yaml
|
188
188
|
# Highlight.js
|
@@ -194,7 +194,7 @@ highlight:
|
|
194
194
|
|
195
195
|
### 3.3.3. 数学渲染
|
196
196
|
|
197
|
-
使用 KaTeX
|
197
|
+
使用 KaTeX 渲染数学公式。
|
198
198
|
|
199
199
|
```yaml
|
200
200
|
# KaTeX math rendering
|
@@ -204,7 +204,7 @@ math:
|
|
204
204
|
|
205
205
|
### 3.3.4. 图片预览
|
206
206
|
|
207
|
-
|
207
|
+
简单的点击图片放大缩小的预览。
|
208
208
|
|
209
209
|
```yaml
|
210
210
|
# Image preview
|
@@ -214,11 +214,11 @@ preview:
|
|
214
214
|
|
215
215
|
### 3.3.5. 文章缩略
|
216
216
|
|
217
|
-
一般来说,缩略展示文档只需要在文档中添加 `<!-- more -->`
|
217
|
+
一般来说,缩略展示文档只需要在文档中添加 `<!-- more -->` 即可,缩略内容在显示全文中也会出现。
|
218
218
|
|
219
|
-
但考虑到不想把缩略内容放在正文里,就添加了此参数,在 [Front-Matter](https://hexo.io/docs/front-matter)
|
219
|
+
但考虑到不想把缩略内容放在正文里,就添加了此参数,在 [Front-Matter](https://hexo.io/docs/front-matter) 里设置。
|
220
220
|
|
221
|
-
支持 Markdown
|
221
|
+
支持 Markdown 格式。
|
222
222
|
|
223
223
|
```yaml
|
224
224
|
description: |
|
@@ -227,11 +227,11 @@ description: |
|
|
227
227
|
|
228
228
|
### 3.3.6. 文章置顶
|
229
229
|
|
230
|
-
在 [Front-Matter](https://hexo.io/docs/front-matter) 里设置 `pinned` 作为置顶参数,越大越靠前,默认为 0
|
230
|
+
在 [Front-Matter](https://hexo.io/docs/front-matter) 里设置 `pinned` 作为置顶参数,越大越靠前,默认为 0。
|
231
231
|
|
232
232
|
### 3.3.7. 文章加密
|
233
233
|
|
234
|
-
使用 AES 加密算法,在 [Front-Matter](https://hexo.io/docs/front-matter) 里设置 `secret` 作为密码,**使用请安装插件 [Hexo-Helper-Crypto](https://github.com/theme-particlex/hexo-helper-crypto)
|
234
|
+
使用 AES 加密算法,在 [Front-Matter](https://hexo.io/docs/front-matter) 里设置 `secret` 作为密码,**使用请安装插件 [Hexo-Helper-Crypto](https://github.com/theme-particlex/hexo-helper-crypto)**。
|
235
235
|
|
236
236
|
```yaml
|
237
237
|
# Article encryption
|
@@ -241,9 +241,9 @@ crypto:
|
|
241
241
|
|
242
242
|
### 3.3.8. 搜索
|
243
243
|
|
244
|
-
嵌入到 Archives
|
244
|
+
嵌入到 Archives 中的搜索。
|
245
245
|
|
246
|
-
|
246
|
+
目前只支持搜索文档标题。
|
247
247
|
|
248
248
|
```yaml
|
249
249
|
# Search
|
@@ -255,9 +255,9 @@ search:
|
|
255
255
|
|
256
256
|
### 3.4.1. Giscus
|
257
257
|
|
258
|
-
Giscus 是一个由 GitHub Discussions
|
258
|
+
Giscus 是一个由 GitHub Discussions 支持的评论系统。
|
259
259
|
|
260
|
-
在 [Giscus.app](https://giscus.app) 设置好各项后,会在下面生成一个 `<script>`
|
260
|
+
在 [Giscus.app](https://giscus.app) 设置好各项后,会在下面生成一个 `<script>` 标签,在主题内填入即可。
|
261
261
|
|
262
262
|
```yaml
|
263
263
|
# Giscus
|
@@ -280,9 +280,9 @@ giscus:
|
|
280
280
|
|
281
281
|
### 3.4.2. Gitalk
|
282
282
|
|
283
|
-
Gitalk 是一个基于 GitHub Issue 和 Preact
|
283
|
+
Gitalk 是一个基于 GitHub Issue 和 Preact 的评论系统。
|
284
284
|
|
285
|
-
由于 Gitalk 官方 CORS 代理用的是 Cloudflare,速度过慢,搭建 CORS 代理可以看[这篇文章](https://argvchs.github.io/2022/07/04/build-cors-anywhere)
|
285
|
+
由于 Gitalk 官方 CORS 代理用的是 Cloudflare,速度过慢,搭建 CORS 代理可以看[这篇文章](https://argvchs.github.io/2022/07/04/build-cors-anywhere)。
|
286
286
|
|
287
287
|
```yaml
|
288
288
|
# Gitalk
|
@@ -300,7 +300,7 @@ gitalk:
|
|
300
300
|
|
301
301
|
### 3.4.3. Waline
|
302
302
|
|
303
|
-
Waline
|
303
|
+
Waline 是一个简单、安全的评论系统。
|
304
304
|
|
305
305
|
详见:[在 ParticleX 上使用 Waline | Yuzi's Blog](https://blog.yuzi.dev/posts/bcb4ff00.html)
|
306
306
|
|
@@ -334,7 +334,7 @@ waline:
|
|
334
334
|
|
335
335
|
### 3.4.4. Twikoo
|
336
336
|
|
337
|
-
Twikoo
|
337
|
+
Twikoo 是一个一个简洁、安全、免费的静态网站评论系统。
|
338
338
|
|
339
339
|
```yaml
|
340
340
|
# Twikoo
|