Discourse 主题 CLI 是一个 Ruby gem,允许你在开发 Discourse 主题和主题组件时使用你喜欢的编辑器。当你保存文件时,CLI 会更新远程主题或组件,更改将实时显示!
安装
要试用它,请确保已安装 Ruby 2.5 或更高版本。
如果你使用的是 Windows,你有 2 种选择:
选项 1:Windows 子系统 for Linux。
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 或更高版本正在运行,打开终端或命令 shell 并运行:
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,系统将再次提示你输入所有值。
用户评价
“这个工具真是一颗宝石!” @awole20
“这非常好非常好。” @awesomerobot
“它运行良好
而且相当酷。不错!” @angus
“天哪。难以置信。” @pfaffman
本文档受版本控制 - 在 github 上建议更改。


