 |
摘要 | Discourse FontAwesome Pro 允许您通过账户的 NPM 包令牌，在拥有 FontAwesome 许可证 的情况下，于 Discourse 中使用 Font Awesome Pro 图标。 |
 |
仓库链接 | https://github.com/discourse/discourse-fontawesome-pro |
 |
安装指南 | 如何在 Discourse 中安装插件 |
配置
与常规插件相比，启用此插件需要额外的步骤：
首先，您需要设置一个包含 Font Awesome Pro 许可证密钥的额外环境变量：DISCOURSE_FONTAWESOME_AUTH_TOKEN
安装脚本还必须在初始化期间作为额外的“after_code”钩子被调用。这将使用您的身份验证令牌下载并添加 Font Awesome 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;
}
双色图标样式更新
如果您使用的是基于类的选择器，例如：.fa-secondary { color: red; }您需要更新样式以改用 CSS 自定义属性。基于类的颜色覆盖已不再有效，因为它们已在 Font Awesome v7 中被移除
在底层，此插件使用 FontAwesome 的仓库 将字体安装到插件的 SVG 文件夹中，并让 Discourse 从中获取精灵图。
由我们托管？ 此插件可在我们的企业版计划中使用。