动画头像

[featheredtoast (Jeff Wong)]

|||
-|-|-|
| 摘要 | Discourse Animated Avatars 增加了用户上传 GIF 头像的功能，这些头像在帖子、用户卡片和个人资料页面上悬停或选中时会动。
| 代码库链接 | \u003chttps://github.com/discourse/discourse-animated-avatars\u003e
| 安装指南 | 如何在 Discourse 中安装插件

功能

默认情况下，当不聚焦时，动画会暂停。在主题中，当帖子未悬停或未选中时，动画会暂停。

animated_avatars_always_animate：覆盖上述暂停设置，强制头像始终动画。
animated_avatars_min_trust_level_to_display 限制按信任级别显示的头像动画。

尊重浏览器辅助功能选项中的 prefers-reduced-motion：动画将完全禁用。

配置

此插件有一个可选的 gifsicle 依赖项。它用于调整上传的 GIF 图像的大小以适应方形头像，这有助于处理纵横比，并使静态和动画图像的大小差异正常化，从而实现更平滑的切换。没有它，插件仍然可以工作，但任何非方形头像在显示时可能会显得拉伸。

要启用它，您将在 app.yml 中添加一个对安装脚本的调用。after_code 挂钩的示例看起来像这样：

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/discourse-animated-avatars.git
    - exec:
        cd: $home/plugins/discourse-animated-avatars
        raise_on_fail: false
        cmd:
          - $home/plugins/discourse-animated-avatars/scripts/install.sh

设置

名称	描述
animated avatars min trust level to display	显示动画头像的最低信任级别
animated avatars always animate	始终为头像设置动画