主题开发

更新日志:FlatPaper 现已支持赞赏码

2026-05-30 #主题#更新日志

文章底部那一行「评论 / 分享」的互动区,现在可以追加你自己的条目了。最常见的用法就是赞赏码:放一个按钮,点一下气泡里弹出收款二维码。支持配置多个,支付宝、微信、PayPal 的图标都已内置。

它长什么样

在文章底部互动区(article-reactions)里,自定义条目和「评论」「分享」并排排布:

  • 一个圆形图标按钮 + 旁边一行文字(比如「微信」「支付宝」「赞赏」)
  • 点击后,按钮上方弹出一个气泡,里面是你提供的图片(一般是收款二维码)
  • 再点一次、点页面其他地方、或按 Esc 都会收起气泡
  • 多个条目互斥:打开一个会自动收起其他的

当前自定义条目只支持 image 一种类型——点击弹出一张图片。后续可以按同样的结构扩展更多类型。

怎么配置

在站点的 _config.flatpaper.yml 里新增 reactions.custom,每个条目就是一张赞赏码:

1
2
3
4
5
6
7
8
9
10
11
12
13
reactions:
custom:
- type: image # 目前仅支持 image
name: 微信 # 按钮旁的文字
icon: wechat # 图标,见下表
align: left # 靠左(与「评论」同侧)
image: https://img.nep.me/ooo/square-simple.webp # 二维码图片
title: 微信 # 可选,气泡标题,缺省用 name
- type: image
name: 支付宝
icon: alipay
align: right # 靠右(与「分享」同侧)
image: https://img.nep.me/ooo/square-simple.webp

字段说明:

字段 说明
type 条目类型,目前仅 image(点击弹出一张图片)
name 按钮旁文字,如 赞赏 / 微信 / 支付宝;缺省为 赞赏
icon 图标名:gift(默认)、alipaywechatpaypalheart,或任意内置图标
align left 靠左(与「评论」同侧)/ right 靠右(与「分享」同侧,默认)
image 二维码图片:站点 source/ 下的相对路径(如 /images/reward.jpg)或绝对 URL
title 可选,气泡标题;缺省用 name

新增的支付图标

为了配合赞赏码,这次同时往主题里加了三个品牌图标(来自 Simple Icons,CC0)和一个默认的 gift 图标:

  • alipay — 支付宝
  • wechat — 微信
  • paypal — PayPal
  • gift — 赞赏默认图标(描边风格)

这些图标也进了内置图标速查,正文里直接贴 <svg> 或在主题模板里 partial('_partial/icons', { icon: 'alipay' }) 都能用。

小提示

  • image 用绝对 URL 或站内相对路径都行,气泡里的二维码默认带了 no-zoom,不会被 Fancybox 灯箱再叠一层。
  • 想把赞赏放在左边、分享类放右边,靠 align 自由组合即可。
  • 不配置 reactions.custom 时,互动区保持原样,只有「评论 / 分享」,不会多出任何东西。
评论
微信
支付宝
分享

评论