Démarrez avec Theme Creator et le Theme CLI

Ce tutoriel vous explique comment utiliser la Theme CLI avec notre site Theme Creator pour développer un thème et prévisualiser vos modifications sur un site Discourse en direct.

  1. Inscrivez-vous sur Meta si ce n’est pas déjà fait.

  2. Connectez-vous à Theme Creator

  3. Installez la Theme CLI en suivant les instructions ici

  4. Créez un nouveau thème sur Theme Creator en :

    • Visitant https://discourse.theme-creator.io/my/themes
    • Cliquant sur Install, et en sélectionnant l’option “Create New”.
    • Donnant un nom unique à votre thème (vous pouvez ignorer le schéma de couleurs pour l’instant).
  5. Cliquez sur advanced, puis edit locally, et retrieve API key.

    Copiez la clé API qui est générée.

  1. Retournez à votre ligne de commande et tapez discourse_theme download example-folder, où example-folder est l’endroit où votre thème sera stocké localement. Suivez les instructions.

    • Entrez https://discourse.theme-creator.io comme URL racine de votre site Discourse.

    • Entrez votre clé API de l’étape précédente lorsqu’on vous le demande.

    • Continuez à suivre les instructions et sélectionnez le thème que vous avez créé à l’étape 4.

    • Entrez oui lorsque l’on vous demande si vous souhaitez commencer à surveiller votre thème.

  2. Maintenant, votre dossier de thème local est surveillé pour les changements, qui seront automatiquement téléchargés vers Theme Creator. Vous pouvez ouvrir un aperçu de votre thème en cliquant sur preview dans les paramètres de votre thème sur Theme Creator.

  3. Pour arrêter la surveillance des changements, appuyez sur ctrl + c dans votre fenêtre de ligne de commande. Pour recommencer à surveiller les changements, tapez discourse_theme watch example-theme.

:tada: Vous avez maintenant un répertoire de thème local que vous pouvez modifier et voir vos changements en direct !

Pour un aperçu approfondi de la structure des thèmes et de ce que vous pouvez faire, consultez notre Developing Discourse Themes & Theme Components


Ce document est contrôlé par version - suggérez des modifications sur github.

42 « J'aime »

Bonjour. J’essaie de suivre ces instructions mais je me heurte à un problème. Après avoir ajouté la clé API, je vois ceci :

/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>'

Une idée de pourquoi ? Merci d’avance.

1 « J'aime »

Salut !
Cet outil ne prend pas encore en charge Ruby 3.2 en raison de changements dans le langage. Nous avons un correctif en cours, mais Ruby 3.1.x fonctionne en attendant.

6 « J'aime »

Ah, ça explique alors.
Merci :slight_smile:

1 « J'aime »

Ceci est maintenant corrigé - discourse_theme devrait fonctionner sous Ruby 3.2.x à partir de la version gem 0.7.4 et supérieures :slight_smile:

3 « J'aime »

Wow, c’était rapide :open_mouth:
Merci. J’ai réussi à le faire fonctionner avec l’aide de mon chef de service qui a suggéré :

rbenv install 3.1.3
rbenv shell 3.1.3
gem install discourse_theme

Ce qui n’a en fait pas fonctionné avant que je ne ferme l’onglet du terminal et que je ne le rouvre.

Est-ce que discourse_theme watch ne recharge plus en direct ? Il rafraîchissait mon thème lorsque je l’enregistrais, mais maintenant je dois rafraîchir manuellement mon onglet. Rien dans la console n’indique pourquoi.

1 « J'aime »

Il y a eu un changement il y a quelque temps

Vous pourriez être intéressé par Live Reload in Production

4 « J'aime »