Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

hexo-butterfly-categories-card

Akilarlxh1.3kApache-2.01.0.0

A categories card plugin for theme-butterfly

hexo, filter, cotegotise card, butterfly, theme-butterfly, plugins

readme

hexo-butterfly-categories-card

hexo-theme-butterfly添加 首页分类卡片

安装

  1. 安装插件,在博客根目录[Blogroot]下打开终端,运行以下指令:

    npm install hexo-butterfly-categories-card --save
  2. 添加配置信息,以下为写法示例 在站点配置文件_config.yml或者主题配置文件_config.butterfly.yml中添加

    # hexo-butterfly-categories-card
    # see https://akilar.top/posts/a9131002/
    categoryBar:
     enable: true # 开关
     priority: 5 #过滤器优先权
     enable_page: / # 应用页面
     layout: # 挂载容器类型
       type: id
       name: recent-posts
       index: 0
     column: odd # odd:3列 | even:4列
     row: 1 #显示行数,默认两行,超过行数切换为滚动显示
     message:
       - descr: Ubuntu指南
         cover: https://npm.elemecdn.com/akilar-candyassets/image/cover1.webp
       - descr: 玩转Win10
         cover: https://npm.elemecdn.com/akilar-candyassets/image/cover2.webp
       - descr: 长篇小说连载
         cover: https://npm.elemecdn.com/akilar-candyassets/image/cover3.webp
       - descr: 个人日记
         cover: https://npm.elemecdn.com/akilar-candyassets/image/cover4.webp
       - descr: 诗词歌赋
         cover: https://npm.elemecdn.com/akilar-candyassets/image/cover5.webp
       - descr: 杂谈教程
         cover: https://npm.elemecdn.com/akilar-candyassets/image/cover6.webp
     custom_css: https://npm.elemecdn.com/hexo-butterfly-categories-card/lib/categorybar.css
  3. 参数释义

    |参数|备选值/类型|释义| |:--|:--|:--| |priority|number|【可选】过滤器优先级,数值越小,执行越早,默认为10,选填| |enable|true/false|【必选】控制开关| |enable_page|path/all|【可选】填写想要应用的页面的相对路径(即路由地址),如根目录就填'/',分类页面就填'/categories/'。若要应用于所有页面,就填'all',默认为'/'| |layout.type|id/class|【可选】挂载容器类型,填写id或class,不填则默认为id| |layout.name|text|【必选】挂载容器名称| |layout.index|0和正整数|【可选】前提是layout.type为class,因为同一页面可能有多个class,此项用来确认究竟排在第几个顺位| |column|odd/even|【可选】显示列数,考虑到比例问题,只提供3列和4列,odd为3列, even为4列| |row|number|【可选】显示行数,默认两行,超过行数切换为滚动显示| |message.descr|text|分类描述,需要和你自己的文章分类一一对应。| |message.cover|url|分类背景,需要和你自己的文章分类一一对应。| |custom_css|url|【可选】自定义样式,会替换默认的css链接,可以下载文档给出的cdn链接后自主修改|

截图

更新记录

  • 2022-03-04:1.0.0
    1. 弃用3.0方案,冰老师的原始布局与figure标签样式严重耦合。
    2. 沿用4.0方案,将自适应样式与配置关联。
    3. 列数样式整合进html.pug,用户无法再通过配置项以外的方式调整行数。
    4. 调用pjax.loadURL()方法实现不间断跳转,兼容aplayer全局音乐。
    5. 卡片链接、名称通过index.js直接生成,需要用户自行根据生成后的卡片添加描述和封面。
  • 2022-03-03:0.0.11
    1. 初步修复样式bug,等待调整自适应样式
  • 2021-08-25:0.0.10
    1. 沿用源码修改方案3.0版本,初步实现界面挂载