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.

[kjs-fgx]

@awesomerobot

https://discourse.theme-creator.io

Hallo. Ich versuche, diese Anweisungen zu befolgen, stoße aber immer wieder auf Probleme. Nachdem ich den API-Schlüssel hinzugefügt habe, sehe ich Folgendes:

/usr/local/lib/ruby/gems/3.2.0/gems/discourse_theme-0.7.3/lib/discourse_theme/cli.rb:100:in `run': undefined method `exists?' for Dir:Class (NoMethodError)

        FileUtils.mkdir_p dir unless Dir.exists?(dir)
                                        ^^^^^^^
Did you mean?  exist?
        from /usr/local/lib/ruby/gems/3.2.0/gems/discourse_theme-0.7.3/bin/discourse_theme:6:in `<top (required)>'
        from /usr/local/lib/ruby/gems/3.2.0/bin/discourse_theme:25:in `load'
        from /usr/local/lib/ruby/gems/3.2.0/bin/discourse_theme:25:in `<main>'

Irgendeine Idee, warum?
Danke im Voraus

[leonardo (Leonardo Mosquera)]

Hallo!
Dieses Tool unterstützt Ruby 3.2 noch nicht aufgrund von Änderungen in der Sprache. Wir arbeiten an einer Lösung, aber Ruby 3.1.x funktioniert in der Zwischenzeit.

[kjs-fgx]

Ah, das erklärt es dann.
Danke

[leonardo (Leonardo Mosquera)]

Dies ist jetzt behoben - discourse_theme sollte unter Ruby 3.2.x ab Gem-Version 0.7.4 und höher funktionieren

[kjs-fgx]

Wow, das ging schnell
Danke. Mit Hilfe meines Gruppenleiters, der Folgendes vorschlug, konnte ich es zum Laufen bringen:

rbenv install 3.1.3
rbenv shell 3.1.3
gem install discourse_theme

Was tatsächlich erst funktionierte, nachdem ich den Terminal-Tab geschlossen und wieder geöffnet hatte.

[darkpixlz (Pyx)]

Wird discourse_theme watch nicht mehr live-reloaded? Früher wurde mein Theme aktualisiert, wenn ich es gespeichert habe, aber jetzt muss ich meine Registerkarte manuell aktualisieren. Nichts in der Konsole deutet auf einen Grund hin.

[Moin]

Vor einiger Zeit gab es eine Änderung

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

Live reloads of stylesheets have been disabled for production instances, because they were causing problems when updating themes and/or Discourse core. Fundamentally: stylesheet changes are often tied to changes in JS/HTML, so live-loading for only stylesheets is risky. Users end up running ‘new’ stylesheets against ‘old’ HTML, which can lead to some very strange experiences. Live-loading is still enabled for development-mode Discourse instances. Ideally, you’d use that for development rather …

Vielleicht interessiert Sie auch Live Reload in Production