展示效果

image-20250518231157142

所以我们需要在首页的最顶端插入所需要的轮播图

安装插件

1
npm install hexo-butterfly-swiper --save

配置插件

在_config.butterfly.yml下增加以下配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# hexo-butterfly-swiper
# see https://akilar.top/posts/8e1264d1/
swiper:
  enable: true # 开关
  priority: 5 #过滤器优先权
  enable_page: / # 应用页面
  timemode: date #date/updated
  layout: # 挂载容器类型
    type: id
    name: recent-posts
    index: 0
  default_descr: 再怎么看我也不知道怎么描述它的啦！
  swiper_css: https://npm.elemecdn.com/hexo-butterfly-swiper/lib/swiper.min.css #swiper css依赖
  swiper_js: https://npm.elemecdn.com/hexo-butterfly-swiper/lib/swiper.min.js #swiper js依赖
  custom_css: https://npm.elemecdn.com/hexo-butterfly-swiper/lib/swiperstyle.css # 适配主题样式补丁
  custom_js: https://npm.elemecdn.com/hexo-butterfly-swiper/lib/swiper_init.js # swiper初始化方法

插件参数

参数 备选值/类型 释义 是否必选
priority number 过滤器优先级，数值越小执行越早（默认：10） 可选
enable true/false 控制开关 必选
enable_page path/all 应用页面的相对路径（如 / 或 /categories/），默认：all 可选
timemode date/updated 时间显示模式，默认：date 可选
layout.type id/class 挂载容器类型（默认：id） 可选
layout.name text 挂载容器名称 必选
layout.index 0和正整数 当 layout.type=class 时，指定 class 的索引位置 可选
default_descr text 默认文章描述 可选
swiper_css url 自定义 Swiper 的 CSS 依赖链接 可选
swiper_js url 自定义 Swiper 的 JS 依赖链接 可选
custom_css url 适配主题的 CSS 补丁文件 可选
custom_js url Swiper 初始化的自定义 JS 文件 可选

展示文章

在文章的front_matter处添加swiper_index的配置即可

  • swiper_index #置顶轮播图顺序，非负整数，数字越大越靠前

  • description #文章描述，这里是轮播图展示的描述