hexo-theme-particlex 2.7.0 → 2.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|