Installieren Sie die Discourse Theme CLI-Konsolen-App, um Ihnen beim Erstellen von Themes zu helfen

Der discourse 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 :unicorn: 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.

  • :exclamation: Wählen Sie beim Generieren des Schlüssels ein „Benutzerebene“ von Einzelner Benutzer und nicht Alle Benutzer.
  • :exclamation: Stellen Sie sicher, dass Sie Globaler Schlüssel aktivieren, 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 :slight_smile: Und es ist ziemlich verdammt cool. Schön!“ @angus
„OMG. Es ist unglaublich.“ @pfaffman


Dieses Dokument wird versionskontrolliert – schlagen Sie Änderungen auf github vor.

79 „Gefällt mir“
Theme Creator, create and show themes without installing Discourse!
CSS Theme Contest (with Prizes!)
Customizing handlebars templates
Setting up a solid workflow for custom theme development
Theme Developer Quick Reference Guide
Structure of themes and theme components
Automating Discourse Plugin Setup with `create-discourse-plugin` gem
When exporting a theme, I get a broken archive
Install Discourse for development using Docker
Developing Plugins Faster by separating the frontend into a theme component
Feedback on "on-discourse" javascript for setting up custom JS for each page?
Add settings to your Discourse theme
Get started with Theme Creator and the Theme CLI
Designer's Guide to getting started with themes in Discourse
Split up theme Javascript into multiple files
Updated Custom Header Icon: Post Data via URL
Theme Developer Tutorial: 2. Creating a remote theme
Developing Discourse Themes & Theme Components
Hiding GUI elements for new users (less overwhelming)
Add custom content that only appears on your homepage
Custom CSS/HTML
[Zotero extension +] Firefox v116 on macOS broken Discourse?
Remote themes not in database
How "difficult" is modifying/extending Discourse for a backend dev
Exporting a Theme from Staging and Importing it to the Production portal
Using Plugin Outlet Connectors from a Theme or Plugin
Downloaded component installs fine, but does not once changed/re-zipped
What are the benefits of a dev environment?
3.2.0.beta2-dev (7019dbcfe1) does not load CSS from common.scss anymore
End-to-end system testing for themes and theme components
Different CSS changes for different color schemes
Need help integrating code wrote on Edittext to the Discourse
Need help integrating code wrote on Edittext to the Discourse
How to add a custom button in user profile card?
How to easily edit my site remotely?
When to use a plugin vs theme component?
Discourse core is switching to pnpm for JS package management
Using the new custom-homepage feature
Focus the editor when title is pre-filled
Cannot put the template in the desired outlet
Is this the correct way to create a theme component?
Split up theme Javascript into multiple files
Canvas Theme Template
If you want to edit this theme, you must submit a change on its repository
Import site theme via console
How are theme setting fields created?
Customisability in discourse?
Edit CSS/HTML editor cursor offset makes it unusable due to CSS font override
Discourse Theme CLI is the bomb
Discourse 2.0.0.beta5 Release Notes
How difficult would it be to make the Discourse UI more like Flarum?
Discourse-webpack: A boilerplate for developing JS-heavy Discourse components
Import Error: about.json does not exist, or is invalid
How to Add Unique HTML Content Below Topic Body in discourse forum for Specific Topics
Reuse Discourse Hamburger Functionality
Themes - Add a description field
Create and share a font theme component
Customisability in discourse?
How to create a theme (if I am a pure end user)
Linting configuration
Linting configuration
Is it possible to use a local plugin directory with a docker install?
How to overrule a color variable for one theme only?
Can't customize text on custom button in template override using UI
Is it possible to use theme component from local folder (as plugin) - for local development?
Restrict editing of remote themes