Der
Discourse Theme CLI ist ein Ruby Gem, mit dem Sie Ihren bevorzugten Editor verwenden können, wenn Sie Discourse-Themes und Theme-Komponenten entwickeln. Wenn Sie Dateien speichern, aktualisiert die CLI das Remote-Theme oder die Komponente, und Änderungen daran werden live angezeigt!
Installation
Um damit zu spielen, stellen Sie sicher, dass Sie Ruby 2.5 oder neuer installiert haben.
Wenn Sie Windows verwenden, haben Sie 2 Möglichkeiten:
Option 1: Windows-Subsystem für Linux.
Windows 10 hat Zugriff auf eine vollständige Linux-Umgebung. Sie können diese verwenden, um Ruby einfach mit sudo apt-get install ruby zu installieren. Dies gibt Ihnen Ruby 2.3.
Option 2: Älteres Windows
Ältere Versionen von Windows haben keinen Zugriff auf WSL. Sie können Ruby einfach mit Ruby Installer installieren. Wählen Sie die empfohlene Version und die Standardeinstellungen für die Installation.
Mac OS Version 10.13.3 wird standardmäßig mit Ruby 2.3 ausgeliefert, es ist nichts Besonderes erforderlich. Wenn Sie eine frühere Version von Mac OS verwenden, sollten Sie rvm, rbenv oder homebrew verwenden, um ein aktuelles Ruby zu installieren.
Sobald Ruby 2.2 oder neuer läuft, öffnen Sie ein Terminal oder eine Befehlskonsole und führen Sie Folgendes aus:
gem install discourse_theme
Nach der Installation erfahren Sie mehr darüber mit:
discourse_theme
Aktualisieren
gem update discourse_theme
Funktionen
Die CLI bietet 3 Hauptfunktionen:
discourse_theme new
Sie können sie verwenden, um schnell ein neues Theme mit discourse_theme new NAME_IHRES_VERZEICHNISSES zu erstellen.
discourse_theme watch
Sie können sie verwenden, um ein Theme zu überwachen und mit einer Discourse-Site zu synchronisieren (mit Live-Aktualisierung) mit discourse_theme watch NAME_IHRES_VERZEICHNISSES.
Das bedeutet, dass Sie Ihren eigenen Editor verwenden können, um Ihr Theme zu bearbeiten, und die Seite wird die Änderungen auf magische Weise
aktualisieren!
discourse_theme download
Sie können ein vorhandenes Theme von Discourse mit discourse_theme download NAME_IHRES_VERZEICHNISSES herunterladen. Sie erhalten dann die Option, sofort mit der „Überwachung“ zu beginnen!
Anmeldeinformationen
Sie müssen einen API-Schlüssel generieren. Gehen Sie zum Admin-Bereich und generieren Sie dort einen Schlüssel.
Wählen Sie beim Generieren des Schlüssels ein „Benutzerebene“ von Einzelner Benutzerund nichtAlle Benutzer.
Stellen Sie sicher, dass Sie Globaler Schlüsselaktivieren, andernfalls erhalten Sie 403 Forbidden-Fehler.
Anmeldeinformationen werden (optional) unter ~/.discourse_theme gespeichert. API-Schlüssel werden pro Website gespeichert, und die URL/theme_id für jedes Verzeichnis wird ebenfalls verfolgt. Wenn Sie jemals Ihre Einstellungen ändern müssen, fügen Sie einfach --reset zu einem beliebigen Befehl hinzu, und Sie werden erneut nach allen Werten gefragt.
Testimonials
„Dieses Tool ist wirklich ein GEM!“ @awole20
„Das ist sehr, sehr gut.“ @awesomerobot
„Es funktioniert
Und es ist ziemlich verdammt cool. Schön!“ @angus
„OMG. Es ist unglaublich.“ @pfaffman
Dieses Dokument wird versionskontrolliert – schlagen Sie Änderungen auf github vor.

