 |
Resumen | Discourse FontAwesome Pro permite el uso de iconos de Font Awesome Pro en Discourse mediante una licencia de FontAwesome utilizando el token del paquete NPM de tu cuenta. |
 |
Enlace al repositorio | https://github.com/discourse/discourse-fontawesome-pro |
 |
Guía de instalación | Cómo instalar plugins en Discourse |
Configuración
Esto requiere algunos pasos adicionales para habilitarlo desde un plugin normal:
Primero, necesitarás configurar una variable de entorno adicional que contenga tu token del paquete de font awesome pro (ten en cuenta que esto es diferente de tu token de API): DISCOURSE_FONTAWESOME_AUTH_TOKEN
El script de instalación también debe llamarse durante la inicialización, como un gancho “after_code” adicional. Esto descarga y agrega los SVG de FontAwesome Pro durante la compilación utilizando tu token de autenticación. Este es un bloque adicional separado del bloque de clonación del plugin.
Aquí hay un ejemplo de instalación en 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
Selección de una familia de reemplazo:
En la configuración de administración, puedes reemplazar la familia de iconos predeterminada de Discourse:
Selección de un estilo de reemplazo:
También puedes reemplazar el estilo de icono predeterminado:
Duotono
Para tomar el control total del soporte de duotono, deberás reemplazar el siguiente CSS (en un tema, o de otra manera) y sustituirlo por tu propio esquema de colores:
svg {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Para colorear iconos individuales, haz referencia al ID del SVG:
#fad-search .fa-secondary {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Actualización del estilo Duotono
Si estás usando selectores basados en clases como:.fa-secondary { color: red; }Necesitarás actualizar tu estilo para usar propiedades personalizadas de CSS en su lugar. Los reemplazos de color basados en clases ya no funcionan ya que fueron eliminados en Font Awesome v7
Internamente, esto utiliza el repositorio de FontAwesome para instalar fuentes en la carpeta SVG del plugin, y permite que Discourse recupere los sprites desde allí.
