更新日志：FlatPaper 现已支持赞赏码 | Flatpaper Demo

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

它长什么样

在文章底部互动区（article-reactions）里，自定义条目和「评论」「分享」并排排布：

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

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

说是“赞赏码”，其实这项功能本质上只是展示一张图片。赞赏二维码只是最常见的用途，你也可以放活动海报、群二维码、作品预览图、联系方式卡片，或者任何适合在文章底部临时展开查看的图片。现在它已经支持鼠标 hover 显示，桌面端不用点击也能快速查看。

怎么配置

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

reactions:
  custom:
    - type: image          # 目前仅支持 image
      name: 微信            # 按钮旁的文字
      icon: weixin         # 图标，见下表
      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（默认）、alipay、weixin、paypal、heart，或任意内置图标
align	left 靠左（与「评论」同侧）/ right 靠右（与「分享」同侧，默认）
image	二维码图片：站点 source/ 下的相对路径（如 /images/reward.jpg）或绝对 URL
title	可选，气泡标题；缺省用 name

新增的支付图标

为了配合赞赏码，主题内置了这些常用图标。品牌图标现在由内置图标 Registry 提供，微信使用 Font Awesome Free 6 的 weixin 名称：

• alipay — 支付宝
• weixin — 微信
• paypal — PayPal
• gift — 赞赏默认图标（描边风格）

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

小提示

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