开始使用主题创建器和主题 CLI

本主题将指导您如何使用 Theme CLI 配合我们的 Theme Creator 站点来开发主题,并在实时的 Discourse 站点上预览您的更改。

  1. 如果您还没有账户,请在此处注册 Meta 账户

  2. 登录 Theme Creator

  3. 通过此处的说明安装 Theme CLI

  4. 在 Theme Creator 上创建新主题:

  5. 点击 advanced(高级),然后点击 edit locally(本地编辑),接着点击 retrieve API key(获取 API 密钥)。

    复制生成的 API 密钥。

  1. 返回命令行并输入 discourse_theme download example-folder,其中 example-folder 是您的主题在本地存储的位置。请按照提示操作。

    • 输入 https://discourse.theme-creator.io 作为您的 Discourse 站点的根 URL。

    • 在提示时输入上一步中的 API 密钥。

    • 继续按照提示操作,并选择您在第 4 步中创建的主题。

    • 当询问是否开始监视您的主题时,输入 yes(是)。

  2. 现在,您的本地主题文件夹正在被监视,任何更改都将自动上传到 Theme Creator。您可以点击 Theme Creator 上主题设置中的 preview(预览)来打开主题的预览。

  3. 要停止监视更改,请在命令行窗口中按 ctrl + c。要重新开始监视更改,请输入 discourse_theme watch example-theme。

:tada: 现在您拥有了一个可以编辑并实时查看更改的本地主题目录!

如需深入了解主题的结构以及您可以执行的操作,请访问 Developing Discourse Themes & Theme Components


本文档受版本控制 - 请在 github 上建议更改。

42 个赞