Discourse 主题 CLI 是一个 ruby gem,它允许您在开发 Discourse 主题和主题组件时使用您选择的编辑器。当您保存文件时,CLI 将更新远程主题或组件,并且对它的更改将实时显示!
安装
要试用它,请确保您已安装 Ruby 2.5 或更高版本。
如果您使用的是 Windows,您有 2 个选择:
选项 1: 适用于 Linux 的 Windows 子系统。
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 站点(带有实时刷新)同步,使用 discourse_theme watch YOUR_DIR_NAME
这意味着您可以使用您自己的编辑器来编辑您的主题,站点将神奇地
更新更改!
discourse_theme download
您可以使用 discourse_theme download YOUR_DIR_NAME 从 Discourse 下载现有主题。然后系统会询问您是否要立即开始“监视”!
凭证
您需要生成一个 API 密钥。转到管理区域并在那里生成一个密钥。
生成密钥时,请选择“用户级别”为 Single User,而不是All Users。
确保勾选 Global Key,否则您将收到 403 禁止访问错误。
凭证(可选)存储在 ~/.discourse_theme。API 密钥是按站点存储的,并且每个目录的 URL/theme_id 也会被跟踪。如果您需要更改设置,只需在任何命令后添加 --reset,系统将再次提示您输入所有值。
评价
“这个工具真是一个 GEM!” @awole20
“这非常好。” @awesomerobot
“它奏效了
而且它非常棒。太棒了!” @angus
“我的天哪。这太不可思议了。” @pfaffman
此文档是版本控制的 - 在 github 上建议更改。

