开始使用 Theme Creator 和 Theme CLI

[Discourse]

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

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

2. 登录 Theme Creator

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

4. 通过以下步骤在 Theme Creator 上创建新主题：

   • 访问 https://discourse.theme-creator.io/my/themes
   • 点击 Install，然后选择“Create New”选项。
   • 为您的主题命名一个唯一的名称（颜色方案暂时可以忽略）。

5. 点击 advanced，然后点击 edit locally，最后点击 retrieve API key。

   复制生成的 API 密钥。

6. 返回命令行并输入 discourse_theme download example-folder，其中 example-folder 是您本地存储主题的目录。按照提示操作。

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

   • 在出现提示时输入您在上一步中获得的API 密钥。

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

   • 在被问及是否要开始监视主题时输入 yes。

     

7. 现在您的本地主题文件夹正在被监视更改，这些更改将自动上传到 Theme Creator。您可以通过点击 Theme Creator 上主题设置中的 preview 来打开主题的预览。

   

8. 要停止监视更改，请在命令行窗口中按 ctrl + c。要再次开始监视更改，请键入 discourse_theme watch example-theme。

现在您有了一个本地主题目录，可以对其进行编辑并实时查看更改！

要深入了解主题的结构以及您可以进行的操作，请查看我们的 Developing Discourse Themes & Theme Components

---

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