Installa l'app console Discourse Theme CLI per aiutarti a creare temi

[Discourse]

Il Discourse Theme CLI è una gemma ruby che ti permette di usare l’editor che preferisci quando sviluppi temi o componenti tema di Discourse. Quando salvi i file, la CLI aggiornerà il tema o componente remoto e le modifiche appariranno in tempo reale!

Installazione

Per provarlo, assicurati di avere installato Ruby 2.5 o superiore.

Se usi Windows, hai 2 opzioni:

Opzione 1: Windows Subsystem for Linux.

Windows 10 ha accesso a un ambiente Linux completo, puoi usarlo per installare ruby semplicemente con sudo apt-get install ruby, questo ti darà Ruby 2.3.

Opzione 2: Windows più vecchio

Le versioni più vecchie di Windows non hanno accesso a WSL, puoi installare facilmente Ruby con Ruby Installer, scegli la versione consigliata e le impostazioni predefinite per l’installazione.

Mac OS versione 10.13.3 viene fornito con Ruby 2.3 di serie, non è necessario nulla di speciale. Se stai usando una versione precedente di Mac OS considera l’uso di rvm, rbenv o homebrew per installare una versione recente di ruby.

---

Una volta che Ruby 2.2 o successivo è in esecuzione, apri un terminale o un prompt dei comandi ed esegui:

gem install discourse_theme

Una volta installato, per saperne di più:

discourse_theme

Aggiornamento

gem update discourse_theme

Funzionalità

La CLI fornisce 3 funzioni principali:

discourse_theme new

Puoi usarla per creare rapidamente un nuovo tema con discourse_theme new NOME_TUA_DIRECTORY

discourse_theme watch

Puoi usarla per monitorare un tema e sincronizzarlo con un sito discourse (con aggiornamento in tempo reale) usando discourse_theme watch NOME_TUA_DIRECTORY

Ciò significa che puoi usare il tuo editor per modificare il tuo tema e il sito si aggiornerà magicamente con le modifiche!

discourse_theme download

Puoi scaricare un tema esistente da Discourse usando discourse_theme download NOME_TUA_DIRECTORY. Ti verrà quindi data l’opzione di iniziare a “monitorare” subito!

Credenziali

Dovrai generare una Chiave API. Vai all’area admin e genera una chiave lì.

• Seleziona un “Livello Utente” di Utente Singolo quando generi la chiave, non Tutti gli Utenti.
• Assicurati di spuntare Chiave Globale o riceverai errori 403 forbidden.

Le credenziali sono (facoltativamente) memorizzate in ~/.discourse_theme. Le chiavi API sono memorizzate per sito, e anche l’URL/theme_id per ogni directory viene tracciato. Se hai mai bisogno di cambiare le tue impostazioni, aggiungi semplicemente --reset a qualsiasi comando e ti verranno richieste nuovamente tutte le impostazioni.

Testimonianze

“Questo strumento è veramente una GEMMA!” @awole20
“Questo è molto molto buono.” @awesomerobot
“Funziona Ed è piuttosto dannatamente bello. Ottimo!” @angus
“OMG. È incredibile.” @pfaffman

---

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