Discourse Theme CLI は、Discourse のテーマやテーマコンポーネントを開発する際に、好きなエディタを使用できるようにする Ruby gem です。ファイルを保存すると、CLI はリモートのテーマまたはコンポーネントを更新し、その変更がライブで表示されます!
インストール
試すには、Ruby 2.5 以降がインストールされていることを確認してください。
Windows の場合は、2つのオプションがあります。
オプション 1: Windows Subsystem for Linux (WSL)。
Windows 10 では完全な Linux 環境にアクセスできるため、sudo apt-get install ruby で Ruby を簡単にインストールできます。これにより Ruby 2.3 がインストールされます。
オプション 2: 旧バージョンの Windows
旧バージョンの Windows では WSL にアクセスできないため、Ruby Installer を使用して Ruby を簡単にインストールできます。インストールの際は、推奨バージョンとデフォルト設定を選択してください。
Mac OS バージョン 10.13.3 には Ruby 2.3 がプリインストールされているため、特別な設定は必要ありません。それより前のバージョンの Mac OS を実行している場合は、rvm、rbenv、または homebrew を使用して最新の Ruby をインストールすることを検討してください。
Ruby 2.2 以降が動作していることを確認したら、ターミナルまたはコマンドシェルを開き、以下を実行します。
gem install discourse_theme
インストール後、詳細を確認するには以下を実行します。
discourse_theme
アップグレード
gem update discourse_theme
機能
CLI には 3 つの主な機能があります。
discourse_theme new
discourse_theme new YOUR_DIR_NAME を使用して、新しいテーマをすばやく作成できます。
discourse_theme watch
discourse_theme watch YOUR_DIR_NAME を使用して、テーマを監視し、Discourse サイトと同期(ライブリフレッシュ付き)させることができます。
これは、独自のエディタを使用してテーマを編集すると、サイトが魔法のように
変更を更新することを意味します!
discourse_theme download
discourse_theme download YOUR_DIR_NAME を使用して、Discourse から既存のテーマをダウンロードできます。ダウンロード後、すぐに「監視」を開始するオプションが表示されます!
認証情報
API キーを生成する必要があります。管理エリアに移動し、そこでキーを生成してください。
キーを生成する際は、「ユーザーレベル」を All UsersではなくSingle Userに設定してください。
Global Keyにチェックを入れないと、403 forbidden エラーが発生します。
認証情報は(オプションで)~/.discourse_theme に保存されます。API キーはサイトごとに保存され、各ディレクトリの URL/theme_id も追跡されます。設定を変更する必要がある場合は、いずれかのコマンドに --reset を追加するだけで、すべての値を再度求められます。
推薦の声
“This tool is truly a GEM!” @awole20
“This is very very good.” @awesomerobot
“It’s working
And it’s pretty dosh garn cool. Nice!” @angus
“OMG. It’s unbelievable.” @pfaffman
このドキュメントはバージョン管理されています - 変更の提案は github で行えます。

