Inizia con Theme Creator e il Theme CLI

Documentazione Guide per sviluppatori
, ,
1

This topic will walk you through how to use the Theme CLI with our Theme Creator site to develop a theme and preview your changes on a live Discourse site.

  1. Sign up for an account here on Meta if you haven’t already

  2. Log in to Theme Creator

  3. Install the Theme CLI via the instructions here

  4. Create a new theme on Theme Creator by:

  5. Click advanced, then edit locally, and retrieve API key.

    Copy the API key that is generated.

image
image1224×1612 123 KB
image
image1546×1306 148 KB

  1. Go back to your command line and type discourse_theme download example-folder, where example-folder is where your theme will be stored locally. Follow the prompts.

    • Enter https://discourse.theme-creator.io as the root URL of your Discourse site.

    • Enter your API key from the previous step when prompted.

    • Continue following the prompts and select the theme you created in step 4.

    • Enter yes when asked if you’d like to start watching your theme.

      06%20PM
      06%20PM558×227 32.4 KB

  2. Now your local theme folder is being watched for changes, which will be automatically uploaded to Theme Creator. You can open a preview of your theme by clicking preview in your theme’s settings on Theme Creator.

    27%20PM
    27%20PM1546×1306 170 KB

  3. To stop watching for changes, hit ctrl + c in your command line window. To start watching for changes again type discourse_theme watch example-theme.

:tada: You now have a local theme directory you can edit and see your changes live!

For an in-depth look at how themes are structured and what you can do, check out our Beginner's guide to developing Discourse Themes

This document is version controlled - suggest changes on github.

42 Mi Piace
20

Ciao. Sto cercando di seguire queste istruzioni ma continuo a sbattere contro un muro. Dopo aver aggiunto la chiave API vedo quanto segue:

/usr/local/lib/ruby/gems/3.2.0/gems/discourse_theme-0.7.3/lib/discourse_theme/cli.rb:100:in `run': undefined method `exists?' for Dir:Class (NoMethodError)

        FileUtils.mkdir_p dir unless Dir.exists?(dir)
                                        ^^^^^^^
Did you mean?  exist?
        from /usr/local/lib/ruby/gems/3.2.0/gems/discourse_theme-0.7.3/bin/discourse_theme:6:in `<top (required)>'
        from /usr/local/lib/ruby/gems/3.2.0/bin/discourse_theme:25:in `load'
        from /usr/local/lib/ruby/gems/3.2.0/bin/discourse_theme:25:in `<main>'

Hai qualche idea sul perché?
Grazie in anticipo

1 Mi Piace
21

Ciao!
Questo strumento non supporta ancora Ruby 3.2 a causa di modifiche nel linguaggio. Abbiamo una correzione in lavorazione, ma nel frattempo funziona Ruby 3.1.x.

6 Mi Piace
22

Ah, ecco perché allora.
Grazie :slight_smile:

1 Mi Piace
23

Questo ora è stato corretto: discourse_theme dovrebbe funzionare con Ruby 3.2.x dalla versione gem 0.7.4 in poi :slight_smile:

3 Mi Piace
24

Wow, è stato veloce :open_mouth:
Grazie. Sono riuscito a farlo funzionare con l’aiuto del mio line manager che ha suggerito:

rbenv install 3.1.3
rbenv shell 3.1.3
gem install discourse_theme

che in realtà non ha funzionato finché non ho chiuso la scheda del terminale e l’ho riaperta.