La
CLI du thème Discourse est un gem Ruby qui vous permet d’utiliser votre éditeur de code préféré lors du développement de thèmes et de composants de thème Discourse. À chaque fois que vous enregistrez des fichiers, la CLI met à jour le thème ou le composant distant et les modifications apparaissent en direct !
Installation
Pour l’essayer, assurez-vous d’avoir installé Ruby 2.5 ou une version ultérieure.
Si vous utilisez Windows, vous avez 2 options :
Option 1 : Windows Subsystem for Linux.
Windows 10 dispose d’un environnement Linux complet, vous pouvez l’utiliser pour installer ruby simplement avec sudo apt-get install ruby, ce qui vous donnera Ruby 2.3.
Option 2 : Anciennes versions de Windows
Les anciennes versions de Windows n’ont pas accès au WSL, vous pouvez facilement installer Ruby avec Ruby Installer, choisissez la version recommandée et les paramètres par défaut pour l’installation.
Mac OS version 10.13.3 est livré avec Ruby 2.3 par défaut, rien de spécial n’est nécessaire. Si vous exécutez une version antérieure de Mac OS, envisagez d’utiliser rvm, rbenv ou homebrew pour installer une version récente de ruby.
Une fois que Ruby 2.2 ou une version ultérieure est en cours d’exécution, ouvrez un terminal ou une invite de commandes et exécutez :
gem install discourse_theme
Une fois installé, pour en savoir plus :
discourse_theme
Mise à niveau
gem update discourse_theme
Fonctionnalités
La CLI fournit 3 fonctions principales :
discourse_theme new
Vous pouvez l’utiliser pour créer rapidement un nouveau thème avec discourse_theme new VOTRE_NOM_DE_DOSSIER
discourse_theme watch
Vous pouvez l’utiliser pour surveiller un thème et synchroniser avec un site discourse (avec actualisation en direct) en utilisant discourse_theme watch VOTRE_NOM_DE_DOSSIER
Cela signifie que vous pouvez utiliser votre propre éditeur pour modifier votre thème et le site se mettra à jour magiquement
avec les changements !
discourse_theme download
Vous pouvez télécharger un thème existant depuis Discourse en utilisant discourse_theme download VOTRE_NOM_DE_DOSSIER. Vous aurez ensuite la possibilité de commencer à “surveiller” immédiatement !
Identifiants
Vous devrez générer une clé API. Allez dans la zone d’administration et générez une clé là-bas.
Sélectionnez un « Niveau d’utilisateur » de Single Userlors de la génération de la clé, pasAll Users.
Assurez-vous de cocher Global Keysinon vous recevrez des erreurs 403 interdit.
Les identifiants sont (facultativement) stockés dans ~/.discourse_theme. Les clés API sont stockées par site, et l’URL/theme_id pour chaque répertoire est également suivie. Si vous devez modifier vos paramètres, ajoutez simplement --reset à n’importe quelle commande et vous serez invité à saisir à nouveau toutes les valeurs.
Témoignages
« Cet outil est vraiment un GEM ! » @awole20
« C’est très, très bon. » @awesomerobot
« Ça marche
Et c’est assez dosh garn cool. Super ! » @angus
« OMG. C’est incroyable. » @pfaffman
Ce document est sous contrôle de version - suggérez des modifications sur github.

