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 live.

1. Iscriviti a 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 facendo così:

   • 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 example-folder, dove example-folder è dove il tuo tema verrà salvato 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 vuoi 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 tema su Theme Creator.

   

8. Per smettere di monitorare le modifiche, premi ctrl + c nella finestra del tuo terminale. Per ricominciare a monitorare le modifiche digita discourse_theme watch example-theme.

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

Per un’analisi approfondita di come sono strutturati i temi e di cosa puoi fare, consulta la nostra Developing Discourse Themes & Theme Components

---

Questo documento è sottoposto a controllo di 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

[micke]

Sto cercando di capire come visualizzare correttamente il mio tema su https://discourse.theme-creator.io/.

discourse_theme watch funziona e sta sincronizzando le mie modifiche all’URL di anteprima. Ho creato la struttura di un tema in cui ho aggiunto color_schemes a about.json. Questi appaiono nel menu a discesa per il tema sotto /me/theme. Tuttavia, non riesco effettivamente a selezionare uno schema/palette e visualizzarlo; sono bloccato con uno predefinito chiamato “Light” che non ho specificato io.

I miei schemi di colori nominati dal mio about.json non appaiono nemmeno sotto /me/preferences/interface.

Cosa sto sbagliando?

Grazie!