hexo-theme-particlex 2.0.4 → 2.0.5
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 +24 -24
- package/_config.yml +4 -4
- package/package.json +1 -1
package/README.md
CHANGED
@@ -1,6 +1,6 @@
|
|
1
1
|
# Hexo-Theme-ParticleX
|
2
2
|
|
3
|
-
[
|
3
|
+
[ParticleX](https://github.com/argvchs/hexo-theme-particlex) 主题,诞生原因是因为原来的 [Particle](https://github.com/korilin/hexo-theme-particle) 主题不维护了,但是我觉得还是很好的
|
4
4
|
|
5
5
|
原来用的是 Vue 2 + Ant Design Vue 1,现更新到 Vue 3,去除 Ant Design Vue 采用自定义样式,图标更改为 Font Awesome 6,将不能用的 JSDelivr 改为 Staticfile CDN
|
6
6
|
|
@@ -12,9 +12,9 @@
|
|
12
12
|
|
13
13
|
## 演示
|
14
14
|
|
15
|
-
- Github Pages
|
16
|
-
- Netlify
|
17
|
-
- Vercel
|
15
|
+
- [Github Pages](https://argvchs.github.io)
|
16
|
+
- [Netlify](https://argvchs.netlify.app)
|
17
|
+
- [Vercel](https://argvchs.vercel.app)
|
18
18
|
|
19
19
|
## 安装
|
20
20
|
|
@@ -53,9 +53,9 @@ background: # Home page background image
|
|
53
53
|
highlightStyle: github # Highlight style
|
54
54
|
```
|
55
55
|
|
56
|
-
-
|
56
|
+
- 导航栏
|
57
57
|
|
58
|
-
为了方便,主题使用的图标是
|
58
|
+
为了方便,主题使用的图标是 Font Awesome 6 图标
|
59
59
|
|
60
60
|
```yaml
|
61
61
|
menu:
|
@@ -87,7 +87,7 @@ highlightStyle: github # Highlight style
|
|
87
87
|
|
88
88
|
- 主页信息卡片
|
89
89
|
|
90
|
-
|
90
|
+
和导航栏差不多
|
91
91
|
|
92
92
|
`description` 支持 Markdown 格式
|
93
93
|
|
@@ -97,7 +97,7 @@ highlightStyle: github # Highlight style
|
|
97
97
|
card:
|
98
98
|
enable: true
|
99
99
|
description:
|
100
|
-
- Description
|
100
|
+
- "Description"
|
101
101
|
- "..."
|
102
102
|
iconLinks:
|
103
103
|
{}
|
@@ -110,21 +110,19 @@ highlightStyle: github # Highlight style
|
|
110
110
|
# <name>: <link-url>
|
111
111
|
```
|
112
112
|
|
113
|
-
-
|
113
|
+
- 文档缩略
|
114
114
|
|
115
115
|
一般来说,缩略展示文档只需要在文档中添加 `<!-- more -->` 即可,缩略内容在显示全文中也会出现
|
116
116
|
|
117
|
-
|
117
|
+
但考虑到不想把缩略内容放在正文里,就添加了此参数,在 Front-Matter 里设置
|
118
118
|
|
119
|
-
|
120
|
-
|
121
|
-
例如:(注意换行和转义 `"`)
|
119
|
+
支持 Markdown 格式
|
122
120
|
|
123
121
|
```yaml
|
124
|
-
description: "
|
122
|
+
description: "Normal **Strong** _Italic_"
|
125
123
|
```
|
126
124
|
|
127
|
-
-
|
125
|
+
- 页脚
|
128
126
|
|
129
127
|
考虑到博客部署在服务器并使用自己域名的情况,按国家规定需要在网站下边添加备案消息
|
130
128
|
|
@@ -132,7 +130,7 @@ highlightStyle: github # Highlight style
|
|
132
130
|
|
133
131
|
```yaml
|
134
132
|
footer:
|
135
|
-
since:
|
133
|
+
since: 2022
|
136
134
|
ICP:
|
137
135
|
enable: false
|
138
136
|
code:
|
@@ -141,7 +139,9 @@ highlightStyle: github # Highlight style
|
|
141
139
|
|
142
140
|
- Polyfill
|
143
141
|
|
144
|
-
使用 [Polyfill.io](https://polyfill.io/v3/url-builder) 自动根据 UA 处理新的 JS API
|
142
|
+
使用 [Polyfill.io](https://polyfill.io/v3/url-builder) 自动根据 UA 处理新的 JS API 兼容
|
143
|
+
|
144
|
+
可以配合 [Hexo-Renderer-BabelJS](https://github.com/argvchs/hexo-renderer-babeljs) 插件处理 JS 语法
|
145
145
|
|
146
146
|
```yaml
|
147
147
|
polyfill:
|
@@ -170,11 +170,11 @@ highlightStyle: github # Highlight style
|
|
170
170
|
|
171
171
|
- 搜索
|
172
172
|
|
173
|
-
嵌入到 Archives 中的搜索,搜索数据是用 [Hexo-Generator-Search-Lite](https://github.com/argvchs/hexo-generator-search-lite)
|
173
|
+
嵌入到 Archives 中的搜索,搜索数据是用 [Hexo-Generator-Search-Lite](https://github.com/argvchs/hexo-generator-search-lite) 生成,默认关闭,使用需要安装上述插件并**设置 `optimize: true`**
|
174
174
|
|
175
175
|
目前只支持搜索文档的 Title Categories Tags(我太弱了)
|
176
176
|
|
177
|
-
要同时在主题和根目录的两个 `_config.yml`
|
177
|
+
要同时在主题和根目录的两个 `_config.yml` 添加配置
|
178
178
|
|
179
179
|
```yaml
|
180
180
|
# Theme config
|
@@ -198,7 +198,7 @@ highlightStyle: github # Highlight style
|
|
198
198
|
|
199
199
|
**同样如果没有其他网站,请在 `sites:` 后添加一个 `{}`**
|
200
200
|
|
201
|
-
由于 Gitalk 官方 CORS 代理用的是 Cloudflare,速度过慢,添加了 `proxy`
|
201
|
+
由于 Gitalk 官方 CORS 代理用的是 Cloudflare,速度过慢,添加了 `proxy` 参数,搭建 CORS 代理可以看[这篇文章](https://argvchs.github.io/2022/07/04/build-cors-anywhere)
|
202
202
|
|
203
203
|
```yaml
|
204
204
|
gitalk:
|
@@ -208,7 +208,7 @@ highlightStyle: github # Highlight style
|
|
208
208
|
repo: # The name of repository of store comments
|
209
209
|
owner: # GitHub repo owner
|
210
210
|
admin: # GitHub repo owner and collaborators, only these guys can initialize github issues
|
211
|
-
language: zh-CN # en, zh-CN, zh-TW, es-ES, fr, ru, de, pl and ko are currently available
|
211
|
+
language: zh-CN # en, zh-CN, zh-TW, es-ES, fr, ru, de, pl and ko are currently available
|
212
212
|
proxy: # CORS proxy
|
213
213
|
sites: # Sites
|
214
214
|
{}
|
@@ -221,7 +221,7 @@ highlightStyle: github # Highlight style
|
|
221
221
|
|
222
222
|
Giscus 是一个由 GitHub Discussions 支持的评论系统
|
223
223
|
|
224
|
-
在 [Giscus.app](https://giscus.app)
|
224
|
+
在 [Giscus.app](https://giscus.app) 设置好各项后,会在下面生成一个 `<script>` 标签,在主题内填入即可
|
225
225
|
|
226
226
|
```yaml
|
227
227
|
giscus:
|
@@ -244,9 +244,9 @@ highlightStyle: github # Highlight style
|
|
244
244
|
|
245
245
|
Waline 是一个简单、安全的评论系统
|
246
246
|
|
247
|
-
|
247
|
+
详见:[在 ParticleX 上使用 Waline | Yuzi's Blog](https://blog.yuzi0201.top/posts/bcb4ff00.html)
|
248
248
|
|
249
|
-
**注意如果不需要
|
249
|
+
**注意如果不需要 `locale` 参数,请在 `locale:` 后添加一个 `{}`**
|
250
250
|
|
251
251
|
```yaml
|
252
252
|
waline:
|
package/_config.yml
CHANGED
@@ -1,5 +1,5 @@
|
|
1
|
+
# ParticleX Configuration
|
1
2
|
# https://github.com/argvchs/hexo-theme-particlex
|
2
|
-
# Developer: argvchs
|
3
3
|
|
4
4
|
# Avatar image
|
5
5
|
avatar:
|
@@ -48,7 +48,7 @@ menu:
|
|
48
48
|
card:
|
49
49
|
enable: true
|
50
50
|
description:
|
51
|
-
- Description
|
51
|
+
- "Description"
|
52
52
|
- "..."
|
53
53
|
iconLinks:
|
54
54
|
{}
|
@@ -62,7 +62,7 @@ card:
|
|
62
62
|
|
63
63
|
# Footer info
|
64
64
|
footer:
|
65
|
-
since:
|
65
|
+
since: 2022
|
66
66
|
# Customize the server domain name ICP
|
67
67
|
ICP:
|
68
68
|
enable: false
|
@@ -98,7 +98,7 @@ gitalk:
|
|
98
98
|
repo: # The name of repository of store comments
|
99
99
|
owner: # GitHub repo owner
|
100
100
|
admin: # GitHub repo owner and collaborators, only these guys can initialize github issues
|
101
|
-
language: zh-CN # en, zh-CN, zh-TW, es-ES, fr, ru, de, pl and ko are currently available
|
101
|
+
language: zh-CN # en, zh-CN, zh-TW, es-ES, fr, ru, de, pl and ko are currently available
|
102
102
|
proxy: # CORS proxy
|
103
103
|
sites: # Sites
|
104
104
|
{}
|