|||
-|-|-|
| Zusammenfassung | Discourse FontAwesome Pro ermöglicht die Verwendung von Font Awesome Pro-Icons in Discourse mit einer FontAwesome-Lizenz durch die Verwendung des NPM-Paket-Tokens Ihres Kontos.
| Repository-Link | https://github.com/discourse/discourse-fontawesome-pro
| Installationsanleitung | So installieren Sie Plugins in Discourse
Konfiguration
Dies erfordert ein paar zusätzliche Schritte zur Aktivierung im Vergleich zu einem normalen Plugin:
Zuerst müssen Sie eine zusätzliche Umgebungsvariable mit Ihrem Font Awesome Pro-Lizenzschlüssel einrichten: DISCOURSE_FONTAWESOME_AUTH_TOKEN
Das Installationsskript muss auch während der Initialisierung als zusätzlicher “after_code”-Hook aufgerufen werden. Dies lädt und fügt die FontAwesome Pro-SVGs während des Builds herunter und verwendet dabei Ihr Auth-Token. Dies ist ein zusätzlicher Block, getrennt vom Plugin-Clone-Block.
Hier ist ein Beispiel für die Installation in 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
Auswahl einer Überschreibungsfamilie:
In den Admin-Einstellungen können Sie die Standard-Icon-Familie von Discourse überschreiben:
Auswahl eines Überschreibungsstils:
Sie können auch den Standard-Icon-Stil überschreiben:
Duotone
Um die volle Kontrolle über die Duotone-Unterstützung zu erhalten, müssen Sie die folgende CSS (in einem Theme oder anderweitig) überschreiben und durch Ihr eigenes Farbschema ersetzen:
svg {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Um einzelne Icons einzufärben, beziehen Sie sich auf die ID des SVG:
#fad-search .fa-secondary {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Aktualisierung der Duotone-Formatierung
Wenn Sie klassenbasierte Selektoren wie diese verwenden:.fa-secondary { color: red; }Sie müssen Ihre Formatierung aktualisieren, um CSS-Custom Properties zu verwenden. Klassenbasierte Farb-Overrides funktionieren nicht mehr, da sie in Font Awesome v7 entfernt wurden
Im Hintergrund wird das Repository von FontAwesome verwendet, um Schriftarten in den SVG-Ordner des Plugins zu installieren, und Discourse kann die Sprites von dort abrufen.
Von uns gehostet? Dieses Plugin ist in unseren Enterprise-Plänen verfügbar.