Schriftart-Theme-Komponente erstellen und teilen

Discourse unterstützt das Importieren von Themes, die Assets aus einem Remote-Repository enthalten.

Dies ermöglicht Theme-Autoren, Schriftarten und Bilder zu teilen.

Ein neues Git-Repository mit der Schriftart erstellen

mkdir discourse-roboto-theme
cd discourse-roboto-theme
git init .
vim about.json

Füge für about.json eine Skelett-Konfigurationsdatei hinzu

{
  "name": "Roboto theme component",
  "about_url": "",
  "license_url": "",
  "assets": {
    "roboto": "assets/roboto.woff2"
  }
}

Füge eine LICENSE-Datei hinzu, ich verwende normalerweise MIT

vim LICENSE

Die Schriftart herunterladen

http://localfont.com/ ist eine praktische Seite, um Schriftarten zu erhalten

mkdir assets
cp ~/Downloads/roboto.woff2 roboto.woff2

CSS hinzufügen, das das Theme verwendet

mkdir common
cd common

Erstelle eine Datei namens common.scss mit

@font-face {
  font-family: Roboto;
  src: url($roboto) format("woff2");
}

body {
  font-family: Roboto;
}

Änderungen zu GitHub pushen

Alle Änderungen committen:

git add LICENSE
git add about.json
git add assets/roboto.woff2
git add common/common.scss
git commit -am "first commit"

Erstelle ein Konto auf GitHub.com und erstelle dann ein neues Repository.

(Optional) ein Thema auf Discourse erstellen, um deine Farben zu besprechen

Idealerweise würdest du ein Thema in der Kategorie Customization > Theme mit einigen Screenshots deines Farbschemas erstellen. Du wirst dies als deine about_url verwenden

Die fehlenden Informationen in deiner about.json-Datei ausfüllen

  • Navigiere zu deiner LICENSE-Seite auf GitHub und füge diese URL als deine license_url ein

  • Verwende entweder die GitHub-Projekt-URL oder die Discourse-Thema-URL als deine about_url

Am Ende des Prozesses wird deine about.json-Datei ungefähr so aussehen:

{
  "name": "Roboto theme component",
  "about_url": "https://github.com/SamSaffron/discourse-roboto-theme",
  "license_url": "https://github.com/SamSaffron/discourse-roboto-theme/blob/master/LICENSE",
  "assets": {
    "roboto": "assets/roboto.woff2"
  }
}

Die Änderung committen und zu GitHub pushen

git commit -am "added more details"
git push

Teste deine Schriftart-Komponente

  • Importiere dein Theme auf dem Bildschirm admin/customize/theme von GitHub

:confetti_ball:

Du kannst jetzt problemlos Schriftarten teilen!

Siehe auch:


Dieses Dokument wird versioniert - schlage Änderungen auf github vor.

19 „Gefällt mir“

Great tutorial.

Worked like a charm except it looks like localfont.com is down or no more.

I used this Google webfonts helper site to download a .woff2 version of the font I was after.

See also Install the Discourse Theme CLI console app to help you build themes

1 „Gefällt mir“

Als ich den Schritten folgte, erhielt ich einen Fehler: Undefinierte Variable: „$fontname“.

Also:
Ich habe die Variable in $variables deklariert:
fontname: „assets/fontname.woff2“;

Es scheint mir, dass Sie sie eingeben müssen, aber welchen Pfad sollen Sie in den $variables verwenden?

Wenn Sie Discourse die Dateien hochladen lassen mit

„assets“: {
        „fontname“: „assets/fontname.woff2“
   }

lädt es die Datei in einen anderen Pfad als assets/roboto.woff2 hoch, scheint es
(„/uploads/db0202/original/1X/…“)

Bearbeiten:
$variables werden nicht benötigt, die Magie geschieht mit den Uploads. Aber ich hatte assets/font.svg#regular in den Assets und das Hashtag hat das Problem verursacht.

2 „Gefällt mir“

Ich erhalte denselben Fehler Error: Undefined variable. Und es werden auch keine Assets in Uploads angezeigt oder als Überschrift hochgeladen.

Muss diese Anleitung aktualisiert werden?

Vielen Dank im Voraus.

1 „Gefällt mir“