Inizia con Theme Creator e il Theme CLI

[Discourse]

Questo argomento ti guiderà nell’utilizzo della Theme CLI con il nostro sito Theme Creator per sviluppare un tema e visualizzare in anteprima le modifiche su un sito Discourse attivo.

1. Registrati per un account qui su Meta se non l’hai ancora fatto

2. Accedi a Theme Creator

3. Installa la Theme CLI seguendo le istruzioni qui

4. Crea un nuovo tema su Theme Creator:

   • Visita https://discourse.theme-creator.io/my/themes
   • Clicca su Install, e seleziona l’opzione “Create New”.
   • Assegna un nome univoco al tuo tema (puoi ignorare lo schema colore per ora).

5. Clicca su advanced, poi su edit locally, e su retrieve API key.

   Copia la chiave API che viene generata.

6. Torna alla riga di comando e digita discourse_theme download nome-cartella-esempio, dove nome-cartella-esempio è dove il tuo tema verrà memorizzato localmente. Segui le istruzioni.

   • Inserisci https://discourse.theme-creator.io come URL radice del tuo sito Discourse.

   • Inserisci la tua chiave API dal passaggio precedente quando richiesto.

   • Continua a seguire le istruzioni e seleziona il tema che hai creato al punto 4.

   • Inserisci sì quando ti viene chiesto se desideri iniziare a monitorare il tuo tema.

     

7. Ora la tua cartella del tema locale viene monitorata per le modifiche, che verranno caricate automaticamente su Theme Creator. Puoi aprire un’anteprima del tuo tema cliccando su preview nelle impostazioni del tuo tema su Theme Creator.

   

8. Per interrompere il monitoraggio delle modifiche, premi ctrl + c nella finestra del tuo terminale. Per ricominciare a monitorare le modifiche digita discourse_theme watch nome-tema-esempio.

Ora hai una directory di temi locale che puoi modificare e vedere le tue modifiche dal vivo!

Per uno sguardo approfondito su come sono strutturati i temi e cosa puoi fare, consulta la nostra guida Developing Discourse Themes & Theme Components

---

Questo documento è controllato in versione - suggerisci modifiche su github.

← START DOCS ASSET MAP
[
{
“local_path”: “/assets/theme-creator-1.png”,
“local_sha1”: “dbdcf5d5d2d2fc49338a763910331f0c88c7e553”,
“remote_short_url”: “upload://g3bKOFrBSQMsTRs1grErKhPO3Nd.png”
},
{
“local_path”: “/assets/theme-creator-2.png”,
“local_sha1”: “14bfd001fa87742777715f8b394e95a0e6ea4dcc”,
“remote_short_url”: “upload://mikbDMP3hiqUWyFTrgqYIeKTXTn.png”
},
{
“local_path”: “/assets/theme-creator-3.png”,
“local_sha1”: “22f12be193aefde97922c5bf60a6b3dccc8a635b”,
“remote_short_url”: “upload://okM7pOJux3wqzsmESvGI2QikjOr.png”
}
]
END DOCS ASSET MAP →

[kjs-fgx]

@awesomerobot

https://discourse.theme-creator.io

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

[leonardo (Leonardo Mosquera)]

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.

[kjs-fgx]

Ah, ecco perché allora.
Grazie

[leonardo (Leonardo Mosquera)]

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

[kjs-fgx]

Wow, è stato veloce
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.

[darkpixlz (Pyx)]

discourse_theme watch non ricarica più in tempo reale? Prima aggiornava il mio tema quando lo salvavo, ma ora devo aggiornare manualmente la scheda. Niente nella console che indichi il motivo.

[Moin]

C’è stato un cambiamento un po’ di tempo fa

Install the Discourse Theme CLI console app to help you build themes

Live reloads of stylesheets have been disabled for production instances, because they were causing problems when updating themes and/or Discourse core. Fundamentally: stylesheet changes are often tied to changes in JS/HTML, so live-loading for only stylesheets is risky. Users end up running ‘new’ stylesheets against ‘old’ HTML, which can lead to some very strange experiences. Live-loading is still enabled for development-mode Discourse instances. Ideally, you’d use that for development rather …

Potresti essere interessato a Live Reload in Production