文章底部那一行「评论 / 分享」的互动区,现在可以追加你自己的条目了。最常见的用法就是赞赏码:放一个按钮,点一下气泡里弹出收款二维码。支持配置多个,支付宝、微信、PayPal 的图标都已内置。
它长什么样
在文章底部互动区(article-reactions)里,自定义条目和「评论」「分享」并排排布:
- 一个圆形图标按钮 + 旁边一行文字(比如「微信」「支付宝」「赞赏」)
- 点击后,按钮上方弹出一个气泡,里面是你提供的图片(一般是收款二维码)
- 再点一次、点页面其他地方、或按
Esc都会收起气泡 - 多个条目互斥:打开一个会自动收起其他的
当前自定义条目只支持 image 一种类型——点击弹出一张图片。后续可以按同样的结构扩展更多类型。
怎么配置
在站点的 _config.flatpaper.yml 里新增 reactions.custom,每个条目就是一张赞赏码:
1 | reactions: |
字段说明:
| 字段 | 说明 |
|---|---|
type |
条目类型,目前仅 image(点击弹出一张图片) |
name |
按钮旁文字,如 赞赏 / 微信 / 支付宝;缺省为 赞赏 |
icon |
图标名:gift(默认)、alipay、wechat、paypal、heart,或任意内置图标 |
align |
left 靠左(与「评论」同侧)/ right 靠右(与「分享」同侧,默认) |
image |
二维码图片:站点 source/ 下的相对路径(如 /images/reward.jpg)或绝对 URL |
title |
可选,气泡标题;缺省用 name |
新增的支付图标
为了配合赞赏码,这次同时往主题里加了三个品牌图标(来自 Simple Icons,CC0)和一个默认的 gift 图标:
alipay— 支付宝wechat— 微信paypal— PayPalgift— 赞赏默认图标(描边风格)
这些图标也进了内置图标速查,正文里直接贴 <svg> 或在主题模板里 partial('_partial/icons', { icon: 'alipay' }) 都能用。
小提示
image用绝对 URL 或站内相对路径都行,气泡里的二维码默认带了no-zoom,不会被 Fancybox 灯箱再叠一层。- 想把赞赏放在左边、分享类放右边,靠
align自由组合即可。 - 不配置
reactions.custom时,互动区保持原样,只有「评论 / 分享」,不会多出任何东西。
评论