前言:

效果如下:
image.png

NPM 插件安装的部署方法:

1
2
3
4
5
npm i hexo-swiper-bar --save

# 或者

cnpm i hexo-swiper-bar --save

注意,一定要加--save,不然本地预览的时候可能不会显示!!!

新增网站根目录_config 配置项(不是主题的):

1
2
3
4
5
6
7
8
9
10
swiper:
enable: true
priority: 2
enable_page: /
layout:
type: id
name: recent-posts
index: 0
temple_html: '<div class="recent-post-item" style="height: auto;width: 100%"><div class="blog-slider swiper-container-fade swiper-container-horizontal" id="swiper_container">${temple_html_item}</div></div>'
plus_style: ""

enable

参数:true/false
含义:是否开启插件

enable_page

参数:/
含义:路由地址,如 / 代表主页。/me/代表自我介绍页等等

priority

参数:1
含义:插件的叠放顺序,数字越大,叠放约靠前。

1
2
3
swiper:
enable: true
priority: 2 # 这里是参数

layout

参数:type; (class&id)
参数:name;
参数:index;(数字)
含义:如果说 swiper 是一幅画,那么这个 layout 就是指定了哪面墙来挂画
而在 HTML 的是世界里有两种墙分别 type 为 id 和 class。
其中在定义 class 的时候会出现多个 class 的情况,这时就需要使用 index,确定是哪一个。
最后墙的名字即是 name;

1
2
3
4
5
6
7
8
<div name="我是墙" id="recent-posts">
<!-- id=>type recent-posts=>name -->
<div name="我是画框">
<div name="我是纸">
<!--这里通过js挂载swiper,也就是画画-->
</div>
</div>
</div>

temple_html

参数:html 模板字段
含义:包含挂载容器

1
2
3
4
<div class="recent-post-item" style="height: auto;width: 100%"><!--文章容器 -->
<div class="blog-slider swiper-container-fade swiper-container-horizontal" id="swiper_container"><!-- swiper容器 -->
${temple_html_item}</div>
</div>

plus_style

参数:“”
含义:提供可自定义的 style,如加入黑夜模式。

挂载方法

在 Front-matter 添加以下参数即可,index 数字越大越靠前展示。

1
2
3
swiper_index: 8
swiper_desc: 简单好用的 hexo 博客文章置顶插件!
swiper_cover: /images/letter/p.png

hexo 三连

执行 hexo 三连

1
hexo clean && hexo g && hexo s

即可发现已经成功部署。

最后

还是按照惯例,有什么不懂的欢迎加群询问。
image.png