Erste Schritte mit Theme Creator und der Theme CLI

[Discourse]

Dieses Thema führt Sie durch die Verwendung der Theme CLI mit unserer Theme Creator-Site, um ein Theme zu entwickeln und Ihre Änderungen auf einer Live-Discourse-Site in der Vorschau anzuzeigen.

1. Registrieren Sie sich hier auf Meta, falls Sie dies noch nicht getan haben.

2. Melden Sie sich beim Theme Creator an.

3. Installieren Sie die Theme CLI gemäß den Anweisungen hier.

4. Erstellen Sie ein neues Theme im Theme Creator, indem Sie:

   • https://discourse.theme-creator.io/my/themes besuchen
   • Auf Installieren klicken und die Option „Neu erstellen“ auswählen.
   • Ihrem Theme einen eindeutigen Namen geben (das Farbschema können Sie vorerst ignorieren).

5. Klicken Sie auf Erweitert, dann auf Lokal bearbeiten und API-Schlüssel abrufen.

   Kopieren Sie den generierten API-Schlüssel.

6. Gehen Sie zurück zu Ihrer Kommandozeile und geben Sie discourse_theme download beispiel-ordner ein, wobei beispiel-ordner der Speicherort Ihres Themes lokal ist. Folgen Sie den Anweisungen.

   • Geben Sie https://discourse.theme-creator.io als Stamm-URL Ihrer Discourse-Site ein.

   • Geben Sie Ihren API-Schlüssel aus dem vorherigen Schritt ein, wenn Sie dazu aufgefordert werden.

   • Fahren Sie fort, den Anweisungen zu folgen, und wählen Sie das Theme aus, das Sie in Schritt 4 erstellt haben.

   • Geben Sie Ja ein, wenn Sie gefragt werden, ob Sie Ihr Theme beobachten möchten.

     

7. Nun wird Ihr lokaler Theme-Ordner auf Änderungen überwacht, die automatisch an den Theme Creator hochgeladen werden. Sie können eine Vorschau Ihres Themes anzeigen, indem Sie in den Einstellungen Ihres Themes im Theme Creator auf Vorschau klicken.

   

8. Um die Überwachung von Änderungen zu beenden, drücken Sie Strg + C in Ihrem Kommandozeilenfenster. Um die Überwachung von Änderungen erneut zu starten, geben Sie discourse_theme watch beispiel-theme ein.

Sie verfügen nun über ein lokales Theme-Verzeichnis, das Sie bearbeiten und dessen Änderungen Sie live sehen können!

Für einen detaillierten Einblick in die Struktur von Themes und was Sie damit tun können, lesen Sie unseren Leitfaden unter Developing Discourse Themes & Theme Components

---

Dieses Dokument wird versioniert – schlagen Sie Änderungen auf GitHub vor.