forked from volantis-x/hexo-theme-volantis
-
Notifications
You must be signed in to change notification settings - Fork 0
/
_config.yml
executable file
·1333 lines (1257 loc) · 55.3 KB
/
_config.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
############################### Volantis ###############################
info:
theme_name: Volantis # This is theme's name.
theme_docs: https://volantis.js.org/ # This is theme's URL.
theme_repo: https://github.com/volantis-x/hexo-theme-volantis
# Debug 调试模式
debug: false
############################### 默认占位图 ###############################
default:
avatar: volantis-static/media/placeholder/avatar/round/3442075.svg # https://cdn.jsdelivr.net/gh/cdn-x/[email protected]/avatar/round/3442075.svg
link: volantis-static/media/placeholder/link/8f277b4ee0ecd.svg # https://cdn.jsdelivr.net/gh/cdn-x/[email protected]/link/8f277b4ee0ecd.svg
cover: volantis-static/media/placeholder/cover/76b86c0226ffd.svg # https://cdn.jsdelivr.net/gh/cdn-x/[email protected]/cover/76b86c0226ffd.svg
image: volantis-static/media/placeholder/image/2659360.svg # https://cdn.jsdelivr.net/gh/cdn-x/[email protected]/image/2659360.svg
############################### CSP ###############################
# 内容安全策略( CSP ) meta 标签 http-equiv="Content-Security-Policy"
# https://developer.mozilla.org/zh-CN/docs/Web/HTTP/CSP
# https://content-security-policy.com/
# 也可以设为 false 在 HTTP 标头中设置 https://volantis.js.org/v5/advanced-settings/#设置-HTTP-响应标头
csp:
enable: true
content: "
default-src 'self' https:;
block-all-mixed-content;
base-uri 'self' https:;
form-action 'self' https:;
worker-src 'self' https:;
connect-src 'self' https: *;
img-src 'self' data: https: *;
media-src 'self' https: *;
font-src 'self' data: https: *;
frame-src 'self' https: *;
manifest-src 'self' https: *;
child-src https:;
script-src 'self' https: 'unsafe-inline' *;
style-src 'self' https: 'unsafe-inline' *;
"
# 可以使用自动程序替换默认的 'unsafe-inline' 和 * 生成更严格的内容安全策略.
# 另可以参考官网的 gulp 方案.
# gulpfile.js https://github.com/volantis-x/community/blob/main/gulpfile.js
############################### CDN ###############################
# 本地静态文件使用 CDN 加速
# 默认使用 https://unpkg.com/hexo-theme-volantis@<%- theme.info.theme_version %>/source/js/*.js ，注意版本号对应关系！！可以通过修改以下配置项覆盖
# 开发者注意 cdn.enable 设置为 false
cdn:
enable: false
# CDN 前缀，为空使用默认值，链接最后不加 "/",
# 例如： https://cdn.jsdelivr.net/gh/volantis-x/volantis-x.github.io@gh-page 填写最后编译生成的源码CDN地址前缀，此路径下应该含有/js与/css目录,
# 该配置默认值是："https://unpkg.com/hexo-theme-volantis@"+ theme.info.theme_version +"/source"
prefix: #https://unpkg.com/hexo-theme-volantis/source
# 以下配置可以覆盖 cdn.prefix,配置项的值可以为空，但是要使用CDN必须依据路径填写配置项的键
set:
js:
app: /js/app.js
css:
style: /css/style.css # (异步加载样式)
# 静态资源版本控制
# 本地文件使用文件内容的hash值作为版本号(app.8c1e7c88.js) 其他为时间戳 (?time=1648684470140)
# 建议静态资源设置标头 浏览器缓存一年边缘缓存一个月 cache-control: max-age=86400, s-maxage=31536000 如果有更新记得刷新缓存
cdn_version: true
# volantis static 静态资源文件 npm 包 CDN 地址 (后面加 "/" )
# https://github.com/volantis-x/volantis-static
volantis_static_cdn: https://unpkg.com/[email protected]/
########################################################################
# 全局页面字符串替换 A => B (可用于临时修改错字等)
replace:
- https://cdn.jsdelivr.net/npm/ => https://unpkg.com/
- https://cdn.jsdelivr.net/gh/ => https://gcore.jsdelivr.net/gh/
# dns-prefetch preconnect x-dns-prefetch-control
dns_prefetch:
- https://unpkg.com
# 平滑滚动效果
scroll_smooth: true
############################### Navigation Bar ############################### > start
# 注意事项：建议规范全站路径 URL 最后带一个 "/" 例如 "about/"
navbar:
visiable: auto # always, auto
logo: # choose [img] or [icon + title]
img: volantis-static/media/org.volantis/blog/[email protected] # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/blog/[email protected]
icon:
title:
menu:
- name: 博客
icon: fa-solid fa-rss
url: /
- name: 分类
icon: fa-solid fa-folder-open
url: categories/
- name: 标签
icon: fa-solid fa-tags
url: tags/
- name: 归档
icon: fa-solid fa-archive
url: archives/
- name: 友链
icon: fa-solid fa-link
url: friends/
- name: 关于
icon: fa-solid fa-info-circle
url: about/
search: Search... # Search bar placeholder
############################### Navigation Bar ############################### > end
############################### Cover ############################### > start
cover:
height_scheme: full # full, half
layout_scheme: dock # blank (留白), search (搜索), dock (坞), featured (精选), focus (焦点)
display:
home: true
archive: true
others: false # can be written in front-matter 'cover: true'
background: https://gcore.jsdelivr.net/gh/MHG-LAB/cron@gh-pages/bing/bing.jpg
# background: https://bing.ioliu.cn/v1/rand?w=1920&h=1200
logo: # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/blog/[email protected]
title: 'Volantis'
subtitle: ''
search: A Wonderful Theme for Hexo # search bar placeholder
features:
- name: 文档
icon: #
img: volantis-static/media/twemoji/assets/svg/1f5c3.svg # https://cdn.jsdelivr.net/gh/twitter/[email protected]/assets/svg/1f5c3.svg
url: /v4/getting-started/
- name: 帮助
icon: #
img: volantis-static/media/twemoji/assets/svg/1f516.svg # https://cdn.jsdelivr.net/gh/twitter/[email protected]/assets/svg/1f516.svg
url: faqs/
- name: 示例
icon: #
img: volantis-static/media/twemoji/assets/svg/1f396.svg # https://cdn.jsdelivr.net/gh/twitter/[email protected]/assets/svg/1f396.svg
url: /examples/
- name: 社区
icon: #
img: volantis-static/media/twemoji/assets/svg/1f389.svg # https://cdn.jsdelivr.net/gh/twitter/[email protected]/assets/svg/1f389.svg
url: /contributors/
- name: 博客
icon: #
img: volantis-static/media/twemoji/assets/svg/1f4f0.svg # https://cdn.jsdelivr.net/gh/twitter/[email protected]/assets/svg/1f4f0.svg
url: /archives/
- name: 源码
icon: #
img: volantis-static/media/twemoji/assets/svg/1f9ec.svg # https://cdn.jsdelivr.net/gh/twitter/[email protected]/assets/svg/1f9ec.svg
url: https://github.com/volantis-x/hexo-theme-volantis/
############################### Cover ############################### > end
pages:
# 友链页面配置
friends:
layout_scheme: traditional # simple: 简单布局, traditional: 传统布局
############################### Article Layout ############################### > start
# 文章布局
article:
# 文章列表页面的文章卡片布局方案
preview:
scheme: landscape # landscape
# pin icon for post
pin_icon: volantis-static/media/twemoji/assets/svg/1f4cc.svg # https://cdn.jsdelivr.net/gh/twitter/[email protected]/assets/svg/1f4cc.svg
# auto generate title if not exist
auto_title: true # false, true
# auto generate excerpt if not exist
auto_excerpt: true # false, true
# hide excerpt
hide_excerpt: false
# show split line or not
line_style: solid # hidden, solid, dashed, dotted
# show author
author: false # true, false
# show readmore button
readmore: auto # auto, always
# 文章详情页面的文章卡片本体布局方案
body:
# 文章顶部信息
# 从 meta_library 中取
top_meta: [author, category, date, counter] #启用评论数量需在此添加
# 文章底部信息
# 从 meta_library 中取
bottom_meta: [updated, tags, share]
# ----------------
# 文章页脚组件
footer_widget:
# ----------------
# 参考资料、相关资料等 (for layout: post/docs)
references:
title: 参考资料
icon: fa-solid fa-quote-left
# 在 front-matter 中:
# references:
# - title: 某篇文章
# url: https://
# 即可显示此组件。
# ----------------
# 相关文章，需要安装插件 (for layout: post)
# npm i hexo-related-popular-posts
related_posts:
enable: false
title: 相关文章
icon: fa-solid fa-bookmark
max_count: 5
# 设为空则不使用文章头图
placeholder_img: https://gcore.jsdelivr.net/gh/MHG-LAB/cron@gh-pages/bing/bing.jpg
# ----------------
# 版权声明组件 (for layout: post)
copyright:
enable: false
permalink: '本文永久链接是：'
content:
- '博客内容遵循 署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0) 协议'
- permalink
# 自定义版权组件：精细到文章的版权声明
custom: false # 开启后替代上方内容的版权显示
customData:
default: type1 # 默认授权声明
#############################
# 你可以在文章的 front-matter 覆盖默认版权声明
# 配置示例（均可选）：
# copyright:
# type: type3 # 当前文章版权声明类型
# author: 张三 # 本文作者
# ref: # 原文出处
# title: # 原文出处 - 标题
# url: # 原文出处 - 链接
#############################
rules:
type1:
text: <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh#" target="_blank">CC BY-NC-SA 4.0</a>
desc: 署名-非商业性使用-相同方式共享 4.0 国际。
type2:
text: 禁止转载引用
desc: 除非获得原作者的单独授权，任何第三方不得转载！
type3:
text: 原作许可协议
desc: 本文转载自他站，转载或引用本文时，请遵守原作许可协议！
type4:
text: 来自互联网
desc: 本文来自互联网，未知来源，侵权请联系删除。
type5:
text: 允许规范转载
desc: 转载请保留本文转载地址，著作权归作者所有！
type6:
text: 允许付费转载
desc: 您可以联系作者通过付费方式获得授权。
# 还能自行添加更多
# ----------------
# 打赏组件 (for layout: post)
donate:
enable: false
images:
- volantis-static/media/org.volantis/blog/qrcode/[email protected] # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/blog/qrcode/[email protected]
- volantis-static/media/org.volantis/blog/qrcode/[email protected] # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/blog/qrcode/[email protected]
# meta library
meta_library:
# 默认文章作者（可在 _data/author.yaml 中增加其他作者，并在 front-matter 中设置）
# https://volantis.js.org/advanced-settings/#多人协同
author:
avatar: volantis-static/media/org.volantis/blog/favicon/apple-touch-icon.png # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/blog/favicon/apple-touch-icon.png
name: 请设置文章作者
url: /
# 文章创建日期
date:
icon: fa-solid fa-calendar-alt
title: '发布于：'
format: 'll' # 日期格式 http://momentjs.com/docs/
# 文章更新日期
updated:
icon: fa-solid fa-edit
title: '更新于：'
format: 'll' # 日期格式 http://momentjs.com/docs/
# 文章分类
category:
icon: fa-solid fa-folder-open
# 文章浏览计数
counter:
icon: fa-solid fa-eye
unit: '次浏览'
# waline 文章评论数量
walinecount:
icon: fa-solid fa-comment-dots
desc: '条评论' # 条评论
# artalk 文章评论数量
artalkcount:
icon: fa-solid fa-comment-dots
desc: '条评论' # 条评论
# 文章字数和阅读时长
wordcount:
icon_wordcount: fa-solid fa-keyboard
icon_duration: fa-solid fa-hourglass-half
# 文章标签
tags:
icon: fa-solid fa-hashtag
# 分享
share:
- id: qq
img: volantis-static/media/org.volantis/logo/128/qq.png # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/logo/128/qq.png
- id: qzone
img: volantis-static/media/org.volantis/logo/128/qzone.png # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/logo/128/qzone.png
- id: weibo
img: volantis-static/media/org.volantis/logo/128/weibo.png # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/logo/128/weibo.png
- id: # qrcode # 当id为qrcode时需要安装插件 npm i hexo-helper-qrcode
img: # volantis-static/media/org.volantis/logo/128/wechat.png # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/logo/128/wechat.png
- id: # telegram
img: # volantis-static/media/org.volantis/logo/128/telegram.png # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/logo/128/telegram.png
############################### Article Layout ############################### > end
############################### Comments ############################### > start
comments:
title: <i class='fa-solid fa-comments'></i> 评论
subtitle:
service: giscus
# 可选评论系统 #
# artalk
# https://artalk.js.org/
# https://github.com/ArtalkJS/Artalk
artalk:
js: https://yours-artalk-domain/dist/Artalk.js # or https://unpkg.com/[email protected]/dist/Artalk.js
css: https://yours-artalk-domain/dist/Artalk.css # or https://unpkg.com/[email protected]/dist/Artalk.css
server: https://yours-artalk-domain # 修改为自建的后端服务地址
path: # 全局评论地址
placeholder: # 评论占位
# artalk 有三类图片：1.上传至服务端 2.上传至服务端后利用upgit上传至图床 3.前端上传至图床（本配置为此类）
# 配置此项时将覆盖服务端上传能力
imageUploader:
# 以兰空图床为例，下列填写内容为：
# url: 'https://xxxxxx/api/v1/upload'
# token: 'Bearer xxxxxxxxxxxxxx'
# resp: 'data.links.url'
api: # 图床地址
token: # 图床验证
resp: # 图片地址返回值的字段
# 更多置项可在 Artalk 后端进行配置，详见 https://artalk.js.org/guide/backend/fe-control.html
# 也可以在此处继续参考上方例子进行配置，不建议重写配置的字段除上方所述外还有：
# [el, useBackendConf, pageKey, pageTitle, site, darkMode, pvEl, imgUploader]
# giscus
# https://giscus.app
# https://github.com/laymonage/giscus
giscus:
# 以下配置按照 yml 格式增删填写即可
# repo: xxx/xxx
# repo-id: xxx
# category: xxx
# category-id: xxx
# mapping: "pathname"
# reactions-enabled: "1"
# emit-metadata: "0"
# lang: "zh-CN"
# 以上配置按照 yml 格式增删填写即可
theme:
light: "light" # https://cdn.jsdelivr.net/gh/volantis-x/cdn-volantis@master/css/giscus/light.css
dark: "dark" # https://cdn.jsdelivr.net/gh/volantis-x/cdn-volantis@master/css/giscus/dark.css
# beaudar
# https://beaudar.lipk.org/
beaudar:
repo: xxx/xxx
issue-term: pathname
issue-number:
branch: main
position: top
order: desc
theme:
light: github-light
dark: github-dark
label: ✨💬✨
# utterances
# https://utteranc.es/
utterances:
repo: xxx/xxx
issue-term: pathname
issue-number:
theme:
light: github-light
dark: github-dark
label: ✨💬✨
# Disqus
# https://disqus.com
disqus:
shortname:
# optional
autoload: false
path: # 全局评论地址
# DisqusJS
# https://github.com/SukkaW/DisqusJS
disqusjs:
path: # 全局评论地址
js: https://unpkg.com/[email protected]/dist/disqus.js
css: https://unpkg.com/[email protected]/dist/disqusjs.css
# 配置项按照yml格式继续填写即可 除了 [siteName url identifier] 选项
#shortname:
#api:
#apikey:
#admin:
#nesting:
# Gitalk
# https://gitalk.github.io/
gitalk:
js: https://unpkg.com/gitalk@1/dist/gitalk.min.js
# 配置项按照yml格式继续填写即可 除了 [id distractionFreeMode] 选项
clientID:
clientSecret:
repo:
owner:
admin: # []
path: # 全局评论地址
# Vssue 暂不支持Pjax
# https://vssue.js.org/zh/
vssue:
js: https://cdn.jsdelivr.net/gh/meteorlxy/[email protected]/packages/vssue/dist/vssue.github.min.js
css: https://cdn.jsdelivr.net/gh/meteorlxy/[email protected]/packages/vssue/dist/vssue.min.css
vue: https://cdn.jsdelivr.net/gh/vuejs/[email protected]/dist/vue.runtime.min.js
owner:
repo:
clientId:
clientSecret:
# LiveRe 暂不支持Pjax
# https://www.livere.com
livere:
uid:
# Isso
# https://posativ.org/isso/
isso:
url: https://example.com/(path/)
src: https://example.com/(path/)js/embed.min.js
css:
gravatar:
# HashOver 暂不支持Pjax
# https://www.barkdull.org/software/hashover
hashover:
src: https://example.com/(path/)comments.php
# Twikoo
# https://twikoo.js.org/
twikoo:
js: https://unpkg.com/twikoo@latest # 建议锁定版本
path: # 全局评论地址
# 其他配置项按照yml格式继续填写即可 除了 [el path] 选项
envId: xxxxxxxxxxxxxxx # 腾讯云环境id
placeholder: #全局评论占位，也可以在管理面板中的配置管理处设置（此处优先级更高）
# Waline
# https://waline.js.org/
waline:
js: https://unpkg.com/@waline/client@v2/dist/waline.js
css: https://unpkg.com/@waline/client@v2/dist/waline.css
path: # 全局评论地址 目前设置全局评论地址后visitor失效,这是waline的问题
placeholder: # 评论占位提示
serverURL: # Waline 的服务端地址（必填） 测试用地址: https://waline.vercel.app
imageUploader:
# 以兰空图床为例，下列填写内容为：
# url: https://xxxxxx/api/v1/upload
# token: Bearer xxxxxxxxxxxxxx
# resp: data.links.url
api: # 图床地址
token: # 图床验证
resp: # 图片地址返回值的字段
pageview: true # 浏览量统计
comment: true # 评论数统计
# 其他配置项按照yml格式继续填写即可 除了 [el path imageUploader] 选项
# 组件属性地址：https://waline.js.org/reference/component.html
# meta: ['nick', 'mail', 'link']
# Discuss
# https://discuss.js.org
discuss:
js: https://cdn.jsdelivr.net/npm/discuss/dist/discuss.js # 建议锁定版本
serverURLs: # Discuss server address url
# https://discuss.js.org/Quick-Start.html#path
############################### Comments ############################### > end
############################### Sidebar ############################### > start
sidebar:
position: right # left right
# 主页、分类、归档等独立页面
for_page: [blogger, category, tagcloud, donate]
# layout: docs/post 这类文章页面
for_post: [toc]
# 侧边栏组件库
widget_library:
# ---------------------------------------
# blogger info widget
blogger:
class: blogger
display: [desktop, mobile] # [desktop, mobile]
avatar: volantis-static/media/org.volantis/blog/[email protected] # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/blog/[email protected]
shape: rectangle # circle, rectangle
url: /about/
title:
subtitle:
jinrishici: true # Poetry Today. You can set a string, and it will be displayed when loading fails.
social:
- icon: fa-solid fa-rss
url: /atom.xml
- icon: fa-solid fa-envelope
url: mailto:[email protected]
- icon: fab fa-github
url: https://github.com/volantis-x/
- icon: fa-solid fa-headphones-alt
url: /
# ---------------------------------------
# toc widget (valid only in articles)
toc:
class: toc
display: [desktop, mobile] # [desktop, mobile]
sticky: true
header:
icon: fa-solid fa-list
title: 本文目录
list_number: false
min_depth: 2
max_depth: 5
# ---------------------------------------
# music
music:
class: music
display: [desktop, mobile] # [desktop, mobile]
pjaxReload: false
# ---------------------------------------
# category widget
category:
class: category
display: [desktop] # [desktop, mobile]
header:
icon: fa-solid fa-folder-open
title: 文章分类
url: /blog/categories/
# ---------------------------------------
# tagcloud widget
tagcloud:
class: tagcloud
display: [desktop, mobile] # [desktop, mobile]
header:
icon: fa-solid fa-tags
title: 热门标签
url: /blog/tags/
min_font: 14
max_font: 24
color: true
start_color: '#999'
end_color: '#555'
# ---------------------------------------
# qrcode widget
qrcode:
class: qrcode
display: [desktop, mobile] # [desktop, mobile]
height: 64px # Automatic height if not set
images:
- volantis-static/media/org.volantis/blog/qrcode/[email protected] # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/blog/qrcode/[email protected]
- volantis-static/media/org.volantis/blog/qrcode/[email protected] # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/blog/qrcode/[email protected]
# ---------------------------------------
# webinfo widget
webinfo:
class: webinfo
display: [desktop]
header:
icon: fa-solid fa-award
title: 站点信息
type:
article:
enable: true
text: '文章数目：'
unit: '篇'
runtime:
enable: false
data: '2020/01/01' # 填写建站日期
text: '已运行时间：'
unit: '天'
wordcount:
enable: false
text: '本站总字数：' # 需要启用 wordcount
unit: '字'
visitcounter:
siteuv:
enable: false
text: '本站访客数：'
unit: '人'
sitepv:
enable: false
text: '本站总访问量：'
unit: '次'
lastupd:
enable: true
friendlyShow: true # 更友好的时间显示
text: '最后活动时间：'
unit: '日'
# ---------------------------------------
# lastupdate widget
lastupdate:
class: lastupdate
display: [desktop, mobile]
header:
icon: fa-solid fa-clock WISTERIA
title: 最近更新
############################### Sidebar ############################### > end
############################### Tag Plugins ############################### > start
# 内置标签插件的配置
tag_plugins:
# {% note text %}
note: # style for default note:
icon: '\f054'
color: ''
iconfont: 'Font Awesome 6 Free'
# {% checkbox %}
checkbox:
interactive: false # enable interactive for user
color: '' # color for default checkbox
# {% link title, url, img %}
link:
placeholder: volantis-static/media/org.volantis/logo/256/safari.png # https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/logo/256/safari.png
############################### Tag Plugins ############################### > end
############################### Site Footer ############################### > start
site_footer:
# layout of footer: [aplayer, social, license, info, copyright]
layout: [aplayer, social, license, analytics, info, copyright]
social:
- icon: #fa-solid fa-rss
url:
# or
- img:
url:
# or
- avatar:
url:
# site source
source: https://github.com/volantis-x/volantis-docs/
# analytics using leancloud
analytics: >
<span id="lc-sv">本站总访问量为 <span id='number'><i class="fa-solid fa-loader fa-spin fa-fw" aria-hidden="true"></i></span> 次</span>
<span id="lc-uv">访客数为 <span id='number'><i class="fa-solid fa-loader fa-spin fa-fw" aria-hidden="true"></i></span> 人</span>
# site copyright
copyright: '[Copyright © since 2017 XXX](/)'
# You can add your own property here. (Support markdown, for example: br: '<br>')
br: '<br>'
############################### Site Footer ############################### > end
############################### Plugins ############################### > start
plugins:
################ required plugins ################
# jquery
globalJquery: false # 全局引入 jquery
jquery: volantis-static/libs/jquery/dist/jquery.min.js # https://unpkg.com/[email protected]/dist/jquery.min.js
# fontawesome Pro 版本：https://cdn.jsdelivr.net/gh/inkss/[email protected]/css/all.min.css
fontawesome: volantis-static/libs/@fortawesome/fontawesome-free/css/all.min.css # https://unpkg.com/@fortawesome/[email protected]/css/all.min.css
katex:
js: volantis-static/libs/katex/katex.min.js # https://unpkg.com/[email protected]/dist/katex.min.js
css: volantis-static/libs/katex/katex.min.css # https://unpkg.com/[email protected]/dist/katex.min.css
render: volantis-static/libs/katex/contrib/auto-render.min.js # https://unpkg.com/[email protected]/dist/contrib/auto-render.min.js
mathjax: volantis-static/libs/mathjax/es5/tex-mml-chtml.js # https://unpkg.com/[email protected]/es5/tex-mml-chtml.js
markdown: volantis-static/libs/github-markdown-css/github-markdown.css # https://unpkg.com/[email protected]/github-markdown.min.css
marked: volantis-static/libs/marked/marked.min.js # https://unpkg.com/[email protected]/marked.min.js
hlsjs: volantis-static/libs/hls.js/dist/hls.min.js # https://unpkg.com/[email protected]
# @fancyapps/[email protected]
fancybox:
css: volantis-static/libs/@fancyapps/ui/dist/fancybox.css # https://unpkg.com/@fancyapps/[email protected]/dist/fancybox.css
js: volantis-static/libs/@fancyapps/ui/dist/fancybox.umd.js # https://unpkg.com/@fancyapps/[email protected]/dist/fancybox.umd.js
################ optional plugins ################
# issues api
sitesjs:
enable: true
friendsjs:
enable: true
contributorsjs:
enable: true
######## Plugins to improve loading speed:
# 预加载
preload:
enable: true
service: flying_pages # instant_page, flying_pages
instant_page: volantis-static/libs/instant_page/instant_page.js # https://cdn.jsdelivr.net/gh/volantis-x/cdn-volantis@2/js/instant_page.js
flying_pages: volantis-static/libs/flying-pages/flying-pages.min.js # https://cdn.jsdelivr.net/gh/gijo-varghese/[email protected]/flying-pages.min.js
# 图片懒加载
# https://www.npmjs.com/package/vanilla-lazyload
# tips:
# 这里是主题自带的图片懒加载, 实现方案位于 /scripts/filters/z-lazyload ; srcset 属性的的优先级比 src 属性要高, 注意 srcset 存放了懒加载占位图, src 存放了原图
# 在支持 srcset 的浏览器或者 RSS 阅读器(还会有人使用老旧的阅读器?)上会优先读取 srcset 加载的图片(懒加载占位图), 对于 RSS 中图片丢失变成懒加载占位图的问题, 建议 自行使用脚本移除 srcset 属性 或 关闭图片懒加载 或 在 RSS 中插入 vanilla-lazyload
lazyload:
enable: true
js: volantis-static/libs/vanilla-lazyload/dist/lazyload.min.js # https://unpkg.com/[email protected]/dist/lazyload.min.js
onlypost: false
loadingImg: # https://cdn.jsdelivr.net/gh/volantis-x/cdn-volantis@3/img/placeholder/c617bfd2497fcea598e621413e315c368f8d8e.svg # 不建议使用占位图, 建议loadingImg为空, 当前占位图会产生布局偏移, loadingImg 为空占位图是一个 1X1 像素的图片
blurIn: true # 模糊加载效果 （loadingImg为空时有效）
######## Plugins to optimize the experience:
# 代码高亮
code_highlight: highlightjs # highlightjs or prismjs
# highlight.js
highlightjs:
copy_code: true
# 如果开启以下配置, hexo.config.highlight.enable 需要设置为 false ; hexo.config.highlight.enable 设置为 true, 则以下配置无效
# # 不再支持 v11.1.0 以下版本
# js: https://unpkg.com/@highlightjs/[email protected]/highlight.min.js # Please set hexo.config.highlight.enable = false !!!
# css: https://unpkg.com/@highlightjs/[email protected]/styles/default.min.css
# # # more: https://www.jsdelivr.com/package/npm/@highlightjs/cdn-assets?path=styles
# prismjs
# https://prismjs.com/
# https://hexo.io/zh-cn/docs/syntax-highlight#PrismJS
prismjs:
copy_code: true
# Please set hexo.config.highlight.enable = false !!! set hexo.config.prismjs.enable = true !!!
js:
- https://unpkg.com/prismjs/components/prism-core.min.js
- https://unpkg.com/prismjs/plugins/autoloader/prism-autoloader.min.js
- https://unpkg.com/prismjs/plugins/line-numbers/prism-line-numbers.min.js
css:
- https://unpkg.com/prismjs/themes/prism-dark.css
- https://unpkg.com/prismjs/plugins/line-numbers/prism-line-numbers.css
# https://scrollrevealjs.org/api/reveal.html
scrollreveal:
enable: true
js: volantis-static/libs/scrollreveal/dist/scrollreveal.min.js # https://unpkg.com/[email protected]/dist/scrollreveal.min.js
distance: 32px
duration: 800 # ms
interval: 20 # ms
scale: 1 # 0.1~1
######## Plugins for SEO:
# npm i hexo-wordcount
wordcount:
enable: #true
######## Plugins for ...
# Button Ripple Effect
nodewaves:
enable: #true
css: volantis-static/libs/node-waves/dist/waves.min.css # https://unpkg.com/[email protected]/dist/waves.min.css
js: volantis-static/libs/node-waves/dist/waves.min.js # https://unpkg.com/[email protected]/dist/waves.min.js
# fontawesome V6: https://fontawesome.com/docs/web/style/animate
# fontawesome animation for fontawesome V5
fontawesome_animation:
enable: #true
css: volantis-static/libs/font-awesome-animation/font-awesome-animation.min.css # https://cdn.jsdelivr.net/gh/l-lin/font-awesome-animation/dist/font-awesome-animation.min.css
# Typing Effects
comment_typing:
enable: #true
js: volantis-static/libs/comment_typing/comment_typing.js # https://cdn.jsdelivr.net/gh/volantis-x/cdn-volantis@2/js/comment_typing.js
# 视差滚动效果 Slide Background
parallax:
enable: #true
position: cover # cover: sticky on the cover. fixed: Fixed as background for the site.
shuffle: true # shuffle playlist
duration: 10000 # Duration (ms)
fade: 1500 # fade duration (ms) (Not more than 1500)
images: # For personal use only. At your own risk if used for commercial purposes !!!
- volantis-static/media/wallpaper/minimalist/2020/001.webp
- volantis-static/media/wallpaper/minimalist/2020/002.webp
- volantis-static/media/wallpaper/minimalist/2020/003.webp
- volantis-static/media/wallpaper/minimalist/2020/004.webp
- volantis-static/media/wallpaper/minimalist/2020/005.webp
- volantis-static/media/wallpaper/minimalist/2020/006.webp
- volantis-static/media/wallpaper/minimalist/2020/012.webp
- volantis-static/media/wallpaper/minimalist/2020/016.webp
- volantis-static/media/wallpaper/minimalist/2020/019.webp
- volantis-static/media/wallpaper/minimalist/2020/025.webp
- volantis-static/media/wallpaper/minimalist/2020/033.webp
- volantis-static/media/wallpaper/minimalist/2020/034.webp
- volantis-static/media/wallpaper/minimalist/2020/035.webp
- volantis-static/media/wallpaper/minimalist/2020/038.webp
- volantis-static/media/wallpaper/minimalist/2020/039.webp
- volantis-static/media/wallpaper/minimalist/2020/042.webp
- volantis-static/media/wallpaper/minimalist/2020/046.webp
- volantis-static/media/wallpaper/minimalist/2020/051.webp
- volantis-static/media/wallpaper/minimalist/2020/052.webp
- volantis-static/media/wallpaper/minimalist/2020/054.webp
- volantis-static/media/wallpaper/minimalist/2020/056.webp
# APlayer is only available in mainland China.
# APlayer config: https://github.com/metowolf/MetingJS
aplayer:
enable: #true
js:
aplayer: volantis-static/libs/aplayer/dist/APlayer.min.js # https://unpkg.com/[email protected]/dist/APlayer.min.js
meting: volantis-static/libs/meting/dist/Meting.min.js # https://unpkg.com/[email protected]/dist/Meting.min.js
css: volantis-static/libs/aplayer/dist/APlayer.min.css # https://unpkg.com/[email protected]/dist/APlayer.min.css
# Required
server: netease # netease, tencent, kugou, xiami, baidu
type: playlist # song, playlist, album, search, artist
id: 3175833810 # song id / playlist id / album id / search keyword
# Optional
fixed: false # enable fixed mode
theme: '#1BCDFC' # main color
autoplay: false # audio autoplay
order: list # player play order, values: 'list', 'random'
loop: all # player loop play, values: 'all', 'one', 'none'
volume: 0.7 # default volume, notice that player will remember user setting, default volume will not work after user set volume themselves
list_max_height: 320px # list max height
list_folded: true
autoHide: true # hide automaticaly
# Pjax
pjax:
js: volantis-static/libs/pjax/pjax.min.js # https://unpkg.com/[email protected]/pjax.min.js
enable: true
cover: true # 封面是否pjax处理 false：每次切换页面封面都重载，适合封面较少的情况 true：封面经过Pjax处理，适合封面较多的情况
timeout: 5000 # The timeout in milliseconds for the XHR requests. Set to 0 to disable the timeout.
cacheBust: false # When set to true, Pjax appends a timestamp to skip the browser cache.
animation: false # false, nprogress, circle
nprogress: volantis-static/libs/nprogress/nprogress.js # https://unpkg.com/[email protected]/nprogress.min.js
banUrl: # 被屏蔽的 url 地址将不启用 pjax 跳转，可以在控制台下使用 window.location.pathname 获取
# - '/artitalk/' # artitalk 不支持 pjax
# - '/bbtalk/' # bbtalk 不支持 pjax
# 暗黑模式 darkmode
# 开关按钮：在 navbar.menu 中添加：
# - name: 暗黑模式 # 可自定义
# icon: fa-solid fa-moon # 可自定义
# toggle: darkmode
darkmode:
enable: #true
# 旧版 Internet Explorer 淘汰行动
# https://www.microsoft.com/zh-cn/WindowsForBusiness/End-of-IE-support
# 本主题不支持Internet Explorer的任何版本!!!
killOldVersionsOfIE:
enable: true
# 禁用JavaScript提示
# 本页面需要浏览器支持（启用）JavaScript
# 主题中的某些插件必须启用JavaScript才能正常工作，例如开启scrollreveal如果禁用JavaScript会导致卡片消失
killNoScript:
enable: true
# Artitalk https://artitalk.js.org
# 配置过程请参考：https://artitalk.js.org/doc.html
# 使用过旧版本的请修改Leancloud shuoshuo class部分列名：https://artitalk.js.org/release.html
# 除appID和appKEY外均为选填项
artitalk:
# Set `plugins: ["artitalk"]` to enable in front-matter
# 不支持 Pjax
# 配置项按照yml格式继续填写即可
js: https://unpkg.com/artitalk
appId: ogP8qj3veMh0LFpFWMPOyF0X-MdYXbMMI # your appID
appKey: nHXLd3N3Jgh460t2iRQKWAtr # your appKEY
# serverURL: #leancloud绑定的api访问域名，使用国际版的话不需要填写
# lang: # 语言设置，zh为汉语，en为英语，es为西班牙语。默认为汉语
# pageSize: #每页说说的显示数量
# shuoPla: #在编辑说说的输入框中的占位符
# avatarPla: #自定义头像url的输入框的占位符
# motion: #加载动画的开关，1为开，0为关，默认为开
# bgImg: #说说输入框背景图片url
# color1: #说说背景颜色1&按钮颜色1
# color2: #说说背景颜色2&按钮颜色2
# color3: #说说字体颜色
# cssUrl: #自定义css接口
# BBtalk https://bb.js.org
bbtalk:
# Set `plugins: ["bbtalk"]` to enable in front-matter
# 不支持 Pjax
js: https://unpkg.com/[email protected]/dist/bbtalk.js # BBtalk.js
appId: 0KzOX4vC7Jsk6vzUGNeEiUaI-gzGzoHsz # your appID
appKey: HwCiWuxfpvKiLm4teCUgTIba # your appKEY
serverURLs: https://bbapi.heson10.com # Request Api 域名
# 友链朋友圈 hexo-circle-of-friends
# https://github.com/Rock-Candy-Tea/hexo-circle-of-friends
# https://fcircle-doc.js.cool/
fcircle:
# Set `plugins: ["fcircle"]` to enable in front-matter
# 支持 Pjax
api: https://fcircle-api.example.com/ # api 地址
message: 与主机通讯中…… # 占位文字
css: volantis-static/libs/fcircle/fcircle.css
js: volantis-static/libs/fcircle/fcircle.js
# 消息提示
message:
enable: true
css: volantis-static/libs/izitoast/dist/css/iziToast.min.css
js: volantis-static/libs/izitoast/dist/js/iziToast.min.js
icon: # 默认图标，支持对图标添加颜色，可选值：see：/source/css/_style/_plugins/fontcolor.styl
default: fa-solid fa-info-circle light-blue
quection: fa-solid fa-question-circle light-blue
time: # 默认持续时间
default: 5000
quection: 20000
position: 'topRight' # 弹出位置 可选值：topRight, bottomRight, bottomLeft, topLeft, topCenter, bottomCenter, center
transitionIn: 'bounceInLeft' # 弹窗打开动画 可选值：bounceInLeft, bounceInRight, bounceInUp, bounceInDown, fadeIn, fadeInDown, fadeInUp, fadeInLeft, fadeInRight, flipInX
transitionOut: 'fadeOutRight' # 弹窗关闭动画 可选值：fadeOut, fadeOutUp, fadeOutDown, fadeOutLeft, fadeOutRight, flipOutX
titleColor: 'var(--color-text)' # 标题颜色
messageColor: 'var(--color-text)' # 消息颜色
backgroundColor: 'var(--color-card)' # 默认背景色
zindex: 2147483647 # 层级
copyright: # 是否在复制时弹出版权提示，影响范围：ctrl+c、代码块复制按钮、右键复制选项
enable: true
title: '知识共享许可协议'
message: '请遵守 CC BY-NC-SA 4.0 协议。'
icon: 'far fa-copyright light-blue'
aplayer: # 是否开启音乐通知；播放、暂停、失败 时的图标
enable: true
play: fa-solid fa-play
pause: fa-solid fa-pause
rightmenu:
enable: true # 是否开启右键模块的消息通知
notice: true # 唤醒原右键菜单的通知
# 聊天功能
chat_service: # tidio or gitter
# Tidio
# https://www.tidio.com/
tidio:
id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Gitter
# https://gitter.im
gitter:
room: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# swiper
# https://www.swiper.com.cn/
swiper:
enable: true
css: volantis-static/libs/swiper/swiper-bundle.min.css # https://unpkg.com/swiper@6/swiper-bundle.min.css
js: volantis-static/libs/swiper/swiper-bundle.min.js # https://unpkg.com/swiper@6/swiper-bundle.min.js
############################### Plugins ############################### > end
############################### Rightmenu ############################### > start
### 自定义右键 新
rightmenus:
enable: false
# 右键菜单项及加载顺序
# 内容示例：plugins.[组名], menus.[组名], hr(分割线，推荐去线留白), music(音乐控制器)
order:
- plugins.navigation
- hr
- plugins.inputBox
- plugins.seletctText
- plugins.elementCheck
- plugins.elementImage
- menus.link
- hr
- menus.darkMode
- plugins.articlePage
- music
############################
# - {id: '', name: '', icon: '', link: '', event: '', group: ''}
# id: 唯一值
# name: 用于菜单名称显示
# icon: 用于菜单图标显示
# link: 跳转链接
# event: 事件，当输入内容不为内置事件时，作 JavaScript 代码执行
# group: 菜单项所处分组名称
# 注：
# 1. link/event 二选一，同时出现时仅处理 link
# 2. 内置事件列表： copyText, copyLink, copyPaste, copyAll, copyCut, copyImg, printMode, readMode
# 3. 内置组列表：navigation, inputBox, seletctText, elementCheck, elementImage, articlePage
# 4. plugins 列允许自定义组内项目
# 5. menus 列允许自定义组及其内容
# 6. 除 navigation 外的内置组，在显示时会隐藏含 link 属性的菜单项
###########################
# 基础项设置
options:
# 图标前缀 fa-solid, fa-regular, fa-light, fa-thin, fa-duotone, fa-brands
iconPrefix: fa-solid
# 例外，在 articlePage 组显示时（文章页）时依旧显示含 link 属性的菜单项
articleShowLink: true
# 当设定全局音乐播放器时，是否一直显示音乐控制菜单。false：仅当音乐播放时启用
musicAlwaysShow: true
# 右键内置组，预置实现
plugins:
# 导航组件
# 横向排列，共用一行，仅显示图标 (原则上支持的数量不限)
navigation:
- {id: 'left', name: '转到上一页', icon: 'fa-solid fa-arrow-left', event: 'history.back()', group: 'navigation'}
- {id: 'right', name: '转到下一页', icon: 'fa-solid fa-arrow-right', event: 'history.forward()', group: 'navigation'}
- {id: 'redo', name: '刷新当前页面', icon: 'fa-solid fa-redo', event: 'window.location.reload()', group: 'navigation'}
- {id: 'up', name: '回到顶部', icon: 'fa-solid fa-arrow-up', event: 'VolantisApp.scrolltoElement(volantis.dom.bodyAnchor)', group: 'navigation'}