Discourse FontAwesome Pro

|||
-|-|-|
:discourse2: | 摘要 | Discourse FontAwesome Pro 允许通过使用您账户的 NPM 包令牌在 Discourse 中使用 Font Awesome Pro 图标,并附带 FontAwesome 许可证
:hammer_and_wrench: | 存储库链接 | https://github.com/discourse/discourse-fontawesome-pro
:open_book: | 安装指南 | 如何在 Discourse 中安装插件

配置

这需要比普通插件多几个步骤才能启用:

首先,您需要设置一个额外的环境变量,其中包含您的 Font Awesome Pro 许可证密钥: DISCOURSE_FONTAWESOME_AUTH_TOKEN

安装脚本也需要在初始化期间调用,作为额外的“after_code”钩子。这会在构建时使用您的身份验证令牌下载并添加 FontAwesome Pro SVG。这是一个独立的块,与插件克隆块分开。

以下是 app.yml 中的安装示例:

env:
  DISCOURSE_FONTAWESOME_AUTH_TOKEN: 123456

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

选择覆盖系列:

在管理员设置中,您可以覆盖默认的 Discourse 图标系列:

选择覆盖样式:

您还可以覆盖默认的图标样式:

双色

要完全控制双色支持,您需要覆盖(在主题中或其他地方)以下 CSS,并用您自己的配色方案替换它:

svg {
  --fa-secondary-color: red;
  --fa-secondary-opacity: 0.6;
}

要为单个图标着色,请引用 SVG 的 ID:

#fad-search .fa-secondary {
  --fa-secondary-color: red;
  --fa-secondary-opacity: 0.6;
}

:warning: 双色样式更新
如果您使用的是基于类的选择器,例如:

.fa-secondary { color: red; }

您需要更新您的样式以使用 CSS 自定义属性。基于类的颜色覆盖自 Font Awesome v7 删除它们以来已不再有效。


在底层,它使用 FontAwesome 的存储库 将字体安装到插件的 SVG 文件夹中,让 Discourse 从那里获取精灵图。

:discourse2: 由我们托管? 此插件在我们的企业套餐中提供。

36 个赞

@featheredtoast 我还没来得及检查,但这个能下载到最新版本的 Font Awesome Pro,比如 6.x 吗?

这里提到了一个变通方法:

最新版本是否已支持 FA6 pro? @featheredtoast

恐怕还没有。我认为情况仍然是这样:

3 个赞

供大家参考,此功能在 v6 中仍然无效,即使最新的核心支持它,您仍然需要使用 --branch fa5 才能使 pro 图标正常工作。

3 个赞

此插件是否仍在维护?我想知道我们现在是否可以使用 FA(6) pro 图标

它确实需要一些整理——它在列表上,我们正在处理——请原谅粉尘。

2 个赞

大家好,我已经更新了这个插件以支持 FontAwesome v7,我将很快更新文档。

6 个赞

在插件设置中,“regular”样式是否未正确应用?在查看 Find Icons with the Perfect Look & Feel | Font Awesome 时,FA 图标的 regular 样式都是空心的,但在我的网站上,图标仍然是实心的。

2 个赞

感谢您的报告,修复程序已合并。如果您遇到任何其他问题,请告知。

2 个赞

嗨 Juan,

这是否与此有关?

1 个赞

有人在使用插件启用时遇到“d-icon-d-watching-first”图标无法工作的问题吗?
已在 3.6.0.beta2 上测试

1 个赞

哦,抓得好。我刚刚更新了插件,使其能再次显示正确的图标。

2 个赞

另一个错误(重新)出现,设置如下:
Fa 图标样式设置为 regular
Fa 图标集设置为 classic

当设置了提醒的书签,没有显示图标:

CleanShot 2025-11-24 at 15.58.04@2x

2 个赞

谢谢!刚刚推送了一个修复程序。现在应该可以了。

2 个赞