Discourse FontAwesome Pro

:discourse2: 摘要 Discourse FontAwesome Pro 允许在 Discourse 中使用 Font Awesome Pro 图标,您只需使用账户的 NPM 包令牌并拥有 FontAwesome 许可证即可。
:hammer_and_wrench: 代码仓库链接 https://github.com/discourse/discourse-fontawesome-pro
:open_book: 安装指南 如何在 Discourse 中安装插件

配置

启用 fontawesome pro icons enabled 站点设置,并在 fontawesome auth token 站点设置中输入您的 Font Awesome Pro 包令牌(注意:这与您的 API 令牌不同)。Discourse 将在后台下载图标。

您也可以改用 DISCOURSE_FONTAWESOME_AUTH_TOKEN 环境变量来设置令牌。如果采用此方法,则该密钥将无法在 UI 中编辑。

此插件的旧版本需要在 app.yml 中运行 scripts/install.sh。现在已不再需要,您可以将其移除。


选择覆盖字体族:

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

选择覆盖样式:

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

Duotone(双色调)

要完全控制 duotone 支持,您需要覆盖以下 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: Duotone 样式更新
如果您使用基于类的选择器,例如:

.fa-secondary { color: red; }

您需要将样式更新为使用 CSS 自定义属性 代替。由于这些特性在 Font Awesome v7 中已被弃用,基于类的颜色覆盖不再起作用。


在底层,这使用了 FontAwesome 的代码仓库 将字体安装到插件的 SVG 文件夹中,并让 Discourse 从那里获取精灵图。

:discourse2: 由我们托管? 此插件在我们的企业版计划中可用。

36 个赞

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

1 个赞

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

最新版本是否已支持 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 个赞

@Alteras

您认为增加一个插件功能,允许为所有活动状态图标使用不同的样式,怎么样?例如,我看到趋势是使用填充的(在 FA 中是“实心”图标样式)图标作为活动状态,使用空心图标(在 FA 中是“常规”图标样式)作为常规状态。

在使用 Discourse 时,我注意到在活动状态下使用空心(又称 FA 常规样式)图标感觉很“奇怪”。

2 个赞

API 似乎不适用于 60 美元的 Lite 套餐,我猜你需要每年 99 美元的 Pro 套餐才能使用 API 来获取专业图标……

不,API 需要下载选项和 SVG 应用使用,这需要专业版(或更高版本)。专业精简版仅允许通过其套件进行有限的网页使用。他们并未明确说明这一点,这或许应该添加到原帖中。