|||
-|-|-|
| 摘要 | Discourse FontAwesome Pro 允许通过使用您账户的 NPM 包令牌在 Discourse 中使用 Font Awesome Pro 图标,并附带 FontAwesome 许可证。
| 存储库链接 | https://github.com/discourse/discourse-fontawesome-pro
| 安装指南 | 如何在 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;
}
双色样式更新
如果您使用的是基于类的选择器,例如:.fa-secondary { color: red; }您需要更新您的样式以使用 CSS 自定义属性。基于类的颜色覆盖自 Font Awesome v7 删除它们以来已不再有效。
在底层,它使用 FontAwesome 的存储库 将字体安装到插件的 SVG 文件夹中,让 Discourse 从那里获取精灵图。
由我们托管? 此插件在我们的企业套餐中提供。



