Discourse FontAwesome Pro

[Discourse]

	Zusammenfassung	Discourse FontAwesome Pro ermöglicht die Verwendung von Font Awesome Pro-Icons in Discourse mit einer FontAwesome-Lizenz mithilfe des NPM-Paket-Tokens Ihres Kontos.
	Repository-Link	https://github.com/discourse/discourse-fontawesome-pro
	Installationsanleitung	So installieren Sie Plugins in Discourse

Da dies ein #official-Plugin ist, das vom Discourse-Team gepflegt wird, können #support-, #contribute:bug-, #contribute:ux- und #contribute:feature-Anfragen in den jeweiligen Kategorien hier auf Meta gestellt und mit dem entsprechenden Plugin-Tag versehen werden. Klicken Sie auf einen der untenstehenden Links, um eine neue Anfrage zu starten.

 Support  Fehler  UX  Funktion

Konfiguration

Dies erfordert einige zusätzliche Schritte im Vergleich zu einem normalen Plugin:

Zunächst 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. Dadurch werden die FontAwesome Pro-SVGs beim Build unter Verwendung Ihres Authentifizierungstokens heruntergeladen und hinzugefügt. Dies ist ein separater Block neben dem Plugin-Klon-Block.

Hier ist ein Beispiel für eine 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 Überschreibungs-Familie:

In den Admin-Einstellungen können Sie die Standard-Icon-Familie von Discourse überschreiben:

Auswahl eines Überschreibungs-Stils:

Sie können auch den Standard-Icon-Stil überschreiben:

Duotone

Um die volle Kontrolle über die Duotone-Unterstützung zu erhalten, müssen Sie das folgende CSS überschreiben (in einem Theme oder anderweitig) und durch Ihr eigenes Farbschema ersetzen:

svg {
  --fa-secondary-color: red;
  --fa-secondary-opacity: 0.6;
}

Um einzelne Icons zu färben, beziehen Sie sich auf die SVG-ID:

#fad-search .fa-secondary {
  --fa-secondary-color: red;
  --fa-secondary-opacity: 0.6;
}

Aktualisierung des Duotone-Stylings
Wenn Sie klassenbasierte Selektoren verwenden wie:

.fa-secondary { color: red; }

müssen Sie Ihr Styling aktualisieren, um stattdessen CSS-Custom-Properties zu verwenden. Klassenbasierte Farb-Überschreibungen funktionieren nicht mehr, da sie in Font Awesome v7 entfernt wurden

---

Im Hintergrund wird das FontAwesome-Repository verwendet, um Schriftarten in den SVG-Ordner des Plugins zu installieren, sodass Discourse die Sprites von dort übernehmen kann.

Von uns gehostet? Dieses Plugin ist in unseren Enterprise-Plänen verfügbar.

[TheDarkWizard]

@featheredtoast Ich hatte noch keine Gelegenheit nachzusehen, aber lädt dies die aktuellste Version von Fontawesome Pro, wie 6.x, herunter?

[jrgong]

Hier wurde eine Problemumgehung erwähnt:

How to use Font Awesome Pro v6?

<link rel="stylesheet" href="path/to/font-awesome-pro-v6/css/all.min.css"> Obtain the Font Awesome Pro v6 package: Sign in to your Font Awesome account. Download the Font Awesome Pro v6 package, which includes the necessary CSS and font files. Replace “path/to/font-awesome-pro-v6” with the actual path where you have stored the Font Awesome Pro v6 CSS file. By adding the <link> tag to your Discourse theme’s “head_tag.html” file, you’re referencing the Font Awesome Pro v6 CSS file, which will l…

[jrgong]

Unterstützt die neueste Version bereits FA6 Pro? @featheredtoast

[JammyDodger]

Ich fürchte, das ist noch nicht der Fall. Ich denke, das ist immer noch der Fall:

@awesomerobot

Wir haben noch kein offizielles Update auf v6 durchgeführt… v6 ändert einige Icons, benennt viele um und entfernt einige… es ist also eine ganze Menge Arbeit, alles zu finden, was aktualisiert und ersetzt werden muss. Hoffentlich können wir uns bald darum kümmern.

[davidkingham]

Für alle, die sich fragen, dies funktioniert immer noch nicht mit v6, selbst mit dem neuesten Core, der es unterstützt. Sie müssen immer noch --branch fa5 verwenden, damit die Pro-Icons funktionieren.

[jrgong]

Wird dieses Plugin noch gepflegt? Ich frage mich, ob wir zu diesem Zeitpunkt FA(6) Pro-Icons verwenden könnten.

[featheredtoast (Jeff Wong)]

Es muss aufgeräumt werden – es steht auf der Liste, wir arbeiten daran – Entschuldigen Sie die Unordnung.

[Juan_David_Martínez (Juan David Martinez Cubillos)]

Hallo zusammen, ich habe dieses Plugin aktualisiert, damit es mit FontAwesome v7 funktioniert. Ich werde die Dokumentation in Kürze aktualisieren.

[jrgong]

Ist es möglich, dass der regular-Stil in den Plugin-Einstellungen nicht korrekt angewendet wird? Wenn ich mir Find Icons with the Perfect Look & Feel | Font Awesome ansehe, sind die FA-Icons im regular-Stil alle hohl, aber auf meiner Website haben die Icons immer noch einen gefüllten Stil

[Juan_David_Martínez (Juan David Martinez Cubillos)]

Danke für die Meldung, die Korrektur wurde bereits zusammengeführt. Lassen Sie mich wissen, wenn Sie auf weitere Probleme stoßen.

[putty (Derek Putnam)]

Hallo Juan,
Hängt das zufällig damit zusammen?

[jrgong]

Hat noch jemand ein Problem damit, dass das Icon „d-icon-d-watching-first“ nicht funktioniert, wenn das Plugin aktiviert ist?
Getestet auf 3.6.0.beta2

[Alteras (Steven Chang)]

Gut bemerkt. Ich habe das Plugin gerade aktualisiert, damit es wieder das richtige Symbol anzeigt.

[jrgong]

Anderer Fehler (erneut) aufgetreten mit folgenden Einstellungen:
Fa-Symbolstil auf “regular” gesetzt
Fa-Symbolfamilie auf “classic” gesetzt

Wenn ein Lesezeichen mit Erinnerung gesetzt ist, wird kein Symbol angezeigt:

[Alteras (Steven Chang)]

Danke! Habe gerade einen Fix dafür hochgeladen. Sollte jetzt funktionieren.

[jrgong]

@Alteras

Was halten Sie von einer zusätzlichen Plugin-Funktion, die es ermöglicht, für alle aktiven Zustands-Icons einen anderen Stil zu verwenden? Zum Beispiel sehe ich den Trend, gefüllte Icons (in FA: „solid“ Icon-Stil) für den aktiven Zustand und hohle Icons (in FA: „regular“ Icon-Stil) für den normalen Zustand zu verwenden.

Während der Nutzung von Discourse ist mir aufgefallen, dass es sich „seltsam“ anfühlt, hohle Icons (auch bekannt als FA Regular Stil) im aktiven Zustand zu haben.

[hipp0]

Die API scheint mit dem $60 Lite-Plan nicht zu funktionieren. Ich vermute, Sie benötigen den $99 pro Jahr Pro-Plan, um die API für Pro-Icons zu verwenden…