前言

23-01-01更新：解决简介文字过多显示不全的bug。

22-10-25更新：修改了一下js代码，之前的也可以用，都一样的。

今天正值10.24程序员节，祝所有的程序员节日快乐

看到很多博客都有追番、豆瓣之类的页面，我也手痒想搞一个，不过我又不是很喜欢豆瓣的那个插件。

  • 一是豆瓣作品限制大自由度不高。
  • 二是样式也不是很满意，修改的话也很费时间。

然后我就想到写一个标签外挂来实现这个效果。
趁昨天下午休息的时间完成了大部分功能（包括 藏宝阁 页面，毕竟写标签外挂就是为了这个页面服务的），今天进行了一些完善并发布此教程。

标签外挂的优点：

  • 可以在文章内使用
  • 可以自由填写内容
  • 可以多个合在一起组成一个页面

缺点：
- 需要一个个添加

效果

样式写的很简单，因为我实在是不知道放什么了。

第一次接触这种西方文学小说，刚开始感觉看不懂，断断续续看了很多次。后来越看越觉好看，每次看甚至都需要查“文档” 查看详情
小说
诡秘之主

源码

card.js

在 \themes\butterfly\scripts\tag 文件夹下面新建 card.js 并粘贴如下代码：

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
/**
 * card
 * {% card name,url,bg,star,text,icon,tag,w,h %}
 * {% card 标题,链接,背景,评分,评价,图标,标签,宽度,高度 %}
 */

'use strict'

// 分数转成星星
function tostar(num) {
    let tmp = ''
    for (let i = 0; i < Math.floor(num); i++) { tmp += '<i class="fa-solid fa-star"></i>' } // 整数部分加实心星星
    if (num - Math.floor(num) != 0) tmp += '<i class="fa-solid fa-star-half-alt"></i>' // 小数部分转成半星
    for (let i = 0; i < 5 - Math.ceil(num); i++) { tmp += '<i class="fa-regular fa-star"></i>' } // 不够5个补空心星星
    return tmp
}

function card(args) {
    args = args.join(' ').split(',')

    // 获取参数
    let name = (args[0] || '未知').trim()
    let url = (args[1] || '').trim()
    let bg = (args[2] ? `background-image: url(${args[2]});` : 'background-color: #333;').trim()
    let star = tostar(Number(args[3]) || 0)
    let text = (args[4] || '此作品博主暂未作出评价').trim()
    let icon = (args[5] || '').trim()
    let tag = (args[6] || '').trim()
    let w = args[7] || '200px'
    let h = args[8] || '275px'

    return `<div title="${name}" referrerPolicy="no-referrer" class="card_box" style="${bg} width:${w}; height:${h};">
    <div class="card_mask">
      <span>${text}</span>
      ${url?'<a href="'+url+'">查看详情</a>':''}
    </div>
    <div class="card_top">
      <i class="${icon}"></i>
      <span>${tag}</span>
    </div>
    <div class="card_content">
      <span>${name}</span>
      <div>${star}</div>
    </div>
  </div>`
}

hexo.extend.tag.register('card', card, { ends: false })

card.styl

在 \themes\butterfly\source\css\_tags 文件夹下面新建 card.styl 并粘贴如下代码：

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
.card_box
  display: flex
  justify-content: space-between
  flex-direction: column
  background-position: center
  background-size: cover
  border-radius: 12px
  position: relative
  overflow: hidden
  padding: 10px
  color: #fff !important
  margin: 10px auto
  &::after
    content: ''
    position: absolute
    height: 100%
    width: 100%
    left: 0
    top: 0
    background: rgba(0,0,0,0.1)
    transition: .5s
    z-index: 0
  &:hover
    .card_mask
      opacity: 1
      pointer-events: auto
  .card_top
    display: flex
    z-index: 1
    align-items: center
    justify-content: space-between
  .card_mask
    position: absolute
    pointer-events: none
    z-index: 2
    transition: .5s
    opacity: 0
    width: 100%
    height: 100%
    left: 0
    top: 0
    padding: 20px
    background: #333
    span
      display: block
      height: calc(100% - 40px)
      overflow: auto
    a
      text-align: center
      background: #fff
      color: #333 !important
      border-radius: 5px
      position: absolute
      width: calc(100% - 40px)
      bottom: 20px
      left: 20px
      &:hover
        text-decoration: none !important
        color: white !important
        background: #49b1f5

  .card_content
    z-index: 1
    span
      font-size: 18px
      font-weight: bold

[data-theme='dark']
  .card_box
    color: #ddd !important
    &::after
      background: rgba(0,0,0,0.4)

参数

注意：内容不能有英文逗号，不然会出bug

1
2
3
4
5
6
7
8
9
10
11
<!-- 使用js是为了高亮代码，不必在意 -->
<!-- 参数如下： -->
{% card 标题,链接,背景,评分,评价,图标,标签,宽度,高度 %}
<!-- 示例如下： -->
{% card 诡秘之主,https://book.qidian.com/info/1010868264/,https://bookcover.yuewen.com/qdbimg/349573/1010868264/300,4.5,第一次接触这种西方文学小说，刚开始感觉看不懂，断断续续看了很多次。后来越看越觉好看，每次看甚至都需要查“文档”,fa-solid fa-book-open,小说 %}
<!-- 你也可以什么都不填，将会全部使用默认值，如下： -->
{% card %}
<!-- 你也可以省略部分内容，如下： -->
{% card 诡秘之主,https://book.qidian.com/info/1010868264/,https://bookcover.yuewen.com/qdbimg/349573/1010868264/300 %}
<!-- 位置在后面的参数不填的话可以直接省略，但是如果中间的不想填必须留空，如下： -->
{% card 诡秘之主,,,,,fa-solid fa-book-open,小说 %}
参数 描述 默认值
标题 作品的名字 未知
链接 作品的详情页，填写后会显示查看详情按钮 无
背景 背景 图片Url（必须是图片，想要实现颜色可自行更改代码） 纯色#333
评分 范围 0-5，可以是小数，如3.5和3.1表示三星半，图标只有半星的） 0
评价 点评内容 此作品博主暂未作出评价
图标 左上角图标，请填写fontawsome图标 无
标签 右上角标签 无
宽度 卡片宽度，需要填单位，如：100px 或 10rem 220px
高度 卡片高度，要求同上 300px

后记

各位可以根据自身需求在此基础上进行完善，如果设计出了更好看的ui记得喊喊我，我真的想不出怎么美化了。
有其他问题评论即可，看到之后会回信。