hexo-theme-particlex 2.0.4 → 2.0.5
Sign up to get free protection for your applications and to get access to all the features.
- 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
|
{}
|